From 3c92272d22d8fd78a4718f044bd9919aef9b0c09 Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Sun, 12 Jul 2026 07:01:13 +0100 Subject: [PATCH] Purge deleted Epiphany route contracts --- epiphany-codex-bridge/src/lib.rs | 1 - epiphany-codex-bridge/src/protocol_edge.rs | 104 - .../src/retrieve_protocol.rs | 83 - epiphany-codex-bridge/src/view_protocol.rs | 45 - notes/epiphany-app-server-client-matrix.md | 7 +- notes/fresh-workspace-handoff.md | 9 +- notes/native-coordinator-liberation-map.md | 7 + state/ledgers.msgpack | Bin 414417 -> 414777 bytes state/map.yaml | 2 +- .../schema/json/ApplyPatchApprovalParams.json | 168 +- .../json/ApplyPatchApprovalResponse.json | 110 +- .../json/ChatgptAuthTokensRefreshParams.json | 36 +- .../ChatgptAuthTokensRefreshResponse.json | 14 +- .../schema/json/ClientNotification.json | 18 +- .../schema/json/ClientRequest.json | 7562 ++-- ...CommandExecutionRequestApprovalParams.json | 546 +- ...mmandExecutionRequestApprovalResponse.json | 106 +- .../schema/json/DynamicToolCallParams.json | 20 +- .../schema/json/DynamicToolCallResponse.json | 66 +- .../json/ExecCommandApprovalParams.json | 150 +- .../json/ExecCommandApprovalResponse.json | 110 +- .../json/FileChangeRequestApprovalParams.json | 16 +- .../FileChangeRequestApprovalResponse.json | 38 +- .../schema/json/FuzzyFileSearchParams.json | 18 +- .../schema/json/FuzzyFileSearchResponse.json | 66 +- ...ileSearchSessionCompletedNotification.json | 12 +- ...yFileSearchSessionUpdatedNotification.json | 82 +- .../schema/json/JSONRPCError.json | 72 +- .../schema/json/JSONRPCErrorError.json | 18 +- .../schema/json/JSONRPCMessage.json | 80 +- .../schema/json/JSONRPCNotification.json | 12 +- .../schema/json/JSONRPCRequest.json | 64 +- .../schema/json/JSONRPCResponse.json | 32 +- .../McpServerElicitationRequestParams.json | 410 +- .../McpServerElicitationRequestResponse.json | 30 +- .../PermissionsRequestApprovalParams.json | 606 +- .../PermissionsRequestApprovalResponse.json | 260 +- .../schema/json/RequestId.json | 8 +- .../schema/json/ServerNotification.json | 5760 +-- .../schema/json/ServerRequest.json | 1452 +- .../json/ToolRequestUserInputParams.json | 88 +- .../json/ToolRequestUserInputResponse.json | 48 +- .../codex_app_server_protocol.schemas.json | 35157 ++++++++-------- .../codex_app_server_protocol.v2.schemas.json | 32869 +++++++-------- .../schema/json/v1/InitializeParams.json | 98 +- .../schema/json/v1/InitializeResponse.json | 32 +- .../v2/AccountLoginCompletedNotification.json | 12 +- .../AccountRateLimitsUpdatedNotification.json | 88 +- .../json/v2/AccountUpdatedNotification.json | 108 +- .../v2/AgentMessageDeltaNotification.json | 18 +- .../json/v2/CancelLoginAccountParams.json | 12 +- .../json/v2/CancelLoginAccountResponse.json | 28 +- .../CommandExecOutputDeltaNotification.json | 62 +- .../schema/json/v2/CommandExecParams.json | 446 +- .../json/v2/CommandExecResizeParams.json | 64 +- .../json/v2/CommandExecResizeResponse.json | 2 +- .../schema/json/v2/CommandExecResponse.json | 20 +- .../json/v2/CommandExecTerminateParams.json | 12 +- .../json/v2/CommandExecTerminateResponse.json | 2 +- .../json/v2/CommandExecWriteParams.json | 12 +- .../json/v2/CommandExecWriteResponse.json | 2 +- ...mmandExecutionOutputDeltaNotification.json | 18 +- .../json/v2/ConfigBatchWriteParams.json | 66 +- .../schema/json/v2/ConfigReadParams.json | 6 +- .../schema/json/v2/ConfigReadResponse.json | 322 +- .../v2/ConfigRequirementsReadResponse.json | 188 +- .../json/v2/ConfigValueWriteParams.json | 32 +- .../json/v2/ConfigWarningNotification.json | 90 +- .../schema/json/v2/ConfigWriteResponse.json | 420 +- .../json/v2/ContextCompactedNotification.json | 14 +- .../v2/DeprecationNoticeNotification.json | 12 +- .../schema/json/v2/DeviceKeyCreateParams.json | 36 +- .../json/v2/DeviceKeyCreateResponse.json | 52 +- .../schema/json/v2/DeviceKeyPublicParams.json | 12 +- .../json/v2/DeviceKeyPublicResponse.json | 52 +- .../schema/json/v2/DeviceKeySignParams.json | 106 +- .../schema/json/v2/DeviceKeySignResponse.json | 32 +- .../schema/json/v2/ErrorNotification.json | 194 +- ...xperimentalFeatureEnablementSetParams.json | 22 +- ...erimentalFeatureEnablementSetResponse.json | 22 +- .../v2/ExperimentalFeatureListParams.json | 12 +- .../v2/ExperimentalFeatureListResponse.json | 82 +- .../schema/json/v2/FeedbackUploadParams.json | 30 +- .../json/v2/FeedbackUploadResponse.json | 12 +- .../v2/FileChangeOutputDeltaNotification.json | 18 +- .../FileChangePatchUpdatedNotification.json | 178 +- .../schema/json/v2/FsChangedNotification.json | 28 +- .../schema/json/v2/FsCopyParams.json | 32 +- .../schema/json/v2/FsCopyResponse.json | 2 +- .../json/v2/FsCreateDirectoryParams.json | 26 +- .../json/v2/FsCreateDirectoryResponse.json | 2 +- .../schema/json/v2/FsGetMetadataParams.json | 34 +- .../schema/json/v2/FsGetMetadataResponse.json | 28 +- .../schema/json/v2/FsReadDirectoryParams.json | 34 +- .../json/v2/FsReadDirectoryResponse.json | 46 +- .../schema/json/v2/FsReadFileParams.json | 34 +- .../schema/json/v2/FsReadFileResponse.json | 12 +- .../schema/json/v2/FsRemoveParams.json | 26 +- .../schema/json/v2/FsRemoveResponse.json | 2 +- .../schema/json/v2/FsUnwatchParams.json | 12 +- .../schema/json/v2/FsUnwatchResponse.json | 2 +- .../schema/json/v2/FsWatchParams.json | 28 +- .../schema/json/v2/FsWatchResponse.json | 34 +- .../schema/json/v2/FsWriteFileParams.json | 28 +- .../schema/json/v2/FsWriteFileResponse.json | 2 +- .../schema/json/v2/GetAccountParams.json | 8 +- .../json/v2/GetAccountRateLimitsResponse.json | 118 +- .../schema/json/v2/GetAccountResponse.json | 136 +- .../json/v2/GuardianWarningNotification.json | 14 +- .../json/v2/HookCompletedNotification.json | 132 +- .../json/v2/HookStartedNotification.json | 132 +- .../json/v2/ItemCompletedNotification.json | 834 +- ...anApprovalReviewCompletedNotification.json | 432 +- ...dianApprovalReviewStartedNotification.json | 420 +- .../json/v2/ItemStartedNotification.json | 834 +- .../json/v2/ListMcpServerStatusParams.json | 32 +- .../json/v2/ListMcpServerStatusResponse.json | 124 +- .../schema/json/v2/LoginAccountParams.json | 62 +- .../schema/json/v2/LoginAccountResponse.json | 68 +- .../schema/json/v2/McpResourceReadParams.json | 14 +- .../json/v2/McpResourceReadResponse.json | 54 +- ...ServerOauthLoginCompletedNotification.json | 14 +- .../json/v2/McpServerOauthLoginParams.json | 24 +- .../json/v2/McpServerOauthLoginResponse.json | 12 +- .../McpServerStatusUpdatedNotification.json | 34 +- .../json/v2/McpServerToolCallParams.json | 16 +- .../json/v2/McpServerToolCallResponse.json | 16 +- .../v2/McpToolCallProgressNotification.json | 18 +- .../schema/json/v2/ModelListParams.json | 12 +- .../schema/json/v2/ModelListResponse.json | 122 +- .../json/v2/ModelReroutedNotification.json | 34 +- .../schema/json/v2/PlanDeltaNotification.json | 18 +- .../RawResponseItemCompletedNotification.json | 548 +- ...ReasoningSummaryPartAddedNotification.json | 22 +- ...ReasoningSummaryTextDeltaNotification.json | 24 +- .../v2/ReasoningTextDeltaNotification.json | 24 +- .../schema/json/v2/ReviewStartParams.json | 120 +- .../schema/json/v2/ReviewStartResponse.json | 1014 +- .../v2/SendAddCreditsNudgeEmailParams.json | 28 +- .../v2/SendAddCreditsNudgeEmailResponse.json | 28 +- .../v2/ServerRequestResolvedNotification.json | 38 +- .../v2/TerminalInteractionNotification.json | 20 +- ...readApproveGuardianDeniedActionParams.json | 14 +- .../schema/json/v2/ThreadArchiveParams.json | 12 +- .../json/v2/ThreadArchivedNotification.json | 12 +- .../json/v2/ThreadClosedNotification.json | 12 +- .../json/v2/ThreadCompactStartParams.json | 12 +- ...ThreadEpiphanyJobsUpdatedNotification.json | 116 +- ...hreadEpiphanyStateUpdatedNotification.json | 778 +- .../schema/json/v2/ThreadForkParams.json | 750 +- .../schema/json/v2/ThreadForkResponse.json | 2414 +- .../json/v2/ThreadInjectItemsParams.json | 18 +- .../schema/json/v2/ThreadListParams.json | 126 +- .../schema/json/v2/ThreadListResponse.json | 1962 +- .../json/v2/ThreadLoadedListParams.json | 12 +- .../json/v2/ThreadLoadedListResponse.json | 16 +- .../json/v2/ThreadMetadataUpdateParams.json | 48 +- .../json/v2/ThreadMetadataUpdateResponse.json | 1928 +- .../v2/ThreadNameUpdatedNotification.json | 12 +- .../schema/json/v2/ThreadReadParams.json | 14 +- .../schema/json/v2/ThreadReadResponse.json | 1928 +- .../v2/ThreadRealtimeClosedNotification.json | 12 +- .../v2/ThreadRealtimeErrorNotification.json | 14 +- .../ThreadRealtimeItemAddedNotification.json | 14 +- ...dRealtimeOutputAudioDeltaNotification.json | 60 +- .../v2/ThreadRealtimeSdpNotification.json | 14 +- .../v2/ThreadRealtimeStartedNotification.json | 30 +- ...adRealtimeTranscriptDeltaNotification.json | 16 +- ...eadRealtimeTranscriptDoneNotification.json | 16 +- .../schema/json/v2/ThreadResumeParams.json | 2574 +- .../schema/json/v2/ThreadResumeResponse.json | 2414 +- .../schema/json/v2/ThreadRollbackParams.json | 18 +- .../json/v2/ThreadRollbackResponse.json | 1938 +- .../schema/json/v2/ThreadSetNameParams.json | 14 +- .../json/v2/ThreadShellCommandParams.json | 14 +- .../schema/json/v2/ThreadStartParams.json | 894 +- .../schema/json/v2/ThreadStartResponse.json | 2414 +- .../json/v2/ThreadStartedNotification.json | 1928 +- .../v2/ThreadStatusChangedNotification.json | 180 +- .../ThreadTokenUsageUpdatedNotification.json | 140 +- .../schema/json/v2/ThreadTurnsListParams.json | 38 +- .../json/v2/ThreadTurnsListResponse.json | 1038 +- .../schema/json/v2/ThreadUnarchiveParams.json | 12 +- .../json/v2/ThreadUnarchiveResponse.json | 1928 +- .../json/v2/ThreadUnarchivedNotification.json | 12 +- .../json/v2/ThreadUnsubscribeParams.json | 12 +- .../json/v2/ThreadUnsubscribeResponse.json | 30 +- .../json/v2/TurnCompletedNotification.json | 1012 +- .../json/v2/TurnDiffUpdatedNotification.json | 16 +- .../schema/json/v2/TurnInterruptParams.json | 14 +- .../json/v2/TurnPlanUpdatedNotification.json | 68 +- .../schema/json/v2/TurnStartParams.json | 760 +- .../schema/json/v2/TurnStartResponse.json | 1004 +- .../json/v2/TurnStartedNotification.json | 1012 +- .../schema/json/v2/TurnSteerParams.json | 154 +- .../schema/json/v2/TurnSteerResponse.json | 12 +- .../schema/json/v2/WarningNotification.json | 12 +- ...dowsSandboxSetupCompletedNotification.json | 30 +- .../v2/WindowsSandboxSetupStartParams.json | 36 +- .../v2/WindowsSandboxSetupStartResponse.json | 12 +- ...ndowsWorldWritableWarningNotification.json | 24 +- ...eadEpiphanyReorientWorkerLaunchDocument.ts | 10 - .../v2/ThreadEpiphanyRetrieveIndexSummary.ts | 8 - .../v2/ThreadEpiphanyRetrieveResult.ts | 6 - .../v2/ThreadEpiphanyRetrieveResultKind.ts | 5 - .../v2/ThreadEpiphanyRetrieveShardSummary.ts | 6 - .../ThreadEpiphanyRoleWorkerLaunchDocument.ts | 16 - .../v2/ThreadEpiphanyWorkerLaunchDocument.ts | 7 - .../schema/typescript/v2/index.ts | 7 - .../app-server-protocol/src/protocol/v2.rs | 421 - 210 files changed, 62057 insertions(+), 63973 deletions(-) delete mode 100644 epiphany-codex-bridge/src/retrieve_protocol.rs delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyReorientWorkerLaunchDocument.ts delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveIndexSummary.ts delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveResult.ts delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveResultKind.ts delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveShardSummary.ts delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRoleWorkerLaunchDocument.ts delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyWorkerLaunchDocument.ts diff --git a/epiphany-codex-bridge/src/lib.rs b/epiphany-codex-bridge/src/lib.rs index 05717d56..ca1057a5 100644 --- a/epiphany-codex-bridge/src/lib.rs +++ b/epiphany-codex-bridge/src/lib.rs @@ -33,7 +33,6 @@ pub mod protocol_edge; pub mod reorient; pub mod results; pub mod retrieve; -pub mod retrieve_protocol; pub mod runtime_results; pub mod scene; pub mod scene_protocol; diff --git a/epiphany-codex-bridge/src/protocol_edge.rs b/epiphany-codex-bridge/src/protocol_edge.rs index f5f556a9..90fa6fc2 100644 --- a/epiphany-codex-bridge/src/protocol_edge.rs +++ b/epiphany-codex-bridge/src/protocol_edge.rs @@ -14,7 +14,6 @@ use crate::cultnet::EpiphanyReorientStateStatus; use crate::cultnet::EpiphanyRetrievalFreshnessStatus; use crate::cultnet::EpiphanySurfaceSource; use codex_app_server_protocol::ThreadEpiphanyContextParams; -use codex_app_server_protocol::ThreadEpiphanyDistillParams; use codex_app_server_protocol::ThreadEpiphanyFreshnessResponse; use codex_app_server_protocol::ThreadEpiphanyFreshnessSource; use codex_app_server_protocol::ThreadEpiphanyGraphFreshness; @@ -39,7 +38,6 @@ use codex_app_server_protocol::ThreadEpiphanyReorientReason; use codex_app_server_protocol::ThreadEpiphanyReorientResultStatus; use codex_app_server_protocol::ThreadEpiphanyReorientSource; use codex_app_server_protocol::ThreadEpiphanyReorientStateStatus; -use codex_app_server_protocol::ThreadEpiphanyReorientWorkerLaunchDocument; use codex_app_server_protocol::ThreadEpiphanyRetrievalFreshness; use codex_app_server_protocol::ThreadEpiphanyRetrievalFreshnessStatus; use codex_app_server_protocol::ThreadEpiphanyRoleFinding; @@ -47,18 +45,15 @@ use codex_app_server_protocol::ThreadEpiphanyRoleId; use codex_app_server_protocol::ThreadEpiphanyRoleResultStatus; use codex_app_server_protocol::ThreadEpiphanyRoleSelfPersistenceReview; use codex_app_server_protocol::ThreadEpiphanyRoleSelfPersistenceStatus; -use codex_app_server_protocol::ThreadEpiphanyRoleWorkerLaunchDocument; use codex_app_server_protocol::ThreadEpiphanyRolesSource; use codex_app_server_protocol::ThreadEpiphanyStateUpdatedField; use codex_app_server_protocol::ThreadEpiphanyStateUpdatedNotification; use codex_app_server_protocol::ThreadEpiphanyStateUpdatedSource; use codex_app_server_protocol::ThreadEpiphanyUpdatePatch; use codex_app_server_protocol::ThreadEpiphanyViewLens; -use codex_app_server_protocol::ThreadEpiphanyWorkerLaunchDocument; use epiphany_core::EpiphanyContextParams; use epiphany_core::EpiphanyCoordinatorRoleResultStatus; use epiphany_core::EpiphanyCrrcResultStatus; -use epiphany_core::EpiphanyDistillInput; use epiphany_core::EpiphanyGraphQuery; use epiphany_core::EpiphanyGraphQueryDirection; use epiphany_core::EpiphanyGraphQueryKind; @@ -67,16 +62,13 @@ use epiphany_core::EpiphanyPressureBasis; use epiphany_core::EpiphanyPressureLevel; use epiphany_core::EpiphanyPressureStatus; use epiphany_core::EpiphanyReorientFindingInterpretation; -use epiphany_core::EpiphanyReorientWorkerLaunchDocument; use epiphany_core::EpiphanyRoleFindingInterpretation; use epiphany_core::EpiphanyRoleResultRoleId; use epiphany_core::EpiphanyRoleSelfPersistenceReview; use epiphany_core::EpiphanyRoleSelfPersistenceStatus; use epiphany_core::EpiphanyRoleStatePatchDocument; -use epiphany_core::EpiphanyRoleWorkerLaunchDocument; use epiphany_core::EpiphanyStateUpdatedField; use epiphany_core::EpiphanyViewLens; -use epiphany_core::EpiphanyWorkerLaunchDocument; use epiphany_core::default_epiphany_view_lenses; use epiphany_core::epiphany_view_needs_jobs; use epiphany_core::epiphany_view_needs_pressure; @@ -134,28 +126,6 @@ pub fn protocol_context_params_to_core( } } -pub fn protocol_distill_params_to_core( - params: ThreadEpiphanyDistillParams, -) -> EpiphanyDistillInput { - let ThreadEpiphanyDistillParams { - source_kind, - status, - text, - subject, - evidence_kind, - code_refs, - .. - } = params; - EpiphanyDistillInput { - source_kind, - status, - text, - subject, - evidence_kind, - code_refs, - } -} - pub fn protocol_graph_query_to_core(query: &ThreadEpiphanyGraphQuery) -> EpiphanyGraphQuery { EpiphanyGraphQuery { kind: protocol_graph_query_kind_to_core(query.kind), @@ -170,21 +140,6 @@ pub fn protocol_graph_query_to_core(query: &ThreadEpiphanyGraphQuery) -> Epiphan } } -pub fn protocol_worker_launch_document_to_core( - document: ThreadEpiphanyWorkerLaunchDocument, -) -> EpiphanyWorkerLaunchDocument { - match document { - ThreadEpiphanyWorkerLaunchDocument::Role(document) => EpiphanyWorkerLaunchDocument::Role( - protocol_role_worker_launch_document_to_core(document), - ), - ThreadEpiphanyWorkerLaunchDocument::Reorient(document) => { - EpiphanyWorkerLaunchDocument::Reorient( - protocol_reorient_worker_launch_document_to_core(document), - ) - } - } -} - pub fn protocol_update_patch_to_core( patch: &ThreadEpiphanyUpdatePatch, ) -> EpiphanyRoleStatePatchDocument { @@ -657,65 +612,6 @@ fn protocol_graph_query_direction_to_core( } } -fn protocol_role_worker_launch_document_to_core( - document: ThreadEpiphanyRoleWorkerLaunchDocument, -) -> EpiphanyRoleWorkerLaunchDocument { - EpiphanyRoleWorkerLaunchDocument { - thread_id: document.thread_id, - role_id: document.role_id, - state_revision: document.state_revision, - objective: document.objective, - dynamic_prompt_context: None, - active_subgoal_id: document.active_subgoal_id, - active_subgoals: document.active_subgoals, - active_graph_node_ids: document.active_graph_node_ids, - investigation_checkpoint: document.investigation_checkpoint, - scratch: document.scratch, - invariants: document.invariants, - graphs: document.graphs, - recent_evidence: document.recent_evidence, - recent_observations: document.recent_observations, - graph_frontier: document.graph_frontier, - graph_checkpoint: document.graph_checkpoint, - planning: document.planning, - churn: document.churn, - } -} - -fn protocol_reorient_worker_launch_document_to_core( - document: ThreadEpiphanyReorientWorkerLaunchDocument, -) -> EpiphanyReorientWorkerLaunchDocument { - EpiphanyReorientWorkerLaunchDocument { - thread_id: document.thread_id, - mode: document.mode, - checkpoint_id: document.checkpoint_id, - checkpoint_kind: document.checkpoint_kind, - checkpoint_disposition: document.checkpoint_disposition, - dynamic_prompt_context: None, - checkpoint_focus: document.checkpoint_focus, - checkpoint_summary: document.checkpoint_summary, - checkpoint_next_action: document.checkpoint_next_action, - checkpoint_open_questions: document.checkpoint_open_questions, - checkpoint_evidence_ids: document.checkpoint_evidence_ids, - checkpoint_code_refs: document.checkpoint_code_refs, - decision_reasons: document.decision_reasons, - decision_note: document.decision_note, - pressure_level: document.pressure_level, - retrieval_status: document.retrieval_status, - graph_status: document.graph_status, - watcher_status: document.watcher_status, - checkpoint_dirty_paths: document.checkpoint_dirty_paths, - checkpoint_changed_paths: document.checkpoint_changed_paths, - scratch: document.scratch, - graphs: document.graphs, - recent_evidence: document.recent_evidence, - recent_observations: document.recent_observations, - active_frontier_node_ids: document.active_frontier_node_ids, - linked_subgoal_ids: document.linked_subgoal_ids, - linked_graph_node_ids: document.linked_graph_node_ids, - } -} - fn protocol_reorient_retrieval_status( status: EpiphanyReorientFreshnessStatus, ) -> ThreadEpiphanyRetrievalFreshnessStatus { diff --git a/epiphany-codex-bridge/src/retrieve_protocol.rs b/epiphany-codex-bridge/src/retrieve_protocol.rs deleted file mode 100644 index a23ca566..00000000 --- a/epiphany-codex-bridge/src/retrieve_protocol.rs +++ /dev/null @@ -1,83 +0,0 @@ -use codex_app_server_protocol::ThreadEpiphanyIndexResponse; -use codex_app_server_protocol::ThreadEpiphanyRetrieveIndexSummary; -use codex_app_server_protocol::ThreadEpiphanyRetrieveResponse; -use codex_app_server_protocol::ThreadEpiphanyRetrieveResult; -use codex_app_server_protocol::ThreadEpiphanyRetrieveResultKind; -use codex_app_server_protocol::ThreadEpiphanyRetrieveShardSummary; -use codex_utils_absolute_path::AbsolutePathBuf; -use epiphany_core::EpiphanyRetrieveResponse as CoreEpiphanyRetrieveResponse; -use epiphany_core::EpiphanyRetrieveResult as CoreEpiphanyRetrieveResult; -use epiphany_core::EpiphanyRetrieveResultKind as CoreEpiphanyRetrieveResultKind; -use epiphany_state_model::EpiphanyRetrievalState; - -pub fn protocol_retrieve_response( - response: CoreEpiphanyRetrieveResponse, -) -> anyhow::Result { - Ok(ThreadEpiphanyRetrieveResponse { - query: response.query, - index_summary: protocol_retrieve_index_summary(response.index_summary)?, - results: response - .results - .into_iter() - .map(protocol_retrieve_result) - .collect(), - }) -} - -pub fn protocol_index_response( - index_summary: EpiphanyRetrievalState, -) -> anyhow::Result { - Ok(ThreadEpiphanyIndexResponse { - index_summary: protocol_retrieve_index_summary(index_summary)?, - }) -} - -pub fn protocol_retrieve_index_summary( - summary: EpiphanyRetrievalState, -) -> anyhow::Result { - Ok(ThreadEpiphanyRetrieveIndexSummary { - workspace_root: AbsolutePathBuf::from_absolute_path(summary.workspace_root) - .map_err(anyhow::Error::from)?, - index_revision: summary.index_revision, - status: summary.status, - semantic_available: summary.semantic_available, - last_indexed_at_unix_seconds: summary.last_indexed_at_unix_seconds, - indexed_file_count: summary.indexed_file_count, - indexed_chunk_count: summary.indexed_chunk_count, - shards: summary - .shards - .into_iter() - .map(|shard| ThreadEpiphanyRetrieveShardSummary { - shard_id: shard.shard_id, - path_prefix: shard.path_prefix, - indexed_file_count: shard.indexed_file_count, - indexed_chunk_count: shard.indexed_chunk_count, - status: shard.status, - exact_available: shard.exact_available, - semantic_available: shard.semantic_available, - }) - .collect(), - dirty_paths: summary.dirty_paths, - }) -} - -fn protocol_retrieve_result(result: CoreEpiphanyRetrieveResult) -> ThreadEpiphanyRetrieveResult { - ThreadEpiphanyRetrieveResult { - kind: match result.kind { - CoreEpiphanyRetrieveResultKind::ExactFile => { - ThreadEpiphanyRetrieveResultKind::ExactFile - } - CoreEpiphanyRetrieveResultKind::ExactDirectory => { - ThreadEpiphanyRetrieveResultKind::ExactDirectory - } - CoreEpiphanyRetrieveResultKind::SemanticChunk => { - ThreadEpiphanyRetrieveResultKind::SemanticChunk - } - }, - path: result.path, - score: result.score, - line_start: result.line_start, - line_end: result.line_end, - excerpt: result.excerpt, - } -} diff --git a/epiphany-codex-bridge/src/view_protocol.rs b/epiphany-codex-bridge/src/view_protocol.rs index 343ddf60..6956795a 100644 --- a/epiphany-codex-bridge/src/view_protocol.rs +++ b/epiphany-codex-bridge/src/view_protocol.rs @@ -3,19 +3,15 @@ use std::path::Path; use codex_app_server_protocol::*; use epiphany_core::EPIPHANY_REORIENT_LAUNCH_BINDING_ID; use epiphany_core::EpiphanyContextParams; -use epiphany_core::EpiphanyDistillInput; use epiphany_core::EpiphanyGraphQuery; -use epiphany_core::EpiphanyMapProposalInput; use epiphany_core::EpiphanyRoleResultRoleId; use epiphany_core::EpiphanySceneInput; use epiphany_core::EpiphanyTokenUsageSnapshot; use epiphany_core::EpiphanyViewLens; use epiphany_core::derive_scene; -use epiphany_core::distill_observation; use epiphany_core::epiphany_view_needs_jobs; use epiphany_core::epiphany_view_needs_pressure; use epiphany_core::epiphany_view_needs_reorientation_inputs; -use epiphany_core::propose_map_update; use epiphany_core::reorient_finding_already_accepted; use epiphany_state_model::EpiphanyRetrievalState; use epiphany_state_model::EpiphanyThreadState; @@ -65,7 +61,6 @@ pub struct EpiphanyFreshnessResponseInput<'a> { pub retrieval_override: Option<&'a EpiphanyRetrievalState>, pub watcher_snapshot: Option>, } - pub fn derive_epiphany_freshness_surface( input: EpiphanyFreshnessResponseInput<'_>, ) -> EpiphanyFreshnessSurface { @@ -553,43 +548,3 @@ pub async fn map_epiphany_reorient_result_response( note: result.note, } } - -pub fn map_epiphany_distill_response( - expected_revision: u64, - input: EpiphanyDistillInput, -) -> std::result::Result { - let proposal = distill_observation(input).map_err(|err| err.to_string())?; - - Ok(ThreadEpiphanyDistillResponse { - expected_revision, - patch: ThreadEpiphanyUpdatePatch { - observations: vec![proposal.observation], - evidence: vec![proposal.evidence], - ..Default::default() - }, - }) -} - -pub fn map_epiphany_propose_response( - state: EpiphanyThreadState, - observation_ids: Vec, -) -> std::result::Result { - let expected_revision = state.revision; - let proposal = propose_map_update(EpiphanyMapProposalInput { - state, - observation_ids, - }) - .map_err(|err| err.to_string())?; - - Ok(ThreadEpiphanyProposeResponse { - expected_revision, - patch: ThreadEpiphanyUpdatePatch { - observations: vec![proposal.observation], - evidence: vec![proposal.evidence], - graphs: Some(proposal.graphs), - graph_frontier: Some(proposal.graph_frontier), - churn: Some(proposal.churn), - ..Default::default() - }, - }) -} diff --git a/notes/epiphany-app-server-client-matrix.md b/notes/epiphany-app-server-client-matrix.md index 7e7b0a3c..4d525b49 100644 --- a/notes/epiphany-app-server-client-matrix.md +++ b/notes/epiphany-app-server-client-matrix.md @@ -37,9 +37,10 @@ clients. | `jobLaunch` | no executable caller | request surface deleted | | `retrieve` | no executable caller | request surface deleted | -Protocol DTOs may remain temporarily only when retained response projections or -bridge conversion tests still compile against them. A DTO is not authority and -must not keep an unconsumed request method registered. +The deleted methods' protocol DTOs, duplicate worker-launch document hierarchy, +retrieve projection module, bridge conversions, and generated schema exports +are gone. A DTO is not authority and does not survive merely because codegen can +describe it. ## Evidence rule diff --git a/notes/fresh-workspace-handoff.md b/notes/fresh-workspace-handoff.md index 97b7f62e..c93bbddc 100644 --- a/notes/fresh-workspace-handoff.md +++ b/notes/fresh-workspace-handoff.md @@ -1956,8 +1956,13 @@ Those ten request registrations, dispatch arms, handlers, protocol tests, and README claims are now deleted. A source guard fixes registration to the eight named-client routes and explicitly rejects the removed names. Protocol compile, app-server compile, and four compatibility-architecture tests pass. Next audit -zero-caller protocol DTOs and bridge conversion helpers left by this cut, then -migrate or retire the phase-6 smoke and `epiphany-mvp-status --codex` clients. +The zero-caller DTO audit is complete too: deleted-method params/responses, +generic job-launch worker-document DTOs, retrieval DTOs, bridge distill/propose/ +job-document conversions, and `retrieve_protocol.rs` are gone. Generated JSON +and TypeScript fixtures were regenerated; their two fixture-equivalence tests, +protocol/bridge compilation, and full app-server compilation pass. Next map the +real invariant behind each phase-6 smoke and `epiphany-mvp-status --codex`, then +migrate or retire those clients rather than preserving JSON-RPC for its own tests. ## Immediate Re-entry Instruction diff --git a/notes/native-coordinator-liberation-map.md b/notes/native-coordinator-liberation-map.md index d7bd11f4..d065f72b 100644 --- a/notes/native-coordinator-liberation-map.md +++ b/notes/native-coordinator-liberation-map.md @@ -384,3 +384,10 @@ claims, and serialization tests do not count as clients. Those ten request registrations, dispatch arms, handlers, tests, and README claims are deleted. The registration guard now fixes the compatibility surface at the eight named client routes and rejects restoration of the unconsumed methods. + +The orphan audit then removed the deleted methods' request/response DTOs from +app-server protocol, including the duplicate generic job-launch worker document +hierarchy and retrieval result/index projection shapes. Bridge-only distill, +propose, job-document, index, and retrieve conversions plus the entire +`retrieve_protocol` module are deleted. Regenerated JSON/TypeScript fixtures +contain none of those types; their in-memory fixture comparison passes. diff --git a/state/ledgers.msgpack b/state/ledgers.msgpack index cec94a953b50c8ab1b2c10225f18c0aaad2e7744..815b34a18ee0c8b6d0474c4eadd86f6df0d1a9bc 100644 GIT binary patch delta 392 zcmYk1u}%U(5QaU}Ym6-kg=7+2ju17*fTh+FrLtRg$Ge5SnPqnmBMpUxPe6DA6H5~d z;|ti^`WC){3s_kEnJMP~=lj2&8y_!?*Lt#l+U<0@$0xU+Tj@>x?J$`n$@k-;_Oz%a zQLDKfwG*}bzNn?={pCS3-Aj)Ko#>5j+q5@$I%+PTr@iWH_mG{D~xE`2ywGgB9Ml Fe*u!li$MSY delta 59 zcmdnFLh|BL$qizRyrxzr237`!QO6kA0@rO;W-Mf6yxBaJseLLFBM^gVW*}w(V%F_b Inb>Rs06#1eGXMYp diff --git a/state/map.yaml b/state/map.yaml index 969f8647..b1b29be4 100644 --- a/state/map.yaml +++ b/state/map.yaml @@ -659,4 +659,4 @@ current_status: - Service lifecycle receipt history is now event-only: `load_epiphany_cultmesh_daemon_service_lifecycle_receipts` filters out the `epiphany-local/daemon-service-lifecycle-receipt/latest` mirror, while `load_latest_epiphany_cultmesh_daemon_service_lifecycle_receipt` remains the latest-state reader. Focused unit test `service_lifecycle_receipt_history_excludes_latest_mirror` proves two per-receipt writes return exactly two history records and latest points at the second. Fresh smoke `verse-query-lifecycle-history-filter-smoke` and live overview/triage `local-20260618-145632-497-efac6f0d` / `local-20260618-145632-321-867947af` prove compact swarm sights still expose service lifecycle attention plus the present elevated runbook artifact without daemon pokes or service mutation. Do not use a broad unscoped cargo test filter for this check on Windows; it fans out across bin harnesses and hit a broken pipe during this pass. - `epiphany-verse-query seed-compact` is the compact seed receipt for wrappers and read-only rites. The older `seed` command still prints the full local Verse context for explicit debugging, but compact wrapper modes now avoid full `seed`/final `query` readback after the combined overview proof exposed Windows debug stack overflow from full-context serialization pressure. last_completed_repo_swarm_cut: Huginn live-fire has crossed the first real repo Body from Persona pressure to branch-local Hands commit and Soul/Mind closure, and now has repeatable closure and redacted-public-proof mouths. On `E:\Projects\Huginn` branch `epiphany/huginn/first-awakening`, `tools/epiphany_local_run.ps1 -Mode repo-persona-intake` accepted item `huginn-inspection-readback-livefire`, Weksa/Persona intake remained sealed, and `epiphany-work derive-plan` lowered it to model-authored safe family `repo.status_section` for `README.md` only. `tools/epiphany_local_run.ps1 -Mode repo-swarm-run` advanced four bounded pulses: run-from-plan, adopt-from-plan, execute-from-plan, and close-from-execute. Huginn commit `e9b07c38fceabbdc89ea35c2156326c80c0393a2` updated only `README.md`; closure receipt `.epiphany\work\work-close-huginn-inspection-readback-livefire.json` records status `closed`, Soul verdict `passed`, Mind state commit `repo-work-close-huginn-inspection-readback-livefire-mind-commit`, safe family `repo.status_section`, path scope `README.md`, Bifrost publication gate, and `privateStateExposed=false`. Verification also ran Huginn's TypeScript compiler through concrete Node path: `C:\Program Files\nodejs\node.exe E:\Projects\Huginn\node_modules\typescript\bin\tsc -p tsconfig.json` passed. Native verifier `epiphany-repo-livefire-closure-smoke --workspace E:\Projects\Huginn --item huginn-inspection-readback-livefire --expected-path README.md --expected-family repo.status_section --expected-gate awaiting-publication --expected-blocker bifrost-publication-missing` checks closure receipt, Mind map entry, overview gate/blocker, authority seals, and `git show` changed paths, returning `status=ok`, `soulVerdict=passed`, `publicationGate=Bifrost`, and `privateStateExposed=false`. Wrapper `tools/epiphany_local_run.ps1 -Mode repo-livefire-closure -Workspace E:\Projects\Huginn -RepoWorkItem huginn-inspection-readback-livefire -SkipBuild` exposes the same read-only proof through the local operator mouth; artifact `local-20260621-190156-803-2f85ba15` printed commit, path, gate, blocker, Soul verdict, Mind commit receipt, and `privateStateExposed=False` without push, merge, publication, or target mutation. New wrapper `tools/epiphany_local_run.ps1 -Mode repo-work-public-proof -Workspace E:\Projects\Huginn -RepoWorkItem huginn-inspection-readback-livefire -SkipBuild` exports the redacted proof bundle and repo-local Verse index without publishing; artifact `local-20260621-190645-345-4555b1dc` wrote `.epiphany\public\proof-bundles\repo-work-public-proof-huginn-inspection-readback-livefire.json`, proof id `repo-work-public-proof-huginn-inspection-readback-livefire`, SHA-256 `857545b199f3e37eb06c2e757e5cfc201958e46667bb1f8403fd333a22620f63`, nine artifact rows, zero publication rows, and `privateStateExposed=False`. Gjallar readback `local-20260621-190701-140-b9519ec6` sees the `REPO-WORK-PUBLIC-PROOF` row and action row from Huginn's repo-local Verse with the same SHA-256 while Bifrost publication remains missing. Launcher compact modes are now named compact operator-context modes instead of read-only modes, and `bifrost-public-proof` summaries print item, target public Verse, room, proof SHA-256, review receipts, and credit receipts so publication receipts are auditable without claiming upstream sync. - next_action: Audit protocol DTOs and bridge conversion helpers left behind by the ten deleted app-server request methods; delete zero-caller shapes without disturbing the eight guarded compatibility routes. Then migrate or retire the phase-6 smoke and `epiphany-mvp-status --codex` consumers so the remaining compatibility surface can contract again. + next_action: Migrate or retire the phase-6 smoke binaries and `epiphany-mvp-status --codex` fallback that are the only clients of the eight remaining Epiphany app-server methods. Map each smoke's real invariant to an existing native core/bridge test or native executable proof before deletion; do not preserve JSON-RPC merely to keep compatibility tests alive. diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalParams.json index 1be3fa06..d1174a05 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalParams.json @@ -1,12 +1,80 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ApplyPatchApprovalParams", - "type": "object", - "required": [ - "callId", - "conversationId", - "fileChanges" - ], + "definitions": { + "FileChange": { + "oneOf": [ + { + "properties": { + "content": { + "type": "string" + }, + "type": { + "enum": [ + "add" + ], + "title": "AddFileChangeType", + "type": "string" + } + }, + "required": [ + "content", + "type" + ], + "title": "AddFileChange", + "type": "object" + }, + { + "properties": { + "content": { + "type": "string" + }, + "type": { + "enum": [ + "delete" + ], + "title": "DeleteFileChangeType", + "type": "string" + } + }, + "required": [ + "content", + "type" + ], + "title": "DeleteFileChange", + "type": "object" + }, + { + "properties": { + "move_path": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "update" + ], + "title": "UpdateFileChangeType", + "type": "string" + }, + "unified_diff": { + "type": "string" + } + }, + "required": [ + "type", + "unified_diff" + ], + "title": "UpdateFileChange", + "type": "object" + } + ] + }, + "ThreadId": { + "type": "string" + } + }, "properties": { "callId": { "description": "Use to correlate this with [codex_protocol::protocol::PatchApplyBeginEvent] and [codex_protocol::protocol::PatchApplyEndEvent].", @@ -16,10 +84,10 @@ "$ref": "#/definitions/ThreadId" }, "fileChanges": { - "type": "object", "additionalProperties": { "$ref": "#/definitions/FileChange" - } + }, + "type": "object" }, "grantRoot": { "description": "When set, the agent is asking the user to allow writes under this root for the remainder of the session (unclear if this is honored today).", @@ -36,79 +104,11 @@ ] } }, - "definitions": { - "FileChange": { - "oneOf": [ - { - "type": "object", - "required": [ - "content", - "type" - ], - "properties": { - "content": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "add" - ], - "title": "AddFileChangeType" - } - }, - "title": "AddFileChange" - }, - { - "type": "object", - "required": [ - "content", - "type" - ], - "properties": { - "content": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "delete" - ], - "title": "DeleteFileChangeType" - } - }, - "title": "DeleteFileChange" - }, - { - "type": "object", - "required": [ - "type", - "unified_diff" - ], - "properties": { - "move_path": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "update" - ], - "title": "UpdateFileChangeType" - }, - "unified_diff": { - "type": "string" - } - }, - "title": "UpdateFileChange" - } - ] - }, - "ThreadId": { - "type": "string" - } - } + "required": [ + "callId", + "conversationId", + "fileChanges" + ], + "title": "ApplyPatchApprovalParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalResponse.json index d672a062..84c36edf 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalResponse.json @@ -1,22 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ApplyPatchApprovalResponse", - "type": "object", - "required": [ - "decision" - ], - "properties": { - "decision": { - "$ref": "#/definitions/ReviewDecision" - } - }, "definitions": { "NetworkPolicyAmendment": { - "type": "object", - "required": [ - "action", - "host" - ], "properties": { "action": { "$ref": "#/definitions/NetworkPolicyRuleAction" @@ -24,101 +9,116 @@ "host": { "type": "string" } - } + }, + "required": [ + "action", + "host" + ], + "type": "object" }, "NetworkPolicyRuleAction": { - "type": "string", "enum": [ "allow", "deny" - ] + ], + "type": "string" }, "ReviewDecision": { "description": "User's decision in response to an ExecApprovalRequest.", "oneOf": [ { "description": "User has approved this command and the agent should execute it.", - "type": "string", "enum": [ "approved" - ] + ], + "type": "string" }, { + "additionalProperties": false, "description": "User has approved this command and wants to apply the proposed execpolicy amendment so future matching commands are permitted.", - "type": "object", - "required": [ - "approved_execpolicy_amendment" - ], "properties": { "approved_execpolicy_amendment": { - "type": "object", + "properties": { + "proposed_execpolicy_amendment": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "proposed_execpolicy_amendment" ], - "properties": { - "proposed_execpolicy_amendment": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" } }, - "additionalProperties": false, - "title": "ApprovedExecpolicyAmendmentReviewDecision" + "required": [ + "approved_execpolicy_amendment" + ], + "title": "ApprovedExecpolicyAmendmentReviewDecision", + "type": "object" }, { "description": "User has approved this request and wants future prompts in the same session-scoped approval cache to be automatically approved for the remainder of the session.", - "type": "string", "enum": [ "approved_for_session" - ] + ], + "type": "string" }, { + "additionalProperties": false, "description": "User chose to persist a network policy rule (allow/deny) for future requests to the same host.", - "type": "object", - "required": [ - "network_policy_amendment" - ], "properties": { "network_policy_amendment": { - "type": "object", - "required": [ - "network_policy_amendment" - ], "properties": { "network_policy_amendment": { "$ref": "#/definitions/NetworkPolicyAmendment" } - } + }, + "required": [ + "network_policy_amendment" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "NetworkPolicyAmendmentReviewDecision" + "required": [ + "network_policy_amendment" + ], + "title": "NetworkPolicyAmendmentReviewDecision", + "type": "object" }, { "description": "User has denied this command and the agent should not execute it, but it should continue the session and try something else.", - "type": "string", "enum": [ "denied" - ] + ], + "type": "string" }, { "description": "Automatic approval review timed out before reaching a decision.", - "type": "string", "enum": [ "timed_out" - ] + ], + "type": "string" }, { "description": "User has denied this command and the agent should not do anything until the user's next command.", - "type": "string", "enum": [ "abort" - ] + ], + "type": "string" } ] } - } + }, + "properties": { + "decision": { + "$ref": "#/definitions/ReviewDecision" + } + }, + "required": [ + "decision" + ], + "title": "ApplyPatchApprovalResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshParams.json index 81616f49..8b320fd6 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshParams.json @@ -1,10 +1,18 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ChatgptAuthTokensRefreshParams", - "type": "object", - "required": [ - "reason" - ], + "definitions": { + "ChatgptAuthTokensRefreshReason": { + "oneOf": [ + { + "description": "Codex attempted a backend request and received `401 Unauthorized`.", + "enum": [ + "unauthorized" + ], + "type": "string" + } + ] + } + }, "properties": { "previousAccountId": { "description": "Workspace/account identifier that Codex was previously using.\n\nClients that manage multiple accounts/workspaces can use this as a hint to refresh the token for the correct workspace.\n\nThis may be `null` when the prior auth state did not include a workspace identifier (`chatgpt_account_id`).", @@ -17,17 +25,9 @@ "$ref": "#/definitions/ChatgptAuthTokensRefreshReason" } }, - "definitions": { - "ChatgptAuthTokensRefreshReason": { - "oneOf": [ - { - "description": "Codex attempted a backend request and received `401 Unauthorized`.", - "type": "string", - "enum": [ - "unauthorized" - ] - } - ] - } - } + "required": [ + "reason" + ], + "title": "ChatgptAuthTokensRefreshParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshResponse.json index 30956ff5..6d88e784 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshResponse.json @@ -1,11 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ChatgptAuthTokensRefreshResponse", - "type": "object", - "required": [ - "accessToken", - "chatgptAccountId" - ], "properties": { "accessToken": { "type": "string" @@ -19,5 +13,11 @@ "null" ] } - } + }, + "required": [ + "accessToken", + "chatgptAccountId" + ], + "title": "ChatgptAuthTokensRefreshResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/ClientNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/ClientNotification.json index a9be2746..dde0b31f 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/ClientNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/ClientNotification.json @@ -1,22 +1,22 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ClientNotification", "oneOf": [ { - "type": "object", - "required": [ - "method" - ], "properties": { "method": { - "type": "string", "enum": [ "initialized" ], - "title": "InitializedNotificationMethod" + "title": "InitializedNotificationMethod", + "type": "string" } }, - "title": "InitializedNotification" + "required": [ + "method" + ], + "title": "InitializedNotification", + "type": "object" } - ] + ], + "title": "ClientNotification" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/ClientRequest.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/ClientRequest.json index b4072e3a..61cda926 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/ClientRequest.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/ClientRequest.json @@ -1,1472 +1,41 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ClientRequest", - "description": "Request from the client to the server.", - "oneOf": [ - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "initialize" - ], - "title": "InitializeRequestMethod" - }, - "params": { - "$ref": "#/definitions/InitializeParams" - } - }, - "title": "InitializeRequest" - }, - { - "description": "NEW APIs", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/start" - ], - "title": "Thread/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadStartParams" - } - }, - "title": "Thread/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/resume" - ], - "title": "Thread/resumeRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadResumeParams" - } - }, - "title": "Thread/resumeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/fork" - ], - "title": "Thread/forkRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadForkParams" - } - }, - "title": "Thread/forkRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/archive" - ], - "title": "Thread/archiveRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadArchiveParams" - } - }, - "title": "Thread/archiveRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/unsubscribe" - ], - "title": "Thread/unsubscribeRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadUnsubscribeParams" - } - }, - "title": "Thread/unsubscribeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/name/set" - ], - "title": "Thread/name/setRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadSetNameParams" - } - }, - "title": "Thread/name/setRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/metadata/update" - ], - "title": "Thread/metadata/updateRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadMetadataUpdateParams" - } - }, - "title": "Thread/metadata/updateRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/unarchive" - ], - "title": "Thread/unarchiveRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadUnarchiveParams" - } - }, - "title": "Thread/unarchiveRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/compact/start" - ], - "title": "Thread/compact/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadCompactStartParams" - } - }, - "title": "Thread/compact/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/shellCommand" - ], - "title": "Thread/shellCommandRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadShellCommandParams" - } - }, - "title": "Thread/shellCommandRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/approveGuardianDeniedAction" - ], - "title": "Thread/approveGuardianDeniedActionRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadApproveGuardianDeniedActionParams" - } - }, - "title": "Thread/approveGuardianDeniedActionRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/rollback" - ], - "title": "Thread/rollbackRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRollbackParams" - } - }, - "title": "Thread/rollbackRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/list" - ], - "title": "Thread/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadListParams" - } - }, - "title": "Thread/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/loaded/list" - ], - "title": "Thread/loaded/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadLoadedListParams" - } - }, - "title": "Thread/loaded/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/read" - ], - "title": "Thread/readRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadReadParams" - } - }, - "title": "Thread/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/turns/list" - ], - "title": "Thread/turns/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadTurnsListParams" - } - }, - "title": "Thread/turns/listRequest" - }, - { - "description": "Append raw Responses API items to the thread history without starting a user turn.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/inject_items" - ], - "title": "Thread/injectItemsRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadInjectItemsParams" - } - }, - "title": "Thread/injectItemsRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "device/key/create" - ], - "title": "Device/key/createRequestMethod" - }, - "params": { - "$ref": "#/definitions/DeviceKeyCreateParams" - } - }, - "title": "Device/key/createRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "device/key/public" - ], - "title": "Device/key/publicRequestMethod" - }, - "params": { - "$ref": "#/definitions/DeviceKeyPublicParams" - } - }, - "title": "Device/key/publicRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "device/key/sign" - ], - "title": "Device/key/signRequestMethod" - }, - "params": { - "$ref": "#/definitions/DeviceKeySignParams" - } - }, - "title": "Device/key/signRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/readFile" - ], - "title": "Fs/readFileRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsReadFileParams" - } - }, - "title": "Fs/readFileRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/writeFile" - ], - "title": "Fs/writeFileRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsWriteFileParams" - } - }, - "title": "Fs/writeFileRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/createDirectory" - ], - "title": "Fs/createDirectoryRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsCreateDirectoryParams" - } - }, - "title": "Fs/createDirectoryRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/getMetadata" - ], - "title": "Fs/getMetadataRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsGetMetadataParams" - } - }, - "title": "Fs/getMetadataRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/readDirectory" - ], - "title": "Fs/readDirectoryRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsReadDirectoryParams" - } - }, - "title": "Fs/readDirectoryRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/remove" - ], - "title": "Fs/removeRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsRemoveParams" - } - }, - "title": "Fs/removeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/copy" - ], - "title": "Fs/copyRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsCopyParams" - } - }, - "title": "Fs/copyRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/watch" - ], - "title": "Fs/watchRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsWatchParams" - } - }, - "title": "Fs/watchRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/unwatch" - ], - "title": "Fs/unwatchRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsUnwatchParams" - } - }, - "title": "Fs/unwatchRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "turn/start" - ], - "title": "Turn/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/TurnStartParams" - } - }, - "title": "Turn/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "turn/steer" - ], - "title": "Turn/steerRequestMethod" - }, - "params": { - "$ref": "#/definitions/TurnSteerParams" - } - }, - "title": "Turn/steerRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "turn/interrupt" - ], - "title": "Turn/interruptRequestMethod" - }, - "params": { - "$ref": "#/definitions/TurnInterruptParams" - } - }, - "title": "Turn/interruptRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "review/start" - ], - "title": "Review/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/ReviewStartParams" - } - }, - "title": "Review/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "model/list" - ], - "title": "Model/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/ModelListParams" - } - }, - "title": "Model/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "experimentalFeature/list" - ], - "title": "ExperimentalFeature/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/ExperimentalFeatureListParams" - } - }, - "title": "ExperimentalFeature/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "experimentalFeature/enablement/set" - ], - "title": "ExperimentalFeature/enablement/setRequestMethod" - }, - "params": { - "$ref": "#/definitions/ExperimentalFeatureEnablementSetParams" - } - }, - "title": "ExperimentalFeature/enablement/setRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServer/oauth/login" - ], - "title": "McpServer/oauth/loginRequestMethod" - }, - "params": { - "$ref": "#/definitions/McpServerOauthLoginParams" - } - }, - "title": "McpServer/oauth/loginRequest" - }, - { - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "config/mcpServer/reload" - ], - "title": "Config/mcpServer/reloadRequestMethod" - }, - "params": { - "type": "null" - } - }, - "title": "Config/mcpServer/reloadRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServerStatus/list" - ], - "title": "McpServerStatus/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/ListMcpServerStatusParams" - } - }, - "title": "McpServerStatus/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServer/resource/read" - ], - "title": "McpServer/resource/readRequestMethod" - }, - "params": { - "$ref": "#/definitions/McpResourceReadParams" - } - }, - "title": "McpServer/resource/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServer/tool/call" - ], - "title": "McpServer/tool/callRequestMethod" - }, - "params": { - "$ref": "#/definitions/McpServerToolCallParams" - } - }, - "title": "McpServer/tool/callRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "windowsSandbox/setupStart" - ], - "title": "WindowsSandbox/setupStartRequestMethod" - }, - "params": { - "$ref": "#/definitions/WindowsSandboxSetupStartParams" - } - }, - "title": "WindowsSandbox/setupStartRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/login/start" - ], - "title": "Account/login/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/LoginAccountParams" - } - }, - "title": "Account/login/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/login/cancel" - ], - "title": "Account/login/cancelRequestMethod" - }, - "params": { - "$ref": "#/definitions/CancelLoginAccountParams" - } - }, - "title": "Account/login/cancelRequest" - }, - { - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/logout" - ], - "title": "Account/logoutRequestMethod" - }, - "params": { - "type": "null" - } - }, - "title": "Account/logoutRequest" - }, - { - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/rateLimits/read" - ], - "title": "Account/rateLimits/readRequestMethod" - }, - "params": { - "type": "null" - } - }, - "title": "Account/rateLimits/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/sendAddCreditsNudgeEmail" - ], - "title": "Account/sendAddCreditsNudgeEmailRequestMethod" - }, - "params": { - "$ref": "#/definitions/SendAddCreditsNudgeEmailParams" - } - }, - "title": "Account/sendAddCreditsNudgeEmailRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "feedback/upload" - ], - "title": "Feedback/uploadRequestMethod" - }, - "params": { - "$ref": "#/definitions/FeedbackUploadParams" - } - }, - "title": "Feedback/uploadRequest" - }, - { - "description": "Execute a standalone command (argv vector) under the server's sandbox.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "command/exec" - ], - "title": "Command/execRequestMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecParams" - } - }, - "title": "Command/execRequest" - }, - { - "description": "Write stdin bytes to a running `command/exec` session or close stdin.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "command/exec/write" - ], - "title": "Command/exec/writeRequestMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecWriteParams" - } - }, - "title": "Command/exec/writeRequest" - }, - { - "description": "Terminate a running `command/exec` session by client-supplied `processId`.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "command/exec/terminate" - ], - "title": "Command/exec/terminateRequestMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecTerminateParams" - } - }, - "title": "Command/exec/terminateRequest" - }, - { - "description": "Resize a running PTY-backed `command/exec` session by client-supplied `processId`.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "command/exec/resize" - ], - "title": "Command/exec/resizeRequestMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecResizeParams" - } - }, - "title": "Command/exec/resizeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "config/read" - ], - "title": "Config/readRequestMethod" - }, - "params": { - "$ref": "#/definitions/ConfigReadParams" - } - }, - "title": "Config/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "config/value/write" - ], - "title": "Config/value/writeRequestMethod" - }, - "params": { - "$ref": "#/definitions/ConfigValueWriteParams" - } - }, - "title": "Config/value/writeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "config/batchWrite" - ], - "title": "Config/batchWriteRequestMethod" - }, - "params": { - "$ref": "#/definitions/ConfigBatchWriteParams" - } - }, - "title": "Config/batchWriteRequest" - }, - { - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "configRequirements/read" - ], - "title": "ConfigRequirements/readRequestMethod" - }, - "params": { - "type": "null" - } - }, - "title": "ConfigRequirements/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/read" - ], - "title": "Account/readRequestMethod" - }, - "params": { - "$ref": "#/definitions/GetAccountParams" - } - }, - "title": "Account/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fuzzyFileSearch" - ], - "title": "FuzzyFileSearchRequestMethod" - }, - "params": { - "$ref": "#/definitions/FuzzyFileSearchParams" - } - }, - "title": "FuzzyFileSearchRequest" - } - ], "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "AddCreditsNudgeCreditType": { - "type": "string", "enum": [ "credits", "usage_limit" - ] + ], + "type": "string" }, "ApprovalsReviewer": { "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", - "type": "string", "enum": [ "user", "auto_review", "guardian_subagent" - ] + ], + "type": "string" }, "AskForApproval": { "oneOf": [ { - "type": "string", "enum": [ "untrusted", "on-failure", "on-request", "never" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "granular" - ], + "additionalProperties": false, "properties": { "granular": { - "type": "object", - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -1481,50 +50,54 @@ "sandbox_approval": { "type": "boolean" } - } + }, + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "GranularAskForApproval" + "required": [ + "granular" + ], + "title": "GranularAskForApproval", + "type": "object" } ] }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CancelLoginAccountParams": { - "type": "object", - "required": [ - "loginId" - ], "properties": { "loginId": { "type": "string" } - } + }, + "required": [ + "loginId" + ], + "type": "object" }, "ClientInfo": { - "type": "object", - "required": [ - "name", - "version" - ], "properties": { "name": { "type": "string" @@ -1538,15 +111,15 @@ "version": { "type": "string" } - } + }, + "required": [ + "name", + "version" + ], + "type": "object" }, "CollaborationMode": { "description": "Collaboration mode for a Codex session.", - "type": "object", - "required": [ - "mode", - "settings" - ], "properties": { "mode": { "$ref": "#/definitions/ModeKind" @@ -1554,42 +127,22 @@ "settings": { "$ref": "#/definitions/Settings" } - } - }, - "WindowsSandboxSetupStartParams": { - "type": "object", + }, "required": [ - "mode" + "mode", + "settings" ], - "properties": { - "cwd": { - "anyOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - }, - { - "type": "null" - } - ] - }, - "mode": { - "$ref": "#/definitions/WindowsSandboxSetupMode" - } - } + "type": "object" }, "CommandExecParams": { "description": "Run a standalone command (argv vector) in the server sandbox without creating a thread or turn.\n\nThe final `command/exec` response is deferred until the process exits and is sent only after all `command/exec/outputDelta` notifications for that connection have been emitted.", - "type": "object", - "required": [ - "command" - ], "properties": { "command": { "description": "Command argv vector. Empty arrays are rejected.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "cwd": { "description": "Optional working directory. Defaults to the server cwd.", @@ -1607,26 +160,26 @@ "type": "boolean" }, "env": { - "description": "Optional environment overrides merged into the server-computed environment.\n\nMatching names override inherited values. Set a key to `null` to unset an inherited variable.", - "type": [ - "object", - "null" - ], "additionalProperties": { "type": [ "string", "null" ] - } + }, + "description": "Optional environment overrides merged into the server-computed environment.\n\nMatching names override inherited values. Set a key to `null` to unset an inherited variable.", + "type": [ + "object", + "null" + ] }, "outputBytesCap": { "description": "Optional per-stream stdout/stderr capture cap in bytes.\n\nWhen omitted, the server default applies. Cannot be combined with `disableOutputCap`.", + "format": "uint", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 0.0 + ] }, "processId": { "description": "Optional client-supplied, connection-scoped process id.\n\nRequired for `tty`, `streamStdin`, `streamStdoutStderr`, and follow-up `command/exec/write`, `command/exec/resize`, and `command/exec/terminate` calls. When omitted, buffered execution gets an internal id that is not exposed to the client.", @@ -1636,7 +189,6 @@ ] }, "sandboxPolicy": { - "description": "Optional sandbox policy for this command.\n\nUses the same shape as thread/turn execution sandbox configuration and defaults to the user's configured policy when omitted.", "anyOf": [ { "$ref": "#/definitions/SandboxPolicy" @@ -1644,10 +196,10 @@ { "type": "null" } - ] + ], + "description": "Optional sandbox policy for this command.\n\nUses the same shape as thread/turn execution sandbox configuration and defaults to the user's configured policy when omitted." }, "size": { - "description": "Optional initial PTY size in character cells. Only valid when `tty` is true.", "anyOf": [ { "$ref": "#/definitions/CommandExecTerminalSize" @@ -1655,7 +207,8 @@ { "type": "null" } - ] + ], + "description": "Optional initial PTY size in character cells. Only valid when `tty` is true." }, "streamStdin": { "description": "Allow follow-up `command/exec/write` requests to write stdin bytes.\n\nRequires a client-supplied `processId`.", @@ -1667,81 +220,81 @@ }, "timeoutMs": { "description": "Optional timeout in milliseconds.\n\nWhen omitted, the server default applies. Cannot be combined with `disableTimeout`.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "tty": { "description": "Enable PTY mode.\n\nThis implies `streamStdin` and `streamStdoutStderr`.", "type": "boolean" } - } + }, + "required": [ + "command" + ], + "type": "object" }, "CommandExecResizeParams": { "description": "Resize a running PTY-backed `command/exec` session.", - "type": "object", - "required": [ - "processId", - "size" - ], "properties": { "processId": { "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", "type": "string" }, "size": { - "description": "New PTY size in character cells.", "allOf": [ { "$ref": "#/definitions/CommandExecTerminalSize" } - ] + ], + "description": "New PTY size in character cells." } - } + }, + "required": [ + "processId", + "size" + ], + "type": "object" }, "CommandExecTerminalSize": { "description": "PTY size in character cells for `command/exec` PTY sessions.", - "type": "object", + "properties": { + "cols": { + "description": "Terminal width in character cells.", + "format": "uint16", + "minimum": 0.0, + "type": "integer" + }, + "rows": { + "description": "Terminal height in character cells.", + "format": "uint16", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "cols", "rows" ], - "properties": { - "cols": { - "description": "Terminal width in character cells.", - "type": "integer", - "format": "uint16", - "minimum": 0.0 - }, - "rows": { - "description": "Terminal height in character cells.", - "type": "integer", - "format": "uint16", - "minimum": 0.0 - } - } + "type": "object" }, "CommandExecTerminateParams": { "description": "Terminate a running `command/exec` session.", - "type": "object", - "required": [ - "processId" - ], "properties": { "processId": { "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", "type": "string" } - } - }, - "CommandExecWriteParams": { - "description": "Write stdin bytes to a running `command/exec` session, close stdin, or both.", - "type": "object", + }, "required": [ "processId" ], + "type": "object" + }, + "CommandExecWriteParams": { + "description": "Write stdin bytes to a running `command/exec` session, close stdin, or both.", "properties": { "closeStdin": { "description": "Close stdin after writing `deltaBase64`, if present.", @@ -1758,19 +311,19 @@ "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", "type": "string" } - } + }, + "required": [ + "processId" + ], + "type": "object" }, "ConfigBatchWriteParams": { - "type": "object", - "required": [ - "edits" - ], "properties": { "edits": { - "type": "array", "items": { "$ref": "#/definitions/ConfigEdit" - } + }, + "type": "array" }, "expectedVersion": { "type": [ @@ -1789,15 +342,13 @@ "description": "When true, hot-reload the updated user config into all loaded threads after writing.", "type": "boolean" } - } + }, + "required": [ + "edits" + ], + "type": "object" }, "ConfigEdit": { - "type": "object", - "required": [ - "keyPath", - "mergeStrategy", - "value" - ], "properties": { "keyPath": { "type": "string" @@ -1806,10 +357,15 @@ "$ref": "#/definitions/MergeStrategy" }, "value": true - } + }, + "required": [ + "keyPath", + "mergeStrategy", + "value" + ], + "type": "object" }, "ConfigReadParams": { - "type": "object", "properties": { "cwd": { "description": "Optional working directory to resolve project config layers. If specified, return the effective config as seen from that directory (i.e., including any project layers between `cwd` and the project/repo root).", @@ -1822,15 +378,10 @@ "default": false, "type": "boolean" } - } + }, + "type": "object" }, "ConfigValueWriteParams": { - "type": "object", - "required": [ - "keyPath", - "mergeStrategy", - "value" - ], "properties": { "expectedVersion": { "type": [ @@ -1852,36 +403,37 @@ "$ref": "#/definitions/MergeStrategy" }, "value": true - } + }, + "required": [ + "keyPath", + "mergeStrategy", + "value" + ], + "type": "object" }, "ContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "input_text" ], - "title": "InputTextContentItemType" + "title": "InputTextContentItemType", + "type": "string" } }, - "title": "InputTextContentItem" - }, - { - "type": "object", "required": [ - "image_url", + "text", "type" ], + "title": "InputTextContentItem", + "type": "object" + }, + { "properties": { "detail": { "anyOf": [ @@ -1897,44 +449,44 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "input_image" ], - "title": "InputImageContentItemType" + "title": "InputImageContentItemType", + "type": "string" } }, - "title": "InputImageContentItem" - }, - { - "type": "object", "required": [ - "text", + "image_url", "type" ], + "title": "InputImageContentItem", + "type": "object" + }, + { "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "output_text" ], - "title": "OutputTextContentItemType" + "title": "OutputTextContentItemType", + "type": "string" } }, - "title": "OutputTextContentItem" + "required": [ + "text", + "type" + ], + "title": "OutputTextContentItem", + "type": "object" } ] }, "DeviceKeyCreateParams": { "description": "Create a controller-local device key with a random key id.", - "type": "object", - "required": [ - "accountUserId", - "clientId" - ], "properties": { "accountUserId": { "type": "string" @@ -1943,7 +495,6 @@ "type": "string" }, "protectionPolicy": { - "description": "Defaults to `hardware_only` when omitted.", "anyOf": [ { "$ref": "#/definitions/DeviceKeyProtectionPolicy" @@ -1951,37 +502,38 @@ { "type": "null" } - ] + ], + "description": "Defaults to `hardware_only` when omitted." } - } + }, + "required": [ + "accountUserId", + "clientId" + ], + "type": "object" }, "DeviceKeyProtectionPolicy": { "description": "Protection policy for creating or loading a controller-local device key.", - "type": "string", "enum": [ "hardware_only", "allow_os_protected_nonextractable" - ] + ], + "type": "string" }, "DeviceKeyPublicParams": { "description": "Fetch a controller-local device key public key by id.", - "type": "object", - "required": [ - "keyId" - ], "properties": { "keyId": { "type": "string" } - } + }, + "required": [ + "keyId" + ], + "type": "object" }, "DeviceKeySignParams": { "description": "Sign an accepted structured payload with a controller-local device key.", - "type": "object", - "required": [ - "keyId", - "payload" - ], "properties": { "keyId": { "type": "string" @@ -1989,27 +541,18 @@ "payload": { "$ref": "#/definitions/DeviceKeySignPayload" } - } + }, + "required": [ + "keyId", + "payload" + ], + "type": "object" }, "DeviceKeySignPayload": { "description": "Structured payloads accepted by `device/key/sign`.", "oneOf": [ { "description": "Payload bound to one remote-control controller websocket `/client` connection challenge.", - "type": "object", - "required": [ - "accountUserId", - "audience", - "clientId", - "nonce", - "scopes", - "sessionId", - "targetOrigin", - "targetPath", - "tokenExpiresAt", - "tokenSha256Base64url", - "type" - ], "properties": { "accountUserId": { "type": "string" @@ -2025,10 +568,10 @@ }, "scopes": { "description": "Must contain exactly `remote_control_controller_websocket`.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "sessionId": { "description": "Backend-issued websocket session id that this proof authorizes.", @@ -2044,38 +587,39 @@ }, "tokenExpiresAt": { "description": "Remote-control token expiration as Unix seconds.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "tokenSha256Base64url": { "description": "SHA-256 of the controller-scoped remote-control token, encoded as unpadded base64url.", "type": "string" }, "type": { - "type": "string", "enum": [ "remoteControlClientConnection" ], - "title": "RemoteControlClientConnectionDeviceKeySignPayloadType" + "title": "RemoteControlClientConnectionDeviceKeySignPayloadType", + "type": "string" } }, - "title": "RemoteControlClientConnectionDeviceKeySignPayload" - }, - { - "description": "Payload bound to a remote-control client `/client/enroll` ownership challenge.", - "type": "object", "required": [ "accountUserId", "audience", - "challengeExpiresAt", - "challengeId", "clientId", - "deviceIdentitySha256Base64url", "nonce", + "scopes", + "sessionId", "targetOrigin", "targetPath", + "tokenExpiresAt", + "tokenSha256Base64url", "type" ], + "title": "RemoteControlClientConnectionDeviceKeySignPayload", + "type": "object" + }, + { + "description": "Payload bound to a remote-control client `/client/enroll` ownership challenge.", "properties": { "accountUserId": { "type": "string" @@ -2085,8 +629,8 @@ }, "challengeExpiresAt": { "description": "Enrollment challenge expiration as Unix seconds.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "challengeId": { "description": "Backend-issued enrollment challenge id that this proof authorizes.", @@ -2111,24 +655,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "remoteControlClientEnrollment" ], - "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType" + "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType", + "type": "string" } }, - "title": "RemoteControlClientEnrollmentDeviceKeySignPayload" + "required": [ + "accountUserId", + "audience", + "challengeExpiresAt", + "challengeId", + "clientId", + "deviceIdentitySha256Base64url", + "nonce", + "targetOrigin", + "targetPath", + "type" + ], + "title": "RemoteControlClientEnrollmentDeviceKeySignPayload", + "type": "object" } ] }, "DynamicToolSpec": { - "type": "object", - "required": [ - "description", - "inputSchema", - "name" - ], "properties": { "deferLoading": { "type": "boolean" @@ -2146,20 +697,15 @@ "null" ] } - } + }, + "required": [ + "description", + "inputSchema", + "name" + ], + "type": "object" }, "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], "properties": { "accepted_at": { "type": "string" @@ -2203,42 +749,41 @@ "surface": { "type": "string" } - } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" }, "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], "properties": { "acceptance_sketch": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "blockers": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": "string" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "duplicate_of": { "type": [ @@ -2247,10 +792,10 @@ ] }, "evidence_refs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "horizon": { "type": "string" @@ -2262,10 +807,10 @@ "type": "string" }, "lane_hints": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -2274,10 +819,10 @@ "type": "string" }, "source_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } + }, + "type": "array" }, "status": { "type": "string" @@ -2294,14 +839,21 @@ "null" ] } - } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], "properties": { "diff_pressure": { "type": "string" @@ -2316,12 +868,12 @@ "type": "string" }, "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "warning": { "type": [ @@ -2329,21 +881,22 @@ "null" ] } - } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" }, "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], "properties": { "end_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "note": { "type": [ @@ -2355,12 +908,12 @@ "type": "string" }, "start_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "symbol": { "type": [ @@ -2368,22 +921,19 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2397,57 +947,59 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyGraph": { - "type": "object", "properties": { "edges": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphEdge" - } + }, + "type": "array" }, "nodes": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphNode" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], "properties": { "checkpoint_id": { "type": "string" }, "frontier_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "graph_revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -2455,21 +1007,20 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" }, "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": [ @@ -2498,58 +1049,59 @@ "target_id": { "type": "string" } - } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" }, "EpiphanyGraphFrontier": { - "type": "object", "properties": { "active_edge_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "active_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], "properties": { "architecture_node_id": { "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "dataflow_node_id": { "type": "string" @@ -2560,21 +1112,20 @@ "null" ] } - } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" }, "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2603,10 +1154,15 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" }, "EpiphanyGraphs": { - "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -2615,20 +1171,15 @@ "$ref": "#/definitions/EpiphanyGraph" }, "links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphLink" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], "properties": { "description": { "type": "string" @@ -2645,16 +1196,15 @@ "status": { "type": "string" } - } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" }, "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], "properties": { "captured_at_turn_id": { "type": [ @@ -2666,19 +1216,19 @@ "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "disposition": { "$ref": "#/definitions/EpiphanyInvestigationDisposition" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "focus": { "type": "string" @@ -2693,10 +1243,10 @@ ] }, "open_questions": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -2704,23 +1254,23 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" }, "EpiphanyInvestigationDisposition": { - "type": "string", "enum": [ "resume_ready", "regather_required" - ] + ], + "type": "string" }, "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], "properties": { "authority_scope": { "type": [ @@ -2741,16 +1291,16 @@ "$ref": "#/definitions/EpiphanyJobKind" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "owner_role": { "type": "string" @@ -2758,29 +1308,32 @@ "scope": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" }, "EpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "EpiphanyModeKind": { - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], "properties": { "kind": { "anyOf": [ @@ -2795,36 +1348,31 @@ "name": { "type": "string" } - } + }, + "required": [ + "name" + ], + "type": "object" }, "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], "properties": { "acceptance_criteria": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "evidence_required": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2833,25 +1381,25 @@ "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" }, "review_gates": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "risks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "scope": { "$ref": "#/definitions/EpiphanyObjectiveDraftScope" }, "source_item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "status": { "type": "string" @@ -2862,10 +1410,18 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyObjectiveDraftLanePlan": { - "type": "object", "properties": { "body": { "type": [ @@ -2903,45 +1459,39 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyObjectiveDraftScope": { - "type": "object", "properties": { "excludes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2955,17 +1505,16 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], "properties": { "body": { "type": [ @@ -2998,10 +1547,10 @@ "type": "string" }, "tags": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": "string" @@ -3012,20 +1561,23 @@ "null" ] } - } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" }, "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], "properties": { "blocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": [ @@ -3055,10 +1607,10 @@ ] }, "unblocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "urgency": { "type": [ @@ -3069,19 +1621,20 @@ "value": { "type": "string" } - } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" }, "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], "properties": { "assignees": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "author": { "type": [ @@ -3102,11 +1655,11 @@ ] }, "database_id": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "external_id": { "type": [ @@ -3127,21 +1680,21 @@ ] }, "issue_number": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "kind": { "type": "string" }, "labels": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "milestone": { "type": [ @@ -3191,34 +1744,37 @@ "null" ] } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "EpiphanyPlanningState": { - "type": "object", "properties": { "backlog_items": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyBacklogItem" - } + }, + "type": "array" }, "captures": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningCapture" - } + }, + "type": "array" }, "objective_drafts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObjectiveDraft" - } + }, + "type": "array" }, "roadmap_streams": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRoadmapStream" - } + }, + "type": "array" }, "workspace_root": { "type": [ @@ -3226,31 +1782,25 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], "properties": { "blocked_by": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "near_term_focus": { "type": [ @@ -3273,18 +1823,16 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" }, "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], "properties": { "authority_scope": { "type": "string" @@ -3296,16 +1844,16 @@ "type": "string" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "role_id": { "type": "string" @@ -3322,10 +1870,18 @@ "surface": { "type": "string" } - } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" }, "EpiphanyScratchPad": { - "type": "object", "properties": { "hypothesis": { "type": [ @@ -3340,10 +1896,10 @@ ] }, "notes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -3351,15 +1907,10 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], "properties": { "id": { "type": "string" @@ -3376,25 +1927,30 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" }, "ExperimentalFeatureEnablementSetParams": { - "type": "object", + "properties": { + "enablement": { + "additionalProperties": { + "type": "boolean" + }, + "description": "Process-wide runtime feature enablement keyed by canonical feature name.\n\nOnly named features are updated. Omitted features are left unchanged. Send an empty map for a no-op.", + "type": "object" + } + }, "required": [ "enablement" ], - "properties": { - "enablement": { - "description": "Process-wide runtime feature enablement keyed by canonical feature name.\n\nOnly named features are updated. Omitted features are left unchanged. Send an empty map for a no-op.", - "type": "object", - "additionalProperties": { - "type": "boolean" - } - } - } + "type": "object" }, "ExperimentalFeatureListParams": { - "type": "object", "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -3405,33 +1961,29 @@ }, "limit": { "description": "Optional page size; defaults to a reasonable server-side value.", + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] } - } + }, + "type": "object" }, "FeedbackUploadParams": { - "type": "object", - "required": [ - "classification", - "includeLogs" - ], "properties": { "classification": { "type": "string" }, "extraLogFiles": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "includeLogs": { "type": "boolean" @@ -3443,13 +1995,13 @@ ] }, "tags": { + "additionalProperties": { + "type": "string" + }, "type": [ "object", "null" - ], - "additionalProperties": { - "type": "string" - } + ] }, "threadId": { "type": [ @@ -3457,86 +2009,86 @@ "null" ] } - } + }, + "required": [ + "classification", + "includeLogs" + ], + "type": "object" }, "FileSystemAccessMode": { - "type": "string", "enum": [ "read", "write", "none" - ] + ], + "type": "string" }, "FileSystemPath": { "oneOf": [ { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "path" ], - "title": "PathFileSystemPathType" + "title": "PathFileSystemPathType", + "type": "string" } }, - "title": "PathFileSystemPath" - }, - { - "type": "object", "required": [ - "pattern", + "path", "type" ], + "title": "PathFileSystemPath", + "type": "object" + }, + { "properties": { "pattern": { "type": "string" }, "type": { - "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType" + "title": "GlobPatternFileSystemPathType", + "type": "string" } }, - "title": "GlobPatternFileSystemPath" + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType" + "title": "SpecialFileSystemPathType", + "type": "string" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "title": "SpecialFileSystemPath" + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" } ] }, "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -3544,66 +2096,67 @@ "path": { "$ref": "#/definitions/FileSystemPath" } - } + }, + "required": [ + "access", + "path" + ], + "type": "object" }, "FileSystemSpecialPath": { "oneOf": [ { - "type": "object", - "required": [ - "kind" - ], "properties": { "kind": { - "type": "string", "enum": [ "root" - ] + ], + "type": "string" } }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "minimal" - ] + ], + "type": "string" } }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "current_working_directory" - ] + ], + "type": "string" } }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "project_roots" - ] + ], + "type": "string" }, "subpath": { "type": [ @@ -3612,50 +2165,49 @@ ] } }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "tmpdir" - ] + ], + "type": "string" } }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" }, { - "type": "object", - "required": [ - "kind", - "path" - ], "properties": { "kind": { - "type": "string", "enum": [ "unknown" - ] + ], + "type": "string" }, "path": { "type": "string" @@ -3666,54 +2218,55 @@ "null" ] } - } + }, + "required": [ + "kind", + "path" + ], + "type": "object" } ] }, "FsCopyParams": { "description": "Copy a file or directory tree on the host filesystem.", - "type": "object", - "required": [ - "destinationPath", - "sourcePath" - ], "properties": { "destinationPath": { - "description": "Absolute destination path.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute destination path." }, "recursive": { "description": "Required for directory copies; ignored for file copies.", "type": "boolean" }, "sourcePath": { - "description": "Absolute source path.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute source path." } - } + }, + "required": [ + "destinationPath", + "sourcePath" + ], + "type": "object" }, "FsCreateDirectoryParams": { "description": "Create a directory on the host filesystem.", - "type": "object", - "required": [ - "path" - ], "properties": { "path": { - "description": "Absolute directory path to create.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute directory path to create." }, "recursive": { "description": "Whether parent directories should also be created. Defaults to `true`.", @@ -3722,65 +2275,65 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "FsGetMetadataParams": { "description": "Request metadata for an absolute path.", - "type": "object", - "required": [ - "path" - ], "properties": { "path": { - "description": "Absolute path to inspect.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute path to inspect." } - } + }, + "required": [ + "path" + ], + "type": "object" }, "FsReadDirectoryParams": { "description": "List direct child names for a directory.", - "type": "object", - "required": [ - "path" - ], "properties": { "path": { - "description": "Absolute directory path to read.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute directory path to read." } - } + }, + "required": [ + "path" + ], + "type": "object" }, "FsReadFileParams": { "description": "Read a file from the host filesystem.", - "type": "object", - "required": [ - "path" - ], "properties": { "path": { - "description": "Absolute path to read.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute path to read." } - } - }, - "FsRemoveParams": { - "description": "Remove a file or directory tree from the host filesystem.", - "type": "object", + }, "required": [ "path" ], + "type": "object" + }, + "FsRemoveParams": { + "description": "Remove a file or directory tree from the host filesystem.", "properties": { "force": { "description": "Whether missing paths should be ignored. Defaults to `true`.", @@ -3790,12 +2343,12 @@ ] }, "path": { - "description": "Absolute path to remove.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute path to remove." }, "recursive": { "description": "Whether directory removal should recurse. Defaults to `true`.", @@ -3804,64 +2357,68 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "FsUnwatchParams": { "description": "Stop filesystem watch notifications for a prior `fs/watch`.", - "type": "object", - "required": [ - "watchId" - ], "properties": { "watchId": { "description": "Watch identifier previously provided to `fs/watch`.", "type": "string" } - } + }, + "required": [ + "watchId" + ], + "type": "object" }, "FsWatchParams": { "description": "Start filesystem watch notifications for an absolute path.", - "type": "object", - "required": [ - "path", - "watchId" - ], "properties": { "path": { - "description": "Absolute file or directory path to watch.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute file or directory path to watch." }, "watchId": { "description": "Connection-scoped watch identifier used for `fs/unwatch` and `fs/changed`.", "type": "string" } - } + }, + "required": [ + "path", + "watchId" + ], + "type": "object" }, "FsWriteFileParams": { "description": "Write a file on the host filesystem.", - "type": "object", - "required": [ - "dataBase64", - "path" - ], "properties": { "dataBase64": { "description": "File contents encoded as base64.", "type": "string" }, "path": { - "description": "Absolute path to write.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute path to write." } - } + }, + "required": [ + "dataBase64", + "path" + ], + "type": "object" }, "FunctionCallOutputBody": { "anyOf": [ @@ -3869,10 +2426,10 @@ "type": "string" }, { - "type": "array", "items": { "$ref": "#/definitions/FunctionCallOutputContentItem" - } + }, + "type": "array" } ] }, @@ -3880,31 +2437,26 @@ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.", "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "input_text" ], - "title": "InputTextFunctionCallOutputContentItemType" + "title": "InputTextFunctionCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextFunctionCallOutputContentItem" - }, - { - "type": "object", "required": [ - "image_url", + "text", "type" ], + "title": "InputTextFunctionCallOutputContentItem", + "type": "object" + }, + { "properties": { "detail": { "anyOf": [ @@ -3920,23 +2472,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "input_image" ], - "title": "InputImageFunctionCallOutputContentItemType" + "title": "InputImageFunctionCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageFunctionCallOutputContentItem" + "required": [ + "image_url", + "type" + ], + "title": "InputImageFunctionCallOutputContentItem", + "type": "object" } ] }, "FuzzyFileSearchParams": { - "type": "object", - "required": [ - "query", - "roots" - ], "properties": { "cancellationToken": { "type": [ @@ -3948,157 +2500,30 @@ "type": "string" }, "roots": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } - }, - "WindowsSandboxSetupMode": { - "type": "string", - "enum": [ - "elevated", - "unelevated" - ] - }, - "UserInput": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/TextElement" - } - }, - "type": { - "type": "string", - "enum": [ - "text" - ], - "title": "TextUserInputType" - } - }, - "title": "TextUserInput" - }, - { - "type": "object", - "required": [ - "type", - "url" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "image" - ], - "title": "ImageUserInputType" - }, - "url": { - "type": "string" - } - }, - "title": "ImageUserInput" - }, - { - "type": "object", - "required": [ - "path", - "type" - ], - "properties": { - "path": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "localImage" - ], - "title": "LocalImageUserInputType" - } - }, - "title": "LocalImageUserInput" - }, - { - "type": "object", - "required": [ - "name", - "path", - "type" - ], - "properties": { - "name": { - "type": "string" - }, - "path": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "mention" - ], - "title": "MentionUserInputType" - } - }, - "title": "MentionUserInput" - } - ] - }, - "TurnSteerParams": { - "type": "object", + }, "required": [ - "expectedTurnId", - "input", - "threadId" + "query", + "roots" ], - "properties": { - "expectedTurnId": { - "description": "Required active turn id precondition. The request fails when it does not match the currently active turn.", - "type": "string" - }, - "input": { - "type": "array", - "items": { - "$ref": "#/definitions/UserInput" - } - }, - "threadId": { - "type": "string" - } - } + "type": "object" }, "GetAccountParams": { - "type": "object", "properties": { "refreshToken": { - "description": "When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.", "default": false, + "description": "When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.", "type": "boolean" } - } + }, + "type": "object" }, "GhostCommit": { "description": "Details of a ghost commit created from a repository state.", - "type": "object", - "required": [ - "id", - "preexisting_untracked_dirs", - "preexisting_untracked_files" - ], "properties": { "id": { "type": "string" @@ -4110,54 +2535,56 @@ ] }, "preexisting_untracked_dirs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "preexisting_untracked_files": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "required": [ + "id", + "preexisting_untracked_dirs", + "preexisting_untracked_files" + ], + "type": "object" }, "ImageDetail": { - "type": "string", "enum": [ "auto", "low", "high", "original" - ] + ], + "type": "string" }, "InitializeCapabilities": { "description": "Client-declared capabilities negotiated during initialize.", - "type": "object", "properties": { "experimentalApi": { - "description": "Opt into receiving experimental API methods and fields.", "default": false, + "description": "Opt into receiving experimental API methods and fields.", "type": "boolean" }, "optOutNotificationMethods": { "description": "Exact notification method names that should be suppressed for this connection (for example `thread/started`).", + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] } - } + }, + "type": "object" }, "InitializeParams": { - "type": "object", - "required": [ - "clientInfo" - ], "properties": { "capabilities": { "anyOf": [ @@ -4172,10 +2599,13 @@ "clientInfo": { "$ref": "#/definitions/ClientInfo" } - } + }, + "required": [ + "clientInfo" + ], + "type": "object" }, "ListMcpServerStatusParams": { - "type": "object", "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -4185,7 +2615,6 @@ ] }, "detail": { - "description": "Controls how much MCP inventory data to fetch for each server. Defaults to `Full` when omitted.", "anyOf": [ { "$ref": "#/definitions/McpServerStatusDetail" @@ -4193,57 +2622,54 @@ { "type": "null" } - ] + ], + "description": "Controls how much MCP inventory data to fetch for each server. Defaults to `Full` when omitted." }, "limit": { "description": "Optional page size; defaults to a server-defined value.", + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] } - } + }, + "type": "object" }, "LocalShellAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "type" - ], "properties": { "command": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "env": { + "additionalProperties": { + "type": "string" + }, "type": [ "object", "null" - ], - "additionalProperties": { - "type": "string" - } + ] }, "timeout_ms": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "type": { - "type": "string", "enum": [ "exec" ], - "title": "ExecLocalShellActionType" + "title": "ExecLocalShellActionType", + "type": "string" }, "user": { "type": [ @@ -4258,80 +2684,79 @@ ] } }, - "title": "ExecLocalShellAction" + "required": [ + "command", + "type" + ], + "title": "ExecLocalShellAction", + "type": "object" } ] }, "LocalShellStatus": { - "type": "string", "enum": [ "completed", "in_progress", "incomplete" - ] + ], + "type": "string" }, "LoginAccountParams": { "oneOf": [ { - "type": "object", - "required": [ - "apiKey", - "type" - ], "properties": { "apiKey": { "type": "string" }, "type": { - "type": "string", "enum": [ "apiKey" ], - "title": "ApiKeyLoginAccountParamsType" + "title": "ApiKeyLoginAccountParamsType", + "type": "string" } }, - "title": "ApiKeyLoginAccountParams" - }, - { - "type": "object", "required": [ + "apiKey", "type" ], + "title": "ApiKeyLoginAccountParams", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "chatgpt" ], - "title": "ChatgptLoginAccountParamsType" + "title": "ChatgptLoginAccountParamsType", + "type": "string" } }, - "title": "ChatgptLoginAccountParams" - }, - { - "type": "object", "required": [ "type" ], + "title": "ChatgptLoginAccountParams", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "chatgptDeviceCode" ], - "title": "ChatgptDeviceCodeLoginAccountParamsType" + "title": "ChatgptDeviceCodeLoginAccountParamsType", + "type": "string" } }, - "title": "ChatgptDeviceCodeLoginAccountParams" + "required": [ + "type" + ], + "title": "ChatgptDeviceCodeLoginAccountParams", + "type": "object" }, { "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE. The access token must contain the same scopes that Codex-managed ChatGPT auth tokens have.", - "type": "object", - "required": [ - "accessToken", - "chatgptAccountId", - "type" - ], "properties": { "accessToken": { "description": "Access token (JWT) supplied by the client. This token is used for backend API requests and email extraction.", @@ -4349,23 +2774,24 @@ ] }, "type": { - "type": "string", "enum": [ "chatgptAuthTokens" ], - "title": "ChatgptAuthTokensLoginAccountParamsType" + "title": "ChatgptAuthTokensLoginAccountParamsType", + "type": "string" } }, - "title": "ChatgptAuthTokensLoginAccountParams" + "required": [ + "accessToken", + "chatgptAccountId", + "type" + ], + "title": "ChatgptAuthTokensLoginAccountParams", + "type": "object" } ] }, "McpResourceReadParams": { - "type": "object", - "required": [ - "server", - "uri" - ], "properties": { "server": { "type": "string" @@ -4379,49 +2805,48 @@ "uri": { "type": "string" } - } + }, + "required": [ + "server", + "uri" + ], + "type": "object" }, "McpServerOauthLoginParams": { - "type": "object", - "required": [ - "name" - ], "properties": { "name": { "type": "string" }, "scopes": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "timeoutSecs": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] } - } + }, + "required": [ + "name" + ], + "type": "object" }, "McpServerStatusDetail": { - "type": "string", "enum": [ "full", "toolsAndAuthOnly" - ] + ], + "type": "string" }, "McpServerToolCallParams": { - "type": "object", - "required": [ - "server", - "threadId", - "tool" - ], "properties": { "_meta": true, "arguments": true, @@ -4434,174 +2859,49 @@ "tool": { "type": "string" } - } + }, + "required": [ + "server", + "threadId", + "tool" + ], + "type": "object" }, "MergeStrategy": { - "type": "string", "enum": [ "replace", "upsert" - ] + ], + "type": "string" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, - "TurnStartParams": { - "type": "object", - "required": [ - "input", - "threadId" - ], - "properties": { - "approvalPolicy": { - "description": "Override the approval policy for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/AskForApproval" - }, - { - "type": "null" - } - ] - }, - "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - }, - "cwd": { - "description": "Override the working directory for this turn and subsequent turns.", - "type": [ - "string", - "null" - ] - }, - "effort": { - "description": "Override the reasoning effort for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "summary": { - "description": "Override the reasoning summary for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ReasoningSummary" - }, - { - "type": "null" - } - ] - }, - "input": { - "type": "array", - "items": { - "$ref": "#/definitions/UserInput" - } - }, - "model": { - "description": "Override the model for this turn and subsequent turns.", - "type": [ - "string", - "null" - ] - }, - "outputSchema": { - "description": "Optional JSON Schema used to constrain the final assistant message for this turn." - }, - "permissionProfile": { - "description": "Override the full permissions profile for this turn and subsequent turns. Cannot be combined with `sandboxPolicy`.", - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "personality": { - "description": "Override the personality for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/Personality" - }, - { - "type": "null" - } - ] - }, - "serviceTier": { - "description": "Override the service tier for this turn and subsequent turns.", - "anyOf": [ - { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - { - "type": "null" - } - ] - }, - "sandboxPolicy": { - "description": "Override the sandbox policy for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/SandboxPolicy" - }, - { - "type": "null" - } - ] - } - } - }, "ModeKind": { "description": "Initial collaboration mode to use when the TUI starts.", - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "ModelListParams": { - "type": "object", "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -4619,24 +2919,24 @@ }, "limit": { "description": "Optional page size; defaults to a reasonable server-side value.", + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] } - } + }, + "type": "object" }, "NetworkAccess": { - "type": "string", "enum": [ "restricted", "enabled" - ] + ], + "type": "string" }, "PermissionProfile": { - "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -4658,32 +2958,32 @@ } ] } - } + }, + "type": "object" }, "PermissionProfileFileSystemPermissions": { - "type": "object", - "required": [ - "entries" - ], "properties": { "entries": { - "type": "array", "items": { "$ref": "#/definitions/FileSystemSandboxEntry" - } + }, + "type": "array" }, "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 1.0 + ] } - } + }, + "required": [ + "entries" + ], + "type": "object" }, "PermissionProfileNetworkPermissions": { - "type": "object", "properties": { "enabled": { "type": [ @@ -4691,23 +2991,20 @@ "null" ] } - } + }, + "type": "object" }, "Personality": { - "type": "string", "enum": [ "none", "friendly", "pragmatic" - ] + ], + "type": "string" }, "ReadOnlyAccess": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "includePlatformDefaults": { "default": true, @@ -4715,48 +3012,51 @@ }, "readableRoots": { "default": [], - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "restricted" ], - "title": "RestrictedReadOnlyAccessType" + "title": "RestrictedReadOnlyAccessType", + "type": "string" } }, - "title": "RestrictedReadOnlyAccess" - }, - { - "type": "object", "required": [ "type" ], + "title": "RestrictedReadOnlyAccess", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "fullAccess" ], - "title": "FullAccessReadOnlyAccessType" + "title": "FullAccessReadOnlyAccessType", + "type": "string" } }, - "title": "FullAccessReadOnlyAccess" + "required": [ + "type" + ], + "title": "FullAccessReadOnlyAccess", + "type": "object" } ] }, "RealtimeOutputModality": { - "type": "string", "enum": [ "text", "audio" - ] + ], + "type": "string" }, "RealtimeVoice": { - "type": "string", "enum": [ "alloy", "arbor", @@ -4777,11 +3077,11 @@ "spruce", "vale", "verse" - ] + ], + "type": "string" }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -4789,73 +3089,74 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "ReasoningItemContent": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "reasoning_text" ], - "title": "ReasoningTextReasoningItemContentType" + "title": "ReasoningTextReasoningItemContentType", + "type": "string" } }, - "title": "ReasoningTextReasoningItemContent" - }, - { - "type": "object", "required": [ "text", "type" ], + "title": "ReasoningTextReasoningItemContent", + "type": "object" + }, + { "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextReasoningItemContentType" + "title": "TextReasoningItemContentType", + "type": "string" } }, - "title": "TextReasoningItemContent" + "required": [ + "text", + "type" + ], + "title": "TextReasoningItemContent", + "type": "object" } ] }, "ReasoningItemReasoningSummary": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "summary_text" ], - "title": "SummaryTextReasoningItemReasoningSummaryType" + "title": "SummaryTextReasoningItemReasoningSummaryType", + "type": "string" } }, - "title": "SummaryTextReasoningItemReasoningSummary" + "required": [ + "text", + "type" + ], + "title": "SummaryTextReasoningItemReasoningSummary", + "type": "object" } ] }, @@ -4863,35 +3164,35 @@ "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries", "oneOf": [ { - "type": "string", "enum": [ "auto", "concise", "detailed" - ] + ], + "type": "string" }, { "description": "Option to disable reasoning summaries.", - "type": "string", "enum": [ "none" - ] + ], + "type": "string" } ] }, "RemoteControlClientConnectionAudience": { "description": "Audience for a remote-control client connection device-key proof.", - "type": "string", "enum": [ "remote_control_client_websocket" - ] + ], + "type": "string" }, "RemoteControlClientEnrollmentAudience": { "description": "Audience for a remote-control client enrollment device-key proof.", - "type": "string", "enum": [ "remote_control_client_enrollment" - ] + ], + "type": "string" }, "RequestId": { "anyOf": [ @@ -4899,26 +3200,20 @@ "type": "string" }, { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } ] }, "ResponseItem": { "oneOf": [ { - "type": "object", - "required": [ - "content", - "role", - "type" - ], "properties": { "content": { - "type": "array", "items": { "$ref": "#/definitions/ContentItem" - } + }, + "type": "array" }, "end_turn": { "type": [ @@ -4927,11 +3222,11 @@ ] }, "id": { - "writeOnly": true, "type": [ "string", "null" - ] + ], + "writeOnly": true }, "phase": { "anyOf": [ @@ -4947,31 +3242,32 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "message" ], - "title": "MessageResponseItemType" + "title": "MessageResponseItemType", + "type": "string" } }, - "title": "MessageResponseItem" - }, - { - "type": "object", "required": [ - "summary", + "content", + "role", "type" ], + "title": "MessageResponseItem", + "type": "object" + }, + { "properties": { "content": { "default": null, + "items": { + "$ref": "#/definitions/ReasoningItemContent" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/ReasoningItemContent" - } + ] }, "encrypted_content": { "type": [ @@ -4980,28 +3276,27 @@ ] }, "summary": { - "type": "array", "items": { "$ref": "#/definitions/ReasoningItemReasoningSummary" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningResponseItemType" + "title": "ReasoningResponseItemType", + "type": "string" } }, - "title": "ReasoningResponseItem" - }, - { - "type": "object", "required": [ - "action", - "status", + "summary", "type" ], + "title": "ReasoningResponseItem", + "type": "object" + }, + { "properties": { "action": { "$ref": "#/definitions/LocalShellAction" @@ -5015,33 +3310,32 @@ }, "id": { "description": "Legacy id field retained for compatibility with older payloads.", - "writeOnly": true, "type": [ "string", "null" - ] + ], + "writeOnly": true }, "status": { "$ref": "#/definitions/LocalShellStatus" }, "type": { - "type": "string", "enum": [ "local_shell_call" ], - "title": "LocalShellCallResponseItemType" + "title": "LocalShellCallResponseItemType", + "type": "string" } }, - "title": "LocalShellCallResponseItem" - }, - { - "type": "object", "required": [ - "arguments", - "call_id", - "name", + "action", + "status", "type" ], + "title": "LocalShellCallResponseItem", + "type": "object" + }, + { "properties": { "arguments": { "type": "string" @@ -5050,11 +3344,11 @@ "type": "string" }, "id": { - "writeOnly": true, "type": [ "string", "null" - ] + ], + "writeOnly": true }, "name": { "type": "string" @@ -5066,22 +3360,23 @@ ] }, "type": { - "type": "string", "enum": [ "function_call" ], - "title": "FunctionCallResponseItemType" + "title": "FunctionCallResponseItemType", + "type": "string" } }, - "title": "FunctionCallResponseItem" - }, - { - "type": "object", "required": [ "arguments", - "execution", + "call_id", + "name", "type" ], + "title": "FunctionCallResponseItem", + "type": "object" + }, + { "properties": { "arguments": true, "call_id": { @@ -5094,11 +3389,11 @@ "type": "string" }, "id": { - "writeOnly": true, "type": [ "string", "null" - ] + ], + "writeOnly": true }, "status": { "type": [ @@ -5107,22 +3402,22 @@ ] }, "type": { - "type": "string", "enum": [ "tool_search_call" ], - "title": "ToolSearchCallResponseItemType" + "title": "ToolSearchCallResponseItemType", + "type": "string" } }, - "title": "ToolSearchCallResponseItem" - }, - { - "type": "object", "required": [ - "call_id", - "output", + "arguments", + "execution", "type" ], + "title": "ToolSearchCallResponseItem", + "type": "object" + }, + { "properties": { "call_id": { "type": "string" @@ -5131,33 +3426,32 @@ "$ref": "#/definitions/FunctionCallOutputBody" }, "type": { - "type": "string", "enum": [ "function_call_output" ], - "title": "FunctionCallOutputResponseItemType" + "title": "FunctionCallOutputResponseItemType", + "type": "string" } }, - "title": "FunctionCallOutputResponseItem" - }, - { - "type": "object", "required": [ "call_id", - "input", - "name", + "output", "type" ], + "title": "FunctionCallOutputResponseItem", + "type": "object" + }, + { "properties": { "call_id": { "type": "string" }, "id": { - "writeOnly": true, "type": [ "string", "null" - ] + ], + "writeOnly": true }, "input": { "type": "string" @@ -5172,22 +3466,23 @@ ] }, "type": { - "type": "string", "enum": [ "custom_tool_call" ], - "title": "CustomToolCallResponseItemType" + "title": "CustomToolCallResponseItemType", + "type": "string" } }, - "title": "CustomToolCallResponseItem" - }, - { - "type": "object", "required": [ "call_id", - "output", + "input", + "name", "type" ], + "title": "CustomToolCallResponseItem", + "type": "object" + }, + { "properties": { "call_id": { "type": "string" @@ -5202,23 +3497,22 @@ "$ref": "#/definitions/FunctionCallOutputBody" }, "type": { - "type": "string", "enum": [ "custom_tool_call_output" ], - "title": "CustomToolCallOutputResponseItemType" + "title": "CustomToolCallOutputResponseItemType", + "type": "string" } }, - "title": "CustomToolCallOutputResponseItem" - }, - { - "type": "object", "required": [ - "execution", - "status", - "tools", + "call_id", + "output", "type" ], + "title": "CustomToolCallOutputResponseItem", + "type": "object" + }, + { "properties": { "call_id": { "type": [ @@ -5233,24 +3527,27 @@ "type": "string" }, "tools": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "type": { - "type": "string", "enum": [ "tool_search_output" ], - "title": "ToolSearchOutputResponseItemType" + "title": "ToolSearchOutputResponseItemType", + "type": "string" } }, - "title": "ToolSearchOutputResponseItem" - }, - { - "type": "object", "required": [ + "execution", + "status", + "tools", "type" ], + "title": "ToolSearchOutputResponseItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -5263,11 +3560,11 @@ ] }, "id": { - "writeOnly": true, "type": [ "string", "null" - ] + ], + "writeOnly": true }, "status": { "type": [ @@ -5276,23 +3573,20 @@ ] }, "type": { - "type": "string", "enum": [ "web_search_call" ], - "title": "WebSearchCallResponseItemType" + "title": "WebSearchCallResponseItemType", + "type": "string" } }, - "title": "WebSearchCallResponseItem" - }, - { - "type": "object", "required": [ - "id", - "result", - "status", "type" ], + "title": "WebSearchCallResponseItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -5310,89 +3604,92 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "image_generation_call" ], - "title": "ImageGenerationCallResponseItemType" + "title": "ImageGenerationCallResponseItemType", + "type": "string" } }, - "title": "ImageGenerationCallResponseItem" - }, - { - "type": "object", "required": [ - "ghost_commit", + "id", + "result", + "status", "type" ], + "title": "ImageGenerationCallResponseItem", + "type": "object" + }, + { "properties": { "ghost_commit": { "$ref": "#/definitions/GhostCommit" }, "type": { - "type": "string", "enum": [ "ghost_snapshot" ], - "title": "GhostSnapshotResponseItemType" + "title": "GhostSnapshotResponseItemType", + "type": "string" } }, - "title": "GhostSnapshotResponseItem" - }, - { - "type": "object", "required": [ - "encrypted_content", + "ghost_commit", "type" ], + "title": "GhostSnapshotResponseItem", + "type": "object" + }, + { "properties": { "encrypted_content": { "type": "string" }, "type": { - "type": "string", "enum": [ "compaction" ], - "title": "CompactionResponseItemType" + "title": "CompactionResponseItemType", + "type": "string" } }, - "title": "CompactionResponseItem" - }, - { - "type": "object", "required": [ + "encrypted_content", "type" ], + "title": "CompactionResponseItem", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherResponseItemType" + "title": "OtherResponseItemType", + "type": "string" } }, - "title": "OtherResponseItem" + "required": [ + "type" + ], + "title": "OtherResponseItem", + "type": "object" } ] }, "ResponsesApiWebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -5401,27 +3698,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchResponsesApiWebSearchActionType" + "title": "SearchResponsesApiWebSearchActionType", + "type": "string" } }, - "title": "SearchResponsesApiWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchResponsesApiWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "open_page" ], - "title": "OpenPageResponsesApiWebSearchActionType" + "title": "OpenPageResponsesApiWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -5430,13 +3727,13 @@ ] } }, - "title": "OpenPageResponsesApiWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageResponsesApiWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -5445,11 +3742,11 @@ ] }, "type": { - "type": "string", "enum": [ "find_in_page" ], - "title": "FindInPageResponsesApiWebSearchActionType" + "title": "FindInPageResponsesApiWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -5458,43 +3755,40 @@ ] } }, - "title": "FindInPageResponsesApiWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageResponsesApiWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherResponsesApiWebSearchActionType" + "title": "OtherResponsesApiWebSearchActionType", + "type": "string" } }, - "title": "OtherResponsesApiWebSearchAction" + "required": [ + "type" + ], + "title": "OtherResponsesApiWebSearchAction", + "type": "object" } ] }, "ReviewDelivery": { - "type": "string", "enum": [ "inline", "detached" - ] + ], + "type": "string" }, "ReviewStartParams": { - "type": "object", - "required": [ - "target", - "threadId" - ], "properties": { "delivery": { - "description": "Where to run the review: inline (default) on the current thread or detached on a new thread (returned in `reviewThreadId`).", - "default": null, "anyOf": [ { "$ref": "#/definitions/ReviewDelivery" @@ -5502,7 +3796,9 @@ { "type": "null" } - ] + ], + "default": null, + "description": "Where to run the review: inline (default) on the current thread or detached on a new thread (returned in `reviewThreadId`)." }, "target": { "$ref": "#/definitions/ReviewTarget" @@ -5510,55 +3806,55 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "target", + "threadId" + ], + "type": "object" }, "ReviewTarget": { "oneOf": [ { "description": "Review the working tree: staged, unstaged, and untracked files.", - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "uncommittedChanges" ], - "title": "UncommittedChangesReviewTargetType" + "title": "UncommittedChangesReviewTargetType", + "type": "string" } }, - "title": "UncommittedChangesReviewTarget" + "required": [ + "type" + ], + "title": "UncommittedChangesReviewTarget", + "type": "object" }, { "description": "Review changes between the current branch and the given base branch.", - "type": "object", - "required": [ - "branch", - "type" - ], "properties": { "branch": { "type": "string" }, "type": { - "type": "string", "enum": [ "baseBranch" ], - "title": "BaseBranchReviewTargetType" + "title": "BaseBranchReviewTargetType", + "type": "string" } }, - "title": "BaseBranchReviewTarget" + "required": [ + "branch", + "type" + ], + "title": "BaseBranchReviewTarget", + "type": "object" }, { "description": "Review the changes introduced by a specific commit.", - "type": "object", - "required": [ - "sha", - "type" - ], "properties": { "sha": { "type": "string" @@ -5571,123 +3867,124 @@ ] }, "type": { - "type": "string", "enum": [ "commit" ], - "title": "CommitReviewTargetType" + "title": "CommitReviewTargetType", + "type": "string" } }, - "title": "CommitReviewTarget" + "required": [ + "sha", + "type" + ], + "title": "CommitReviewTarget", + "type": "object" }, { "description": "Arbitrary instructions, equivalent to the old free-form prompt.", - "type": "object", - "required": [ - "instructions", - "type" - ], "properties": { "instructions": { "type": "string" }, "type": { - "type": "string", "enum": [ "custom" ], - "title": "CustomReviewTargetType" + "title": "CustomReviewTargetType", + "type": "string" } }, - "title": "CustomReviewTarget" + "required": [ + "instructions", + "type" + ], + "title": "CustomReviewTarget", + "type": "object" } ] }, "SandboxMode": { - "type": "string", "enum": [ "read-only", "workspace-write", "danger-full-access" - ] + ], + "type": "string" }, "SandboxPolicy": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "dangerFullAccess" ], - "title": "DangerFullAccessSandboxPolicyType" + "title": "DangerFullAccessSandboxPolicyType", + "type": "string" } }, - "title": "DangerFullAccessSandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "DangerFullAccessSandboxPolicy", + "type": "object" + }, + { "properties": { "access": { - "default": { - "type": "fullAccess" - }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ] + ], + "default": { + "type": "fullAccess" + } }, "networkAccess": { "default": false, "type": "boolean" }, "type": { - "type": "string", "enum": [ "readOnly" ], - "title": "ReadOnlySandboxPolicyType" + "title": "ReadOnlySandboxPolicyType", + "type": "string" } }, - "title": "ReadOnlySandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "ReadOnlySandboxPolicy", + "type": "object" + }, + { "properties": { "networkAccess": { - "default": "restricted", "allOf": [ { "$ref": "#/definitions/NetworkAccess" } - ] + ], + "default": "restricted" }, "type": { - "type": "string", "enum": [ "externalSandbox" ], - "title": "ExternalSandboxSandboxPolicyType" + "title": "ExternalSandboxSandboxPolicyType", + "type": "string" } }, - "title": "ExternalSandboxSandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "ExternalSandboxSandboxPolicy", + "type": "object" + }, + { "properties": { "excludeSlashTmp": { "default": false, @@ -5702,58 +3999,58 @@ "type": "boolean" }, "readOnlyAccess": { - "default": { - "type": "fullAccess" - }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ] + ], + "default": { + "type": "fullAccess" + } }, "type": { - "type": "string", "enum": [ "workspaceWrite" ], - "title": "WorkspaceWriteSandboxPolicyType" + "title": "WorkspaceWriteSandboxPolicyType", + "type": "string" }, "writableRoots": { "default": [], - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" } }, - "title": "WorkspaceWriteSandboxPolicy" + "required": [ + "type" + ], + "title": "WorkspaceWriteSandboxPolicy", + "type": "object" } ] }, "SendAddCreditsNudgeEmailParams": { - "type": "object", - "required": [ - "creditType" - ], "properties": { "creditType": { "$ref": "#/definitions/AddCreditsNudgeCreditType" } - } + }, + "required": [ + "creditType" + ], + "type": "object" }, "ServiceTier": { - "type": "string", "enum": [ "fast", "flex" - ] + ], + "type": "string" }, "Settings": { "description": "Settings for a collaboration mode.", - "type": "object", - "required": [ - "model" - ], "properties": { "developer_instructions": { "type": [ @@ -5774,28 +4071,28 @@ } ] } - } + }, + "required": [ + "model" + ], + "type": "object" }, "SortDirection": { - "type": "string", "enum": [ "asc", "desc" - ] + ], + "type": "string" }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -5804,14 +4101,13 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "ThreadApproveGuardianDeniedActionParams": { - "type": "object", - "required": [ - "event", - "threadId" - ], "properties": { "event": { "description": "Serialized `codex_protocol::protocol::GuardianAssessmentEvent`." @@ -5819,137 +4115,47 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "event", + "threadId" + ], + "type": "object" }, "ThreadArchiveParams": { - "type": "object", + "properties": { + "threadId": { + "type": "string" + } + }, "required": [ "threadId" ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "TurnInterruptParams": { - "type": "object", - "required": [ - "threadId", - "turnId" - ], - "properties": { - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } + "type": "object" }, "ThreadCompactStartParams": { - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" } - } - }, - "TurnEnvironmentParams": { - "type": "object", - "required": [ - "cwd", - "environmentId" - ], - "properties": { - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "environmentId": { - "type": "string" - } - } - }, - "ThreadUnsubscribeParams": { - "type": "object", + }, "required": [ "threadId" ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadUnarchiveParams": { - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadTurnsListParams": { - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "cursor": { - "description": "Opaque cursor to pass to the next call to continue after the last turn.", - "type": [ - "string", - "null" - ] - }, - "limit": { - "description": "Optional turn page size.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "sortDirection": { - "description": "Optional turn pagination direction; defaults to descending.", - "anyOf": [ - { - "$ref": "#/definitions/SortDirection" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - } - } + "type": "object" }, "ThreadEpiphanyGraphQuery": { - "type": "object", - "required": [ - "kind" - ], "properties": { "depth": { "description": "Defaults to 1 and is capped by the server.", + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "direction": { - "description": "Defaults to `both`.", "anyOf": [ { "$ref": "#/definitions/ThreadEpiphanyGraphQueryDirection" @@ -5957,19 +4163,20 @@ { "type": "null" } - ] + ], + "description": "Defaults to `both`." }, "edgeIds": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "edgeKinds": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includeLinks": { "description": "Defaults to true so neighborhood queries preserve dataflow/architecture joins.", @@ -5982,529 +4189,47 @@ "$ref": "#/definitions/ThreadEpiphanyGraphQueryKind" }, "nodeIds": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "symbols": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "ThreadEpiphanyGraphQueryDirection": { - "type": "string", "enum": [ "incoming", "outgoing", "both" - ] + ], + "type": "string" }, "ThreadEpiphanyGraphQueryKind": { - "type": "string", "enum": [ "node", "path", "frontierNeighborhood", "neighbors" - ] - }, - "ThreadStartSource": { - "type": "string", - "enum": [ - "startup", - "clear" - ] - }, - "ThreadStartParams": { - "type": "object", - "properties": { - "approvalPolicy": { - "anyOf": [ - { - "$ref": "#/definitions/AskForApproval" - }, - { - "type": "null" - } - ] - }, - "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this thread and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - }, - { - "type": "null" - } - ] - }, - "baseInstructions": { - "type": [ - "string", - "null" - ] - }, - "config": { - "type": [ - "object", - "null" - ], - "additionalProperties": true - }, - "cwd": { - "type": [ - "string", - "null" - ] - }, - "developerInstructions": { - "type": [ - "string", - "null" - ] - }, - "serviceTier": { - "anyOf": [ - { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - { - "type": "null" - } - ] - }, - "ephemeral": { - "type": [ - "boolean", - "null" - ] - }, - "sandbox": { - "anyOf": [ - { - "$ref": "#/definitions/SandboxMode" - }, - { - "type": "null" - } - ] - }, - "sessionStartSource": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadStartSource" - }, - { - "type": "null" - } - ] - }, - "model": { - "type": [ - "string", - "null" - ] - }, - "modelProvider": { - "type": [ - "string", - "null" - ] - }, - "permissionProfile": { - "description": "Full permissions override for this thread. Cannot be combined with `sandbox`.", - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "serviceName": { - "type": [ - "string", - "null" - ] - }, - "personality": { - "anyOf": [ - { - "$ref": "#/definitions/Personality" - }, - { - "type": "null" - } - ] - } - } - }, - "ThreadSourceKind": { - "type": "string", - "enum": [ - "cli", - "vscode", - "exec", - "appServer", - "subAgent", - "subAgentReview", - "subAgentCompact", - "subAgentThreadSpawn", - "subAgentOther", - "unknown" - ] - }, - "ThreadSortKey": { - "type": "string", - "enum": [ - "created_at", - "updated_at" - ] - }, - "ThreadShellCommandParams": { - "type": "object", - "required": [ - "command", - "threadId" ], - "properties": { - "command": { - "description": "Shell command string evaluated by the thread's configured shell. Unlike `command/exec`, this intentionally preserves shell syntax such as pipes, redirects, and quoting. This runs unsandboxed with full access rather than inheriting the thread sandbox policy.", - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadSetNameParams": { - "type": "object", - "required": [ - "name", - "threadId" - ], - "properties": { - "name": { - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRollbackParams": { - "type": "object", - "required": [ - "numTurns", - "threadId" - ], - "properties": { - "numTurns": { - "description": "The number of turns to drop from the end of the thread. Must be >= 1.\n\nThis only modifies the thread's history and does not revert local file changes that have been made by the agent. Clients are responsible for reverting these changes.", - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadResumeParams": { - "description": "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "approvalPolicy": { - "anyOf": [ - { - "$ref": "#/definitions/AskForApproval" - }, - { - "type": "null" - } - ] - }, - "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this thread and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - }, - { - "type": "null" - } - ] - }, - "baseInstructions": { - "type": [ - "string", - "null" - ] - }, - "config": { - "type": [ - "object", - "null" - ], - "additionalProperties": true - }, - "cwd": { - "type": [ - "string", - "null" - ] - }, - "developerInstructions": { - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - }, - "model": { - "description": "Configuration overrides for the resumed thread, if any.", - "type": [ - "string", - "null" - ] - }, - "modelProvider": { - "type": [ - "string", - "null" - ] - }, - "sandbox": { - "anyOf": [ - { - "$ref": "#/definitions/SandboxMode" - }, - { - "type": "null" - } - ] - }, - "permissionProfile": { - "description": "Full permissions override for the resumed thread. Cannot be combined with `sandbox`.", - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "serviceTier": { - "anyOf": [ - { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - { - "type": "null" - } - ] - }, - "personality": { - "anyOf": [ - { - "$ref": "#/definitions/Personality" - }, - { - "type": "null" - } - ] - } - } - }, - "ThreadListParams": { - "type": "object", - "properties": { - "archived": { - "description": "Optional archived filter; when set to true, only archived threads are returned. If false or null, only non-archived threads are returned.", - "type": [ - "boolean", - "null" - ] - }, - "cursor": { - "description": "Opaque pagination cursor returned by a previous call.", - "type": [ - "string", - "null" - ] - }, - "cwd": { - "description": "Optional cwd filter or filters; when set, only threads whose session cwd exactly matches one of these paths are returned.", - "anyOf": [ - { - "$ref": "#/definitions/ThreadListCwdFilter" - }, - { - "type": "null" - } - ] - }, - "limit": { - "description": "Optional page size; defaults to a reasonable server-side value.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "modelProviders": { - "description": "Optional provider filter; when set, only sessions recorded under these providers are returned. When present but empty, includes all providers.", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "searchTerm": { - "description": "Optional substring filter for the extracted thread title.", - "type": [ - "string", - "null" - ] - }, - "sortDirection": { - "description": "Optional sort direction; defaults to descending (newest first).", - "anyOf": [ - { - "$ref": "#/definitions/SortDirection" - }, - { - "type": "null" - } - ] - }, - "sortKey": { - "description": "Optional sort key; defaults to created_at.", - "anyOf": [ - { - "$ref": "#/definitions/ThreadSortKey" - }, - { - "type": "null" - } - ] - }, - "sourceKinds": { - "description": "Optional source filter; when set, only sessions from these source kinds are returned. When omitted or empty, defaults to interactive sources.", - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/ThreadSourceKind" - } - }, - "useStateDbOnly": { - "description": "If true, return from the state DB without scanning JSONL rollouts to repair thread metadata. Omitted or false preserves scan-and-repair behavior.", - "type": "boolean" - } - } - }, - "ThreadRealtimeStartTransport": { - "description": "EXPERIMENTAL - transport used by thread realtime.", - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "websocket" - ], - "title": "WebsocketThreadRealtimeStartTransportType" - } - }, - "title": "WebsocketThreadRealtimeStartTransport" - }, - { - "type": "object", - "required": [ - "sdp", - "type" - ], - "properties": { - "sdp": { - "description": "SDP offer generated by a WebRTC RTCPeerConnection after configuring audio and the realtime events data channel.", - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "webrtc" - ], - "title": "WebrtcThreadRealtimeStartTransportType" - } - }, - "title": "WebrtcThreadRealtimeStartTransport" - } - ] - }, - "ThreadLoadedListParams": { - "type": "object", - "properties": { - "cursor": { - "description": "Opaque pagination cursor returned by a previous call.", - "type": [ - "string", - "null" - ] - }, - "limit": { - "description": "Optional page size; defaults to no limit.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - } - } + "type": "string" }, "ThreadEpiphanyRoleId": { - "type": "string", "enum": [ "implementation", "imagination", @@ -6512,83 +4237,16 @@ "modeling", "verification", "reorientation" - ] - }, - "ThreadMemoryMode": { - "type": "string", - "enum": [ - "enabled", - "disabled" - ] - }, - "ThreadRealtimeAudioChunk": { - "description": "EXPERIMENTAL - thread realtime audio chunk.", - "type": "object", - "required": [ - "data", - "numChannels", - "sampleRate" ], - "properties": { - "data": { - "type": "string" - }, - "itemId": { - "type": [ - "string", - "null" - ] - }, - "numChannels": { - "type": "integer", - "format": "uint16", - "minimum": 0.0 - }, - "sampleRate": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "samplesPerChannel": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ThreadMetadataUpdateParams": { - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "gitInfo": { - "description": "Patch the stored Git metadata for this thread. Omit a field to leave it unchanged, set it to `null` to clear it, or provide a string to replace the stored value.", - "anyOf": [ - { - "$ref": "#/definitions/ThreadMetadataGitInfoUpdateParams" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - } - } + "type": "string" }, "ThreadEpiphanyUpdatePatch": { - "type": "object", "properties": { "acceptanceReceipts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } + }, + "type": "array" }, "activeSubgoalId": { "type": [ @@ -6607,10 +4265,10 @@ ] }, "evidence": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - } + }, + "type": "array" }, "graphCheckpoint": { "anyOf": [ @@ -6643,13 +4301,13 @@ ] }, "invariants": { + "items": { + "$ref": "#/definitions/EpiphanyInvariant" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/EpiphanyInvariant" - } + ] }, "investigationCheckpoint": { "anyOf": [ @@ -6662,13 +4320,13 @@ ] }, "jobBindings": { + "items": { + "$ref": "#/definitions/EpiphanyJobBinding" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/EpiphanyJobBinding" - } + ] }, "mode": { "anyOf": [ @@ -6687,10 +4345,10 @@ ] }, "observations": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - } + }, + "type": "array" }, "planning": { "anyOf": [ @@ -6703,10 +4361,10 @@ ] }, "runtimeLinks": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - } + }, + "type": "array" }, "scratch": { "anyOf": [ @@ -6719,18 +4377,18 @@ ] }, "subgoals": { + "items": { + "$ref": "#/definitions/EpiphanySubgoal" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/EpiphanySubgoal" - } + ] } - } + }, + "type": "object" }, "ThreadEpiphanyViewLens": { - "type": "string", "enum": [ "scene", "jobs", @@ -6740,340 +4398,11 @@ "reorient", "crrc", "coordinator" - ] - }, - "ThreadMetadataGitInfoUpdateParams": { - "type": "object", - "properties": { - "branch": { - "description": "Omit to leave the stored branch unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", - "type": [ - "string", - "null" - ] - }, - "originUrl": { - "description": "Omit to leave the stored origin URL unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", - "type": [ - "string", - "null" - ] - }, - "sha": { - "description": "Omit to leave the stored commit unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanyWorkerLaunchDocument": { - "oneOf": [ - { - "type": "object", - "required": [ - "documentKind", - "roleId", - "stateRevision", - "threadId" - ], - "properties": { - "activeGraphNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "activeSubgoalId": { - "type": [ - "string", - "null" - ] - }, - "activeSubgoals": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanySubgoal" - } - }, - "churn": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyChurnState" - }, - { - "type": "null" - } - ] - }, - "documentKind": { - "type": "string", - "enum": [ - "role" - ] - }, - "graphCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphCheckpoint" - }, - { - "type": "null" - } - ] - }, - "graphFrontier": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphFrontier" - }, - { - "type": "null" - } - ] - }, - "graphs": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphs" - }, - { - "type": "null" - } - ] - }, - "invariants": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyInvariant" - } - }, - "investigationCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "objective": { - "type": [ - "string", - "null" - ] - }, - "planning": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyPlanningState" - }, - { - "type": "null" - } - ] - }, - "recentEvidence": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyEvidenceRecord" - } - }, - "recentObservations": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyObservation" - } - }, - "roleId": { - "type": "string" - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "stateRevision": { - "type": "integer", - "format": "uint64", - "minimum": 0.0 - }, - "threadId": { - "type": "string" - } - } - }, - { - "type": "object", - "required": [ - "checkpointDisposition", - "checkpointId", - "checkpointKind", - "checkpointNextAction", - "decisionNote", - "documentKind", - "graphStatus", - "mode", - "pressureLevel", - "retrievalStatus", - "threadId", - "watcherStatus" - ], - "properties": { - "activeFrontierNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointChangedPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointCodeRefs": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyCodeRef" - } - }, - "checkpointDirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointDisposition": { - "type": "string" - }, - "checkpointEvidenceIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointFocus": { - "type": [ - "string", - "null" - ] - }, - "checkpointId": { - "type": "string" - }, - "checkpointKind": { - "type": "string" - }, - "checkpointNextAction": { - "type": "string" - }, - "checkpointOpenQuestions": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointSummary": { - "type": [ - "string", - "null" - ] - }, - "decisionNote": { - "type": "string" - }, - "decisionReasons": { - "type": "array", - "items": { - "type": "string" - } - }, - "documentKind": { - "type": "string", - "enum": [ - "reorient" - ] - }, - "graphStatus": { - "type": "string" - }, - "graphs": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphs" - }, - { - "type": "null" - } - ] - }, - "linkedGraphNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "linkedSubgoalIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "mode": { - "type": "string" - }, - "pressureLevel": { - "type": "string" - }, - "recentEvidence": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyEvidenceRecord" - } - }, - "recentObservations": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyObservation" - } - }, - "retrievalStatus": { - "type": "string" - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - }, - "watcherStatus": { - "type": "string" - } - } - } - ] + ], + "type": "string" }, "ThreadForkParams": { "description": "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", - "type": "object", - "required": [ - "threadId" - ], "properties": { "approvalPolicy": { "anyOf": [ @@ -7086,7 +4415,6 @@ ] }, "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this thread and subsequent turns.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -7094,7 +4422,8 @@ { "type": "null" } - ] + ], + "description": "Override where approval requests are routed for review on this thread and subsequent turns." }, "baseInstructions": { "type": [ @@ -7103,11 +4432,11 @@ ] }, "config": { + "additionalProperties": true, "type": [ "object", "null" - ], - "additionalProperties": true + ] }, "cwd": { "type": [ @@ -7137,6 +4466,27 @@ "null" ] }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Full permissions override for the forked thread. Cannot be combined with `sandbox`." + }, + "sandbox": { + "anyOf": [ + { + "$ref": "#/definitions/SandboxMode" + }, + { + "type": "null" + } + ] + }, "serviceTier": { "anyOf": [ { @@ -7154,8 +4504,372 @@ } ] }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "type": "object" + }, + "ThreadInjectItemsParams": { + "properties": { + "items": { + "description": "Raw Responses API items to append to the thread's model-visible history.", + "items": true, + "type": "array" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "items", + "threadId" + ], + "type": "object" + }, + "ThreadListCwdFilter": { + "anyOf": [ + { + "type": "string" + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + }, + "ThreadListParams": { + "properties": { + "archived": { + "description": "Optional archived filter; when set to true, only archived threads are returned. If false or null, only non-archived threads are returned.", + "type": [ + "boolean", + "null" + ] + }, + "cursor": { + "description": "Opaque pagination cursor returned by a previous call.", + "type": [ + "string", + "null" + ] + }, + "cwd": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadListCwdFilter" + }, + { + "type": "null" + } + ], + "description": "Optional cwd filter or filters; when set, only threads whose session cwd exactly matches one of these paths are returned." + }, + "limit": { + "description": "Optional page size; defaults to a reasonable server-side value.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "modelProviders": { + "description": "Optional provider filter; when set, only sessions recorded under these providers are returned. When present but empty, includes all providers.", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "searchTerm": { + "description": "Optional substring filter for the extracted thread title.", + "type": [ + "string", + "null" + ] + }, + "sortDirection": { + "anyOf": [ + { + "$ref": "#/definitions/SortDirection" + }, + { + "type": "null" + } + ], + "description": "Optional sort direction; defaults to descending (newest first)." + }, + "sortKey": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadSortKey" + }, + { + "type": "null" + } + ], + "description": "Optional sort key; defaults to created_at." + }, + "sourceKinds": { + "description": "Optional source filter; when set, only sessions from these source kinds are returned. When omitted or empty, defaults to interactive sources.", + "items": { + "$ref": "#/definitions/ThreadSourceKind" + }, + "type": [ + "array", + "null" + ] + }, + "useStateDbOnly": { + "description": "If true, return from the state DB without scanning JSONL rollouts to repair thread metadata. Omitted or false preserves scan-and-repair behavior.", + "type": "boolean" + } + }, + "type": "object" + }, + "ThreadLoadedListParams": { + "properties": { + "cursor": { + "description": "Opaque pagination cursor returned by a previous call.", + "type": [ + "string", + "null" + ] + }, + "limit": { + "description": "Optional page size; defaults to no limit.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + }, + "ThreadMemoryMode": { + "enum": [ + "enabled", + "disabled" + ], + "type": "string" + }, + "ThreadMetadataGitInfoUpdateParams": { + "properties": { + "branch": { + "description": "Omit to leave the stored branch unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", + "type": [ + "string", + "null" + ] + }, + "originUrl": { + "description": "Omit to leave the stored origin URL unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", + "type": [ + "string", + "null" + ] + }, + "sha": { + "description": "Omit to leave the stored commit unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "ThreadMetadataUpdateParams": { + "properties": { + "gitInfo": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadMetadataGitInfoUpdateParams" + }, + { + "type": "null" + } + ], + "description": "Patch the stored Git metadata for this thread. Omit a field to leave it unchanged, set it to `null` to clear it, or provide a string to replace the stored value." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "type": "object" + }, + "ThreadReadParams": { + "properties": { + "includeTurns": { + "default": false, + "description": "When true, include turns and their items from rollout history.", + "type": "boolean" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "type": "object" + }, + "ThreadRealtimeAudioChunk": { + "description": "EXPERIMENTAL - thread realtime audio chunk.", + "properties": { + "data": { + "type": "string" + }, + "itemId": { + "type": [ + "string", + "null" + ] + }, + "numChannels": { + "format": "uint16", + "minimum": 0.0, + "type": "integer" + }, + "sampleRate": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "samplesPerChannel": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "data", + "numChannels", + "sampleRate" + ], + "type": "object" + }, + "ThreadRealtimeStartTransport": { + "description": "EXPERIMENTAL - transport used by thread realtime.", + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "websocket" + ], + "title": "WebsocketThreadRealtimeStartTransportType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "WebsocketThreadRealtimeStartTransport", + "type": "object" + }, + { + "properties": { + "sdp": { + "description": "SDP offer generated by a WebRTC RTCPeerConnection after configuring audio and the realtime events data channel.", + "type": "string" + }, + "type": { + "enum": [ + "webrtc" + ], + "title": "WebrtcThreadRealtimeStartTransportType", + "type": "string" + } + }, + "required": [ + "sdp", + "type" + ], + "title": "WebrtcThreadRealtimeStartTransport", + "type": "object" + } + ] + }, + "ThreadResumeParams": { + "description": "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", + "properties": { + "approvalPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/AskForApproval" + }, + { + "type": "null" + } + ] + }, + "approvalsReviewer": { + "anyOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + }, + { + "type": "null" + } + ], + "description": "Override where approval requests are routed for review on this thread and subsequent turns." + }, + "baseInstructions": { + "type": [ + "string", + "null" + ] + }, + "config": { + "additionalProperties": true, + "type": [ + "object", + "null" + ] + }, + "cwd": { + "type": [ + "string", + "null" + ] + }, + "developerInstructions": { + "type": [ + "string", + "null" + ] + }, + "model": { + "description": "Configuration overrides for the resumed thread, if any.", + "type": [ + "string", + "null" + ] + }, + "modelProvider": { + "type": [ + "string", + "null" + ] + }, "permissionProfile": { - "description": "Full permissions override for the forked thread. Cannot be combined with `sandbox`.", "anyOf": [ { "$ref": "#/definitions/PermissionProfile" @@ -7163,10 +4877,18 @@ { "type": "null" } - ] + ], + "description": "Full permissions override for the resumed thread. Cannot be combined with `sandbox`." }, - "threadId": { - "type": "string" + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/Personality" + }, + { + "type": "null" + } + ] }, "sandbox": { "anyOf": [ @@ -7177,54 +4899,2032 @@ "type": "null" } ] - } - } - }, - "ThreadReadParams": { - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "includeTurns": { - "description": "When true, include turns and their items from rollout history.", - "default": false, - "type": "boolean" + }, + "serviceTier": { + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "type": "null" + } + ] }, "threadId": { "type": "string" } - } - }, - "ThreadInjectItemsParams": { - "type": "object", + }, "required": [ - "items", "threadId" ], + "type": "object" + }, + "ThreadRollbackParams": { "properties": { - "items": { - "description": "Raw Responses API items to append to the thread's model-visible history.", - "type": "array", - "items": true + "numTurns": { + "description": "The number of turns to drop from the end of the thread. Must be >= 1.\n\nThis only modifies the thread's history and does not revert local file changes that have been made by the agent. Clients are responsible for reverting these changes.", + "format": "uint32", + "minimum": 0.0, + "type": "integer" }, "threadId": { "type": "string" } - } + }, + "required": [ + "numTurns", + "threadId" + ], + "type": "object" }, - "ThreadListCwdFilter": { - "anyOf": [ - { + "ThreadSetNameParams": { + "properties": { + "name": { "type": "string" }, - { - "type": "array", + "threadId": { + "type": "string" + } + }, + "required": [ + "name", + "threadId" + ], + "type": "object" + }, + "ThreadShellCommandParams": { + "properties": { + "command": { + "description": "Shell command string evaluated by the thread's configured shell. Unlike `command/exec`, this intentionally preserves shell syntax such as pipes, redirects, and quoting. This runs unsandboxed with full access rather than inheriting the thread sandbox policy.", + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "command", + "threadId" + ], + "type": "object" + }, + "ThreadSortKey": { + "enum": [ + "created_at", + "updated_at" + ], + "type": "string" + }, + "ThreadSourceKind": { + "enum": [ + "cli", + "vscode", + "exec", + "appServer", + "subAgent", + "subAgentReview", + "subAgentCompact", + "subAgentThreadSpawn", + "subAgentOther", + "unknown" + ], + "type": "string" + }, + "ThreadStartParams": { + "properties": { + "approvalPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/AskForApproval" + }, + { + "type": "null" + } + ] + }, + "approvalsReviewer": { + "anyOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + }, + { + "type": "null" + } + ], + "description": "Override where approval requests are routed for review on this thread and subsequent turns." + }, + "baseInstructions": { + "type": [ + "string", + "null" + ] + }, + "config": { + "additionalProperties": true, + "type": [ + "object", + "null" + ] + }, + "cwd": { + "type": [ + "string", + "null" + ] + }, + "developerInstructions": { + "type": [ + "string", + "null" + ] + }, + "ephemeral": { + "type": [ + "boolean", + "null" + ] + }, + "model": { + "type": [ + "string", + "null" + ] + }, + "modelProvider": { + "type": [ + "string", + "null" + ] + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Full permissions override for this thread. Cannot be combined with `sandbox`." + }, + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/Personality" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "anyOf": [ + { + "$ref": "#/definitions/SandboxMode" + }, + { + "type": "null" + } + ] + }, + "serviceName": { + "type": [ + "string", + "null" + ] + }, + "serviceTier": { + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "type": "null" + } + ] + }, + "sessionStartSource": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadStartSource" + }, + { + "type": "null" + } + ] + } + }, + "type": "object" + }, + "ThreadStartSource": { + "enum": [ + "startup", + "clear" + ], + "type": "string" + }, + "ThreadTurnsListParams": { + "properties": { + "cursor": { + "description": "Opaque cursor to pass to the next call to continue after the last turn.", + "type": [ + "string", + "null" + ] + }, + "limit": { + "description": "Optional turn page size.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "sortDirection": { + "anyOf": [ + { + "$ref": "#/definitions/SortDirection" + }, + { + "type": "null" + } + ], + "description": "Optional turn pagination direction; defaults to descending." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "type": "object" + }, + "ThreadUnarchiveParams": { + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "type": "object" + }, + "ThreadUnsubscribeParams": { + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "type": "object" + }, + "TurnEnvironmentParams": { + "properties": { + "cwd": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "environmentId": { + "type": "string" + } + }, + "required": [ + "cwd", + "environmentId" + ], + "type": "object" + }, + "TurnInterruptParams": { + "properties": { + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "threadId", + "turnId" + ], + "type": "object" + }, + "TurnStartParams": { + "properties": { + "approvalPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/AskForApproval" + }, + { + "type": "null" + } + ], + "description": "Override the approval policy for this turn and subsequent turns." + }, + "approvalsReviewer": { + "anyOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + }, + { + "type": "null" + } + ], + "description": "Override where approval requests are routed for review on this turn and subsequent turns." + }, + "cwd": { + "description": "Override the working directory for this turn and subsequent turns.", + "type": [ + "string", + "null" + ] + }, + "effort": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningEffort" + }, + { + "type": "null" + } + ], + "description": "Override the reasoning effort for this turn and subsequent turns." + }, + "input": { "items": { - "type": "string" - } + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "model": { + "description": "Override the model for this turn and subsequent turns.", + "type": [ + "string", + "null" + ] + }, + "outputSchema": { + "description": "Optional JSON Schema used to constrain the final assistant message for this turn." + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Override the full permissions profile for this turn and subsequent turns. Cannot be combined with `sandboxPolicy`." + }, + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/Personality" + }, + { + "type": "null" + } + ], + "description": "Override the personality for this turn and subsequent turns." + }, + "sandboxPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/SandboxPolicy" + }, + { + "type": "null" + } + ], + "description": "Override the sandbox policy for this turn and subsequent turns." + }, + "serviceTier": { + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "type": "null" + } + ], + "description": "Override the service tier for this turn and subsequent turns." + }, + "summary": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningSummary" + }, + { + "type": "null" + } + ], + "description": "Override the reasoning summary for this turn and subsequent turns." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "input", + "threadId" + ], + "type": "object" + }, + "TurnSteerParams": { + "properties": { + "expectedTurnId": { + "description": "Required active turn id precondition. The request fails when it does not match the currently active turn.", + "type": "string" + }, + "input": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "expectedTurnId", + "input", + "threadId" + ], + "type": "object" + }, + "UserInput": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "text_elements": { + "default": [], + "description": "UI-defined spans within `text` used to render or persist special elements.", + "items": { + "$ref": "#/definitions/TextElement" + }, + "type": "array" + }, + "type": { + "enum": [ + "text" + ], + "title": "TextUserInputType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "image" + ], + "title": "ImageUserInputType", + "type": "string" + }, + "url": { + "type": "string" + } + }, + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" + }, + { + "properties": { + "path": { + "type": "string" + }, + "type": { + "enum": [ + "localImage" + ], + "title": "LocalImageUserInputType", + "type": "string" + } + }, + "required": [ + "path", + "type" + ], + "title": "LocalImageUserInput", + "type": "object" + }, + { + "properties": { + "name": { + "type": "string" + }, + "path": { + "type": "string" + }, + "type": { + "enum": [ + "mention" + ], + "title": "MentionUserInputType", + "type": "string" + } + }, + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] + }, + "WindowsSandboxSetupMode": { + "enum": [ + "elevated", + "unelevated" + ], + "type": "string" + }, + "WindowsSandboxSetupStartParams": { + "properties": { + "cwd": { + "anyOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + }, + { + "type": "null" + } + ] + }, + "mode": { + "$ref": "#/definitions/WindowsSandboxSetupMode" + } + }, + "required": [ + "mode" + ], + "type": "object" } - } -} + }, + "description": "Request from the client to the server.", + "oneOf": [ + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "initialize" + ], + "title": "InitializeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/InitializeParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "InitializeRequest", + "type": "object" + }, + { + "description": "NEW APIs", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/start" + ], + "title": "Thread/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/resume" + ], + "title": "Thread/resumeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadResumeParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/resumeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/fork" + ], + "title": "Thread/forkRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadForkParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/forkRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/archive" + ], + "title": "Thread/archiveRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadArchiveParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/archiveRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/unsubscribe" + ], + "title": "Thread/unsubscribeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadUnsubscribeParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/unsubscribeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/name/set" + ], + "title": "Thread/name/setRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadSetNameParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/name/setRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/metadata/update" + ], + "title": "Thread/metadata/updateRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadMetadataUpdateParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/metadata/updateRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/unarchive" + ], + "title": "Thread/unarchiveRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadUnarchiveParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/unarchiveRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/compact/start" + ], + "title": "Thread/compact/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadCompactStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/compact/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/shellCommand" + ], + "title": "Thread/shellCommandRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadShellCommandParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/shellCommandRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/approveGuardianDeniedAction" + ], + "title": "Thread/approveGuardianDeniedActionRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadApproveGuardianDeniedActionParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/approveGuardianDeniedActionRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/rollback" + ], + "title": "Thread/rollbackRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRollbackParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/rollbackRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/list" + ], + "title": "Thread/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/loaded/list" + ], + "title": "Thread/loaded/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadLoadedListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/loaded/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/read" + ], + "title": "Thread/readRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadReadParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/turns/list" + ], + "title": "Thread/turns/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadTurnsListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/turns/listRequest", + "type": "object" + }, + { + "description": "Append raw Responses API items to the thread history without starting a user turn.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/inject_items" + ], + "title": "Thread/injectItemsRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadInjectItemsParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/injectItemsRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "device/key/create" + ], + "title": "Device/key/createRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/DeviceKeyCreateParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Device/key/createRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "device/key/public" + ], + "title": "Device/key/publicRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/DeviceKeyPublicParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Device/key/publicRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "device/key/sign" + ], + "title": "Device/key/signRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/DeviceKeySignParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Device/key/signRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/readFile" + ], + "title": "Fs/readFileRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsReadFileParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/readFileRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/writeFile" + ], + "title": "Fs/writeFileRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsWriteFileParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/writeFileRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/createDirectory" + ], + "title": "Fs/createDirectoryRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsCreateDirectoryParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/createDirectoryRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/getMetadata" + ], + "title": "Fs/getMetadataRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsGetMetadataParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/getMetadataRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/readDirectory" + ], + "title": "Fs/readDirectoryRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsReadDirectoryParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/readDirectoryRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/remove" + ], + "title": "Fs/removeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsRemoveParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/removeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/copy" + ], + "title": "Fs/copyRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsCopyParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/copyRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/watch" + ], + "title": "Fs/watchRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsWatchParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/watchRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/unwatch" + ], + "title": "Fs/unwatchRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsUnwatchParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/unwatchRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "turn/start" + ], + "title": "Turn/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Turn/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "turn/steer" + ], + "title": "Turn/steerRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnSteerParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Turn/steerRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "turn/interrupt" + ], + "title": "Turn/interruptRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnInterruptParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Turn/interruptRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "review/start" + ], + "title": "Review/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ReviewStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Review/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "model/list" + ], + "title": "Model/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ModelListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Model/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "experimentalFeature/list" + ], + "title": "ExperimentalFeature/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ExperimentalFeatureListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "ExperimentalFeature/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "experimentalFeature/enablement/set" + ], + "title": "ExperimentalFeature/enablement/setRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ExperimentalFeatureEnablementSetParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "ExperimentalFeature/enablement/setRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "mcpServer/oauth/login" + ], + "title": "McpServer/oauth/loginRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpServerOauthLoginParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServer/oauth/loginRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "config/mcpServer/reload" + ], + "title": "Config/mcpServer/reloadRequestMethod", + "type": "string" + }, + "params": { + "type": "null" + } + }, + "required": [ + "id", + "method" + ], + "title": "Config/mcpServer/reloadRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "mcpServerStatus/list" + ], + "title": "McpServerStatus/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ListMcpServerStatusParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServerStatus/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "mcpServer/resource/read" + ], + "title": "McpServer/resource/readRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpResourceReadParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServer/resource/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "mcpServer/tool/call" + ], + "title": "McpServer/tool/callRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpServerToolCallParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServer/tool/callRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "windowsSandbox/setupStart" + ], + "title": "WindowsSandbox/setupStartRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/WindowsSandboxSetupStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "WindowsSandbox/setupStartRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/login/start" + ], + "title": "Account/login/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/LoginAccountParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/login/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/login/cancel" + ], + "title": "Account/login/cancelRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CancelLoginAccountParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/login/cancelRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/logout" + ], + "title": "Account/logoutRequestMethod", + "type": "string" + }, + "params": { + "type": "null" + } + }, + "required": [ + "id", + "method" + ], + "title": "Account/logoutRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/rateLimits/read" + ], + "title": "Account/rateLimits/readRequestMethod", + "type": "string" + }, + "params": { + "type": "null" + } + }, + "required": [ + "id", + "method" + ], + "title": "Account/rateLimits/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/sendAddCreditsNudgeEmail" + ], + "title": "Account/sendAddCreditsNudgeEmailRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/SendAddCreditsNudgeEmailParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/sendAddCreditsNudgeEmailRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "feedback/upload" + ], + "title": "Feedback/uploadRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FeedbackUploadParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Feedback/uploadRequest", + "type": "object" + }, + { + "description": "Execute a standalone command (argv vector) under the server's sandbox.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "command/exec" + ], + "title": "Command/execRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Command/execRequest", + "type": "object" + }, + { + "description": "Write stdin bytes to a running `command/exec` session or close stdin.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "command/exec/write" + ], + "title": "Command/exec/writeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecWriteParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Command/exec/writeRequest", + "type": "object" + }, + { + "description": "Terminate a running `command/exec` session by client-supplied `processId`.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "command/exec/terminate" + ], + "title": "Command/exec/terminateRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecTerminateParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Command/exec/terminateRequest", + "type": "object" + }, + { + "description": "Resize a running PTY-backed `command/exec` session by client-supplied `processId`.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "command/exec/resize" + ], + "title": "Command/exec/resizeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecResizeParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Command/exec/resizeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "config/read" + ], + "title": "Config/readRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ConfigReadParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Config/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "config/value/write" + ], + "title": "Config/value/writeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ConfigValueWriteParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Config/value/writeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "config/batchWrite" + ], + "title": "Config/batchWriteRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ConfigBatchWriteParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Config/batchWriteRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "configRequirements/read" + ], + "title": "ConfigRequirements/readRequestMethod", + "type": "string" + }, + "params": { + "type": "null" + } + }, + "required": [ + "id", + "method" + ], + "title": "ConfigRequirements/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/read" + ], + "title": "Account/readRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/GetAccountParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fuzzyFileSearch" + ], + "title": "FuzzyFileSearchRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FuzzyFileSearchParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "FuzzyFileSearchRequest", + "type": "object" + } + ], + "title": "ClientRequest" +} \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalParams.json index e0fa2766..3968da2a 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalParams.json @@ -1,143 +1,51 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecutionRequestApprovalParams", - "type": "object", - "required": [ - "itemId", - "threadId", - "turnId" - ], - "properties": { - "threadId": { - "type": "string" - }, - "approvalId": { - "description": "Unique identifier for this specific approval callback.\n\nFor regular shell/unified_exec approvals, this is null.\n\nFor zsh-exec-bridge subcommand approvals, multiple callbacks can belong to one parent `itemId`, so `approvalId` is a distinct opaque callback id (a UUID) used to disambiguate routing.", - "type": [ - "string", - "null" - ] - }, - "turnId": { - "type": "string" - }, - "command": { - "description": "The command to be executed.", - "type": [ - "string", - "null" - ] - }, - "commandActions": { - "description": "Best-effort parsed command actions for friendly display.", - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/CommandAction" - } - }, - "cwd": { - "description": "The command's working directory.", - "anyOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - }, - { - "type": "null" - } - ] - }, - "itemId": { - "type": "string" - }, - "networkApprovalContext": { - "description": "Optional context for a managed-network approval prompt.", - "anyOf": [ - { - "$ref": "#/definitions/NetworkApprovalContext" - }, - { - "type": "null" - } - ] - }, - "proposedExecpolicyAmendment": { - "description": "Optional proposed execpolicy amendment to allow similar commands without prompting.", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "proposedNetworkPolicyAmendments": { - "description": "Optional proposed network policy amendments (allow/deny host) for future requests.", - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/NetworkPolicyAmendment" - } - }, - "reason": { - "description": "Optional explanatory reason (e.g. request for network access).", - "type": [ - "string", - "null" - ] - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "AdditionalFileSystemPermissions": { - "type": "object", "properties": { "entries": { + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - } + ] }, "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 1.0 + ] }, "read": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } + ] }, "write": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } + ] } - } + }, + "type": "object" }, "AdditionalNetworkPermissions": { - "type": "object", "properties": { "enabled": { "type": [ @@ -145,10 +53,10 @@ "null" ] } - } + }, + "type": "object" }, "AdditionalPermissionProfile": { - "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -170,18 +78,12 @@ } ] } - } + }, + "type": "object" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -193,21 +95,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -219,21 +123,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -251,34 +155,39 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, @@ -286,159 +195,154 @@ "oneOf": [ { "description": "User approved the command.", - "type": "string", "enum": [ "accept" - ] + ], + "type": "string" }, { "description": "User approved the command and future prompts in the same session-scoped approval cache should run without prompting.", - "type": "string", "enum": [ "acceptForSession" - ] + ], + "type": "string" }, { + "additionalProperties": false, "description": "User approved the command, and wants to apply the proposed execpolicy amendment so future matching commands can run without prompting.", - "type": "object", - "required": [ - "acceptWithExecpolicyAmendment" - ], "properties": { "acceptWithExecpolicyAmendment": { - "type": "object", + "properties": { + "execpolicy_amendment": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "execpolicy_amendment" ], - "properties": { - "execpolicy_amendment": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" } }, - "additionalProperties": false, - "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision" + "required": [ + "acceptWithExecpolicyAmendment" + ], + "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision", + "type": "object" }, { + "additionalProperties": false, "description": "User chose a persistent network policy rule (allow/deny) for this host.", - "type": "object", - "required": [ - "applyNetworkPolicyAmendment" - ], "properties": { "applyNetworkPolicyAmendment": { - "type": "object", - "required": [ - "network_policy_amendment" - ], "properties": { "network_policy_amendment": { "$ref": "#/definitions/NetworkPolicyAmendment" } - } + }, + "required": [ + "network_policy_amendment" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision" + "required": [ + "applyNetworkPolicyAmendment" + ], + "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision", + "type": "object" }, { "description": "User denied the command. The agent will continue the turn.", - "type": "string", "enum": [ "decline" - ] + ], + "type": "string" }, { "description": "User denied the command. The turn will also be immediately interrupted.", - "type": "string", "enum": [ "cancel" - ] + ], + "type": "string" } ] }, "FileSystemAccessMode": { - "type": "string", "enum": [ "read", "write", "none" - ] + ], + "type": "string" }, "FileSystemPath": { "oneOf": [ { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "path" ], - "title": "PathFileSystemPathType" + "title": "PathFileSystemPathType", + "type": "string" } }, - "title": "PathFileSystemPath" - }, - { - "type": "object", "required": [ - "pattern", + "path", "type" ], + "title": "PathFileSystemPath", + "type": "object" + }, + { "properties": { "pattern": { "type": "string" }, "type": { - "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType" + "title": "GlobPatternFileSystemPathType", + "type": "string" } }, - "title": "GlobPatternFileSystemPath" + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType" + "title": "SpecialFileSystemPathType", + "type": "string" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "title": "SpecialFileSystemPath" + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" } ] }, "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -446,66 +350,67 @@ "path": { "$ref": "#/definitions/FileSystemPath" } - } + }, + "required": [ + "access", + "path" + ], + "type": "object" }, "FileSystemSpecialPath": { "oneOf": [ { - "type": "object", - "required": [ - "kind" - ], "properties": { "kind": { - "type": "string", "enum": [ "root" - ] + ], + "type": "string" } }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "minimal" - ] + ], + "type": "string" } }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "current_working_directory" - ] + ], + "type": "string" } }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "project_roots" - ] + ], + "type": "string" }, "subpath": { "type": [ @@ -514,50 +419,49 @@ ] } }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "tmpdir" - ] + ], + "type": "string" } }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" }, { - "type": "object", - "required": [ - "kind", - "path" - ], "properties": { "kind": { - "type": "string", "enum": [ "unknown" - ] + ], + "type": "string" }, "path": { "type": "string" @@ -568,16 +472,16 @@ "null" ] } - } + }, + "required": [ + "kind", + "path" + ], + "type": "object" } ] }, "NetworkApprovalContext": { - "type": "object", - "required": [ - "host", - "protocol" - ], "properties": { "host": { "type": "string" @@ -585,23 +489,23 @@ "protocol": { "$ref": "#/definitions/NetworkApprovalProtocol" } - } + }, + "required": [ + "host", + "protocol" + ], + "type": "object" }, "NetworkApprovalProtocol": { - "type": "string", "enum": [ "http", "https", "socks5Tcp", "socks5Udp" - ] + ], + "type": "string" }, "NetworkPolicyAmendment": { - "type": "object", - "required": [ - "action", - "host" - ], "properties": { "action": { "$ref": "#/definitions/NetworkPolicyRuleAction" @@ -609,14 +513,110 @@ "host": { "type": "string" } - } + }, + "required": [ + "action", + "host" + ], + "type": "object" }, "NetworkPolicyRuleAction": { - "type": "string", "enum": [ "allow", "deny" - ] + ], + "type": "string" } - } + }, + "properties": { + "approvalId": { + "description": "Unique identifier for this specific approval callback.\n\nFor regular shell/unified_exec approvals, this is null.\n\nFor zsh-exec-bridge subcommand approvals, multiple callbacks can belong to one parent `itemId`, so `approvalId` is a distinct opaque callback id (a UUID) used to disambiguate routing.", + "type": [ + "string", + "null" + ] + }, + "command": { + "description": "The command to be executed.", + "type": [ + "string", + "null" + ] + }, + "commandActions": { + "description": "Best-effort parsed command actions for friendly display.", + "items": { + "$ref": "#/definitions/CommandAction" + }, + "type": [ + "array", + "null" + ] + }, + "cwd": { + "anyOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + }, + { + "type": "null" + } + ], + "description": "The command's working directory." + }, + "itemId": { + "type": "string" + }, + "networkApprovalContext": { + "anyOf": [ + { + "$ref": "#/definitions/NetworkApprovalContext" + }, + { + "type": "null" + } + ], + "description": "Optional context for a managed-network approval prompt." + }, + "proposedExecpolicyAmendment": { + "description": "Optional proposed execpolicy amendment to allow similar commands without prompting.", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "proposedNetworkPolicyAmendments": { + "description": "Optional proposed network policy amendments (allow/deny host) for future requests.", + "items": { + "$ref": "#/definitions/NetworkPolicyAmendment" + }, + "type": [ + "array", + "null" + ] + }, + "reason": { + "description": "Optional explanatory reason (e.g. request for network access).", + "type": [ + "string", + "null" + ] + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "itemId", + "threadId", + "turnId" + ], + "title": "CommandExecutionRequestApprovalParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalResponse.json index 60036c05..0b7986fb 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalResponse.json @@ -1,101 +1,86 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecutionRequestApprovalResponse", - "type": "object", - "required": [ - "decision" - ], - "properties": { - "decision": { - "$ref": "#/definitions/CommandExecutionApprovalDecision" - } - }, "definitions": { "CommandExecutionApprovalDecision": { "oneOf": [ { "description": "User approved the command.", - "type": "string", "enum": [ "accept" - ] + ], + "type": "string" }, { "description": "User approved the command and future prompts in the same session-scoped approval cache should run without prompting.", - "type": "string", "enum": [ "acceptForSession" - ] + ], + "type": "string" }, { + "additionalProperties": false, "description": "User approved the command, and wants to apply the proposed execpolicy amendment so future matching commands can run without prompting.", - "type": "object", - "required": [ - "acceptWithExecpolicyAmendment" - ], "properties": { "acceptWithExecpolicyAmendment": { - "type": "object", + "properties": { + "execpolicy_amendment": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "execpolicy_amendment" ], - "properties": { - "execpolicy_amendment": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" } }, - "additionalProperties": false, - "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision" + "required": [ + "acceptWithExecpolicyAmendment" + ], + "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision", + "type": "object" }, { + "additionalProperties": false, "description": "User chose a persistent network policy rule (allow/deny) for this host.", - "type": "object", - "required": [ - "applyNetworkPolicyAmendment" - ], "properties": { "applyNetworkPolicyAmendment": { - "type": "object", - "required": [ - "network_policy_amendment" - ], "properties": { "network_policy_amendment": { "$ref": "#/definitions/NetworkPolicyAmendment" } - } + }, + "required": [ + "network_policy_amendment" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision" + "required": [ + "applyNetworkPolicyAmendment" + ], + "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision", + "type": "object" }, { "description": "User denied the command. The agent will continue the turn.", - "type": "string", "enum": [ "decline" - ] + ], + "type": "string" }, { "description": "User denied the command. The turn will also be immediately interrupted.", - "type": "string", "enum": [ "cancel" - ] + ], + "type": "string" } ] }, "NetworkPolicyAmendment": { - "type": "object", - "required": [ - "action", - "host" - ], "properties": { "action": { "$ref": "#/definitions/NetworkPolicyRuleAction" @@ -103,14 +88,29 @@ "host": { "type": "string" } - } + }, + "required": [ + "action", + "host" + ], + "type": "object" }, "NetworkPolicyRuleAction": { - "type": "string", "enum": [ "allow", "deny" - ] + ], + "type": "string" } - } + }, + "properties": { + "decision": { + "$ref": "#/definitions/CommandExecutionApprovalDecision" + } + }, + "required": [ + "decision" + ], + "title": "CommandExecutionRequestApprovalResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/DynamicToolCallParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/DynamicToolCallParams.json index 7ffebbea..991733da 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/DynamicToolCallParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/DynamicToolCallParams.json @@ -1,14 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DynamicToolCallParams", - "type": "object", - "required": [ - "arguments", - "callId", - "threadId", - "tool", - "turnId" - ], "properties": { "arguments": true, "callId": { @@ -29,5 +20,14 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "arguments", + "callId", + "threadId", + "tool", + "turnId" + ], + "title": "DynamicToolCallParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/DynamicToolCallResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/DynamicToolCallResponse.json index e168790f..e0e29641 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/DynamicToolCallResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/DynamicToolCallResponse.json @@ -1,66 +1,66 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DynamicToolCallResponse", - "type": "object", - "required": [ - "contentItems", - "success" - ], - "properties": { - "contentItems": { - "type": "array", - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } - }, - "success": { - "type": "boolean" - } - }, "definitions": { "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] } - } + }, + "properties": { + "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, + "type": "array" + }, + "success": { + "type": "boolean" + } + }, + "required": [ + "contentItems", + "success" + ], + "title": "DynamicToolCallResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalParams.json index aee30339..43f85d21 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalParams.json @@ -1,62 +1,9 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExecCommandApprovalParams", - "type": "object", - "required": [ - "callId", - "command", - "conversationId", - "cwd", - "parsedCmd" - ], - "properties": { - "approvalId": { - "description": "Identifier for this specific approval callback.", - "type": [ - "string", - "null" - ] - }, - "callId": { - "description": "Use to correlate this with [codex_protocol::protocol::ExecCommandBeginEvent] and [codex_protocol::protocol::ExecCommandEndEvent].", - "type": "string" - }, - "command": { - "type": "array", - "items": { - "type": "string" - } - }, - "conversationId": { - "$ref": "#/definitions/ThreadId" - }, - "cwd": { - "type": "string" - }, - "parsedCmd": { - "type": "array", - "items": { - "$ref": "#/definitions/ParsedCommand" - } - }, - "reason": { - "type": [ - "string", - "null" - ] - } - }, "definitions": { "ParsedCommand": { "oneOf": [ { - "type": "object", - "required": [ - "cmd", - "name", - "path", - "type" - ], "properties": { "cmd": { "type": "string" @@ -69,21 +16,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadParsedCommandType" + "title": "ReadParsedCommandType", + "type": "string" } }, - "title": "ReadParsedCommand" - }, - { - "type": "object", "required": [ "cmd", + "name", + "path", "type" ], + "title": "ReadParsedCommand", + "type": "object" + }, + { "properties": { "cmd": { "type": "string" @@ -95,21 +44,21 @@ ] }, "type": { - "type": "string", "enum": [ "list_files" ], - "title": "ListFilesParsedCommandType" + "title": "ListFilesParsedCommandType", + "type": "string" } }, - "title": "ListFilesParsedCommand" - }, - { - "type": "object", "required": [ "cmd", "type" ], + "title": "ListFilesParsedCommand", + "type": "object" + }, + { "properties": { "cmd": { "type": "string" @@ -127,39 +76,90 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchParsedCommandType" + "title": "SearchParsedCommandType", + "type": "string" } }, - "title": "SearchParsedCommand" - }, - { - "type": "object", "required": [ "cmd", "type" ], + "title": "SearchParsedCommand", + "type": "object" + }, + { "properties": { "cmd": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownParsedCommandType" + "title": "UnknownParsedCommandType", + "type": "string" } }, - "title": "UnknownParsedCommand" + "required": [ + "cmd", + "type" + ], + "title": "UnknownParsedCommand", + "type": "object" } ] }, "ThreadId": { "type": "string" } - } + }, + "properties": { + "approvalId": { + "description": "Identifier for this specific approval callback.", + "type": [ + "string", + "null" + ] + }, + "callId": { + "description": "Use to correlate this with [codex_protocol::protocol::ExecCommandBeginEvent] and [codex_protocol::protocol::ExecCommandEndEvent].", + "type": "string" + }, + "command": { + "items": { + "type": "string" + }, + "type": "array" + }, + "conversationId": { + "$ref": "#/definitions/ThreadId" + }, + "cwd": { + "type": "string" + }, + "parsedCmd": { + "items": { + "$ref": "#/definitions/ParsedCommand" + }, + "type": "array" + }, + "reason": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "callId", + "command", + "conversationId", + "cwd", + "parsedCmd" + ], + "title": "ExecCommandApprovalParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalResponse.json index abafe36c..477109e2 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalResponse.json @@ -1,22 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExecCommandApprovalResponse", - "type": "object", - "required": [ - "decision" - ], - "properties": { - "decision": { - "$ref": "#/definitions/ReviewDecision" - } - }, "definitions": { "NetworkPolicyAmendment": { - "type": "object", - "required": [ - "action", - "host" - ], "properties": { "action": { "$ref": "#/definitions/NetworkPolicyRuleAction" @@ -24,101 +9,116 @@ "host": { "type": "string" } - } + }, + "required": [ + "action", + "host" + ], + "type": "object" }, "NetworkPolicyRuleAction": { - "type": "string", "enum": [ "allow", "deny" - ] + ], + "type": "string" }, "ReviewDecision": { "description": "User's decision in response to an ExecApprovalRequest.", "oneOf": [ { "description": "User has approved this command and the agent should execute it.", - "type": "string", "enum": [ "approved" - ] + ], + "type": "string" }, { + "additionalProperties": false, "description": "User has approved this command and wants to apply the proposed execpolicy amendment so future matching commands are permitted.", - "type": "object", - "required": [ - "approved_execpolicy_amendment" - ], "properties": { "approved_execpolicy_amendment": { - "type": "object", + "properties": { + "proposed_execpolicy_amendment": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "proposed_execpolicy_amendment" ], - "properties": { - "proposed_execpolicy_amendment": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" } }, - "additionalProperties": false, - "title": "ApprovedExecpolicyAmendmentReviewDecision" + "required": [ + "approved_execpolicy_amendment" + ], + "title": "ApprovedExecpolicyAmendmentReviewDecision", + "type": "object" }, { "description": "User has approved this request and wants future prompts in the same session-scoped approval cache to be automatically approved for the remainder of the session.", - "type": "string", "enum": [ "approved_for_session" - ] + ], + "type": "string" }, { + "additionalProperties": false, "description": "User chose to persist a network policy rule (allow/deny) for future requests to the same host.", - "type": "object", - "required": [ - "network_policy_amendment" - ], "properties": { "network_policy_amendment": { - "type": "object", - "required": [ - "network_policy_amendment" - ], "properties": { "network_policy_amendment": { "$ref": "#/definitions/NetworkPolicyAmendment" } - } + }, + "required": [ + "network_policy_amendment" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "NetworkPolicyAmendmentReviewDecision" + "required": [ + "network_policy_amendment" + ], + "title": "NetworkPolicyAmendmentReviewDecision", + "type": "object" }, { "description": "User has denied this command and the agent should not execute it, but it should continue the session and try something else.", - "type": "string", "enum": [ "denied" - ] + ], + "type": "string" }, { "description": "Automatic approval review timed out before reaching a decision.", - "type": "string", "enum": [ "timed_out" - ] + ], + "type": "string" }, { "description": "User has denied this command and the agent should not do anything until the user's next command.", - "type": "string", "enum": [ "abort" - ] + ], + "type": "string" } ] } - } + }, + "properties": { + "decision": { + "$ref": "#/definitions/ReviewDecision" + } + }, + "required": [ + "decision" + ], + "title": "ExecCommandApprovalResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalParams.json index f7e561c3..f52e98cd 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalParams.json @@ -1,12 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FileChangeRequestApprovalParams", - "type": "object", - "required": [ - "itemId", - "threadId", - "turnId" - ], "properties": { "grantRoot": { "description": "[UNSTABLE] When set, the agent is asking the user to allow writes under this root for the remainder of the session (unclear if this is honored today).", @@ -31,5 +24,12 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "itemId", + "threadId", + "turnId" + ], + "title": "FileChangeRequestApprovalParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalResponse.json index ace77406..f20035e3 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalResponse.json @@ -1,47 +1,47 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FileChangeRequestApprovalResponse", - "type": "object", - "required": [ - "decision" - ], - "properties": { - "decision": { - "$ref": "#/definitions/FileChangeApprovalDecision" - } - }, "definitions": { "FileChangeApprovalDecision": { "oneOf": [ { "description": "User approved the file changes.", - "type": "string", "enum": [ "accept" - ] + ], + "type": "string" }, { "description": "User approved the file changes and future changes to the same files should run without prompting.", - "type": "string", "enum": [ "acceptForSession" - ] + ], + "type": "string" }, { "description": "User denied the file changes. The agent will continue the turn.", - "type": "string", "enum": [ "decline" - ] + ], + "type": "string" }, { "description": "User denied the file changes. The turn will also be immediately interrupted.", - "type": "string", "enum": [ "cancel" - ] + ], + "type": "string" } ] } - } + }, + "properties": { + "decision": { + "$ref": "#/definitions/FileChangeApprovalDecision" + } + }, + "required": [ + "decision" + ], + "title": "FileChangeRequestApprovalResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchParams.json index 06078566..3a72939d 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchParams.json @@ -1,11 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FuzzyFileSearchParams", - "type": "object", - "required": [ - "query", - "roots" - ], "properties": { "cancellationToken": { "type": [ @@ -17,10 +11,16 @@ "type": "string" }, "roots": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "required": [ + "query", + "roots" + ], + "title": "FuzzyFileSearchParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchResponse.json index 808171ab..3c91a79c 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchResponse.json @@ -1,50 +1,29 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FuzzyFileSearchResponse", - "type": "object", - "required": [ - "files" - ], - "properties": { - "files": { - "type": "array", - "items": { - "$ref": "#/definitions/FuzzyFileSearchResult" - } - } - }, "definitions": { "FuzzyFileSearchMatchType": { - "type": "string", "enum": [ "file", "directory" - ] + ], + "type": "string" }, "FuzzyFileSearchResult": { "description": "Superset of [`codex_file_search::FileMatch`]", - "type": "object", - "required": [ - "file_name", - "match_type", - "path", - "root", - "score" - ], "properties": { "file_name": { "type": "string" }, "indices": { + "items": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, "type": [ "array", "null" - ], - "items": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - } + ] }, "match_type": { "$ref": "#/definitions/FuzzyFileSearchMatchType" @@ -56,11 +35,32 @@ "type": "string" }, "score": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" } - } + }, + "required": [ + "file_name", + "match_type", + "path", + "root", + "score" + ], + "type": "object" } - } + }, + "properties": { + "files": { + "items": { + "$ref": "#/definitions/FuzzyFileSearchResult" + }, + "type": "array" + } + }, + "required": [ + "files" + ], + "title": "FuzzyFileSearchResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchSessionCompletedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchSessionCompletedNotification.json index 2312b219..c8924e77 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchSessionCompletedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchSessionCompletedNotification.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FuzzyFileSearchSessionCompletedNotification", - "type": "object", - "required": [ - "sessionId" - ], "properties": { "sessionId": { "type": "string" } - } + }, + "required": [ + "sessionId" + ], + "title": "FuzzyFileSearchSessionCompletedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchSessionUpdatedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchSessionUpdatedNotification.json index d1babb04..b69ad9b2 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchSessionUpdatedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchSessionUpdatedNotification.json @@ -1,58 +1,29 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FuzzyFileSearchSessionUpdatedNotification", - "type": "object", - "required": [ - "files", - "query", - "sessionId" - ], - "properties": { - "files": { - "type": "array", - "items": { - "$ref": "#/definitions/FuzzyFileSearchResult" - } - }, - "query": { - "type": "string" - }, - "sessionId": { - "type": "string" - } - }, "definitions": { "FuzzyFileSearchMatchType": { - "type": "string", "enum": [ "file", "directory" - ] + ], + "type": "string" }, "FuzzyFileSearchResult": { "description": "Superset of [`codex_file_search::FileMatch`]", - "type": "object", - "required": [ - "file_name", - "match_type", - "path", - "root", - "score" - ], "properties": { "file_name": { "type": "string" }, "indices": { + "items": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, "type": [ "array", "null" - ], - "items": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - } + ] }, "match_type": { "$ref": "#/definitions/FuzzyFileSearchMatchType" @@ -64,11 +35,40 @@ "type": "string" }, "score": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" } - } + }, + "required": [ + "file_name", + "match_type", + "path", + "root", + "score" + ], + "type": "object" } - } + }, + "properties": { + "files": { + "items": { + "$ref": "#/definitions/FuzzyFileSearchResult" + }, + "type": "array" + }, + "query": { + "type": "string" + }, + "sessionId": { + "type": "string" + } + }, + "required": [ + "files", + "query", + "sessionId" + ], + "title": "FuzzyFileSearchSessionUpdatedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCError.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCError.json index 54cc21b9..6db5d1a7 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCError.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCError.json @@ -1,12 +1,36 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "JSONRPCError", + "definitions": { + "JSONRPCErrorError": { + "properties": { + "code": { + "format": "int64", + "type": "integer" + }, + "data": true, + "message": { + "type": "string" + } + }, + "required": [ + "code", + "message" + ], + "type": "object" + }, + "RequestId": { + "anyOf": [ + { + "type": "string" + }, + { + "format": "int64", + "type": "integer" + } + ] + } + }, "description": "A response to a request that indicates an error occurred.", - "type": "object", - "required": [ - "error", - "id" - ], "properties": { "error": { "$ref": "#/definitions/JSONRPCErrorError" @@ -15,34 +39,10 @@ "$ref": "#/definitions/RequestId" } }, - "definitions": { - "JSONRPCErrorError": { - "type": "object", - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int64" - }, - "data": true, - "message": { - "type": "string" - } - } - }, - "RequestId": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "integer", - "format": "int64" - } - ] - } - } + "required": [ + "error", + "id" + ], + "title": "JSONRPCError", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCErrorError.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCErrorError.json index 32594508..932ef33c 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCErrorError.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCErrorError.json @@ -1,19 +1,19 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "JSONRPCErrorError", - "type": "object", - "required": [ - "code", - "message" - ], "properties": { "code": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "data": true, "message": { "type": "string" } - } + }, + "required": [ + "code", + "message" + ], + "title": "JSONRPCErrorError", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCMessage.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCMessage.json index cb4a6733..27b78b90 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCMessage.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCMessage.json @@ -1,7 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "JSONRPCMessage", - "description": "Refers to any valid JSON-RPC object that can be decoded off the wire, or encoded to be sent.", "anyOf": [ { "$ref": "#/definitions/JSONRPCRequest" @@ -19,11 +17,6 @@ "definitions": { "JSONRPCError": { "description": "A response to a request that indicates an error occurred.", - "type": "object", - "required": [ - "error", - "id" - ], "properties": { "error": { "$ref": "#/definitions/JSONRPCErrorError" @@ -31,45 +24,45 @@ "id": { "$ref": "#/definitions/RequestId" } - } + }, + "required": [ + "error", + "id" + ], + "type": "object" }, "JSONRPCErrorError": { - "type": "object", - "required": [ - "code", - "message" - ], "properties": { "code": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "data": true, "message": { "type": "string" } - } + }, + "required": [ + "code", + "message" + ], + "type": "object" }, "JSONRPCNotification": { "description": "A notification which does not expect a response.", - "type": "object", - "required": [ - "method" - ], "properties": { "method": { "type": "string" }, "params": true - } + }, + "required": [ + "method" + ], + "type": "object" }, "JSONRPCRequest": { "description": "A request that expects a response.", - "type": "object", - "required": [ - "id", - "method" - ], "properties": { "id": { "$ref": "#/definitions/RequestId" @@ -79,7 +72,6 @@ }, "params": true, "trace": { - "description": "Optional W3C Trace Context for distributed tracing.", "anyOf": [ { "$ref": "#/definitions/W3cTraceContext" @@ -87,23 +79,29 @@ { "type": "null" } - ] + ], + "description": "Optional W3C Trace Context for distributed tracing." } - } + }, + "required": [ + "id", + "method" + ], + "type": "object" }, "JSONRPCResponse": { "description": "A successful (non-error) response to a request.", - "type": "object", - "required": [ - "id", - "result" - ], "properties": { "id": { "$ref": "#/definitions/RequestId" }, "result": true - } + }, + "required": [ + "id", + "result" + ], + "type": "object" }, "RequestId": { "anyOf": [ @@ -111,13 +109,12 @@ "type": "string" }, { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } ] }, "W3cTraceContext": { - "type": "object", "properties": { "traceparent": { "type": [ @@ -131,7 +128,10 @@ "null" ] } - } + }, + "type": "object" } - } + }, + "description": "Refers to any valid JSON-RPC object that can be decoded off the wire, or encoded to be sent.", + "title": "JSONRPCMessage" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCNotification.json index 8d367137..2ddd61a8 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCNotification.json @@ -1,15 +1,15 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "JSONRPCNotification", "description": "A notification which does not expect a response.", - "type": "object", - "required": [ - "method" - ], "properties": { "method": { "type": "string" }, "params": true - } + }, + "required": [ + "method" + ], + "title": "JSONRPCNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCRequest.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCRequest.json index 6fc6d65f..e4ea7c20 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCRequest.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCRequest.json @@ -1,32 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "JSONRPCRequest", - "description": "A request that expects a response.", - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string" - }, - "params": true, - "trace": { - "description": "Optional W3C Trace Context for distributed tracing.", - "anyOf": [ - { - "$ref": "#/definitions/W3cTraceContext" - }, - { - "type": "null" - } - ] - } - }, "definitions": { "RequestId": { "anyOf": [ @@ -34,13 +7,12 @@ "type": "string" }, { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } ] }, "W3cTraceContext": { - "type": "object", "properties": { "traceparent": { "type": [ @@ -54,7 +26,35 @@ "null" ] } - } + }, + "type": "object" } - } + }, + "description": "A request that expects a response.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "type": "string" + }, + "params": true, + "trace": { + "anyOf": [ + { + "$ref": "#/definitions/W3cTraceContext" + }, + { + "type": "null" + } + ], + "description": "Optional W3C Trace Context for distributed tracing." + } + }, + "required": [ + "id", + "method" + ], + "title": "JSONRPCRequest", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCResponse.json index 86a74bd4..9f1ec295 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/JSONRPCResponse.json @@ -1,18 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "JSONRPCResponse", - "description": "A successful (non-error) response to a request.", - "type": "object", - "required": [ - "id", - "result" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "result": true - }, "definitions": { "RequestId": { "anyOf": [ @@ -20,10 +7,23 @@ "type": "string" }, { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } ] } - } + }, + "description": "A successful (non-error) response to a request.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "result": true + }, + "required": [ + "id", + "result" + ], + "title": "JSONRPCResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/McpServerElicitationRequestParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/McpServerElicitationRequestParams.json index 44ec7e04..aa7fa817 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/McpServerElicitationRequestParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/McpServerElicitationRequestParams.json @@ -1,90 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerElicitationRequestParams", - "type": "object", - "oneOf": [ - { - "type": "object", - "required": [ - "message", - "mode", - "requestedSchema" - ], - "properties": { - "_meta": true, - "message": { - "type": "string" - }, - "mode": { - "type": "string", - "enum": [ - "form" - ] - }, - "requestedSchema": { - "$ref": "#/definitions/McpElicitationSchema" - } - } - }, - { - "type": "object", - "required": [ - "elicitationId", - "message", - "mode", - "url" - ], - "properties": { - "_meta": true, - "elicitationId": { - "type": "string" - }, - "message": { - "type": "string" - }, - "mode": { - "type": "string", - "enum": [ - "url" - ] - }, - "url": { - "type": "string" - } - } - } - ], - "required": [ - "serverName", - "threadId" - ], - "properties": { - "serverName": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "description": "Active Codex turn when this elicitation was observed, if app-server could correlate one.\n\nThis is nullable because MCP models elicitation as a standalone server-to-client request identified by the MCP server request id. It may be triggered during a turn, but turn context is app-server correlation rather than part of the protocol identity of the elicitation itself.", - "type": [ - "string", - "null" - ] - } - }, "definitions": { "McpElicitationArrayType": { - "type": "string", "enum": [ "array" - ] + ], + "type": "string" }, "McpElicitationBooleanSchema": { - "type": "object", - "required": [ - "type" - ], + "additionalProperties": false, "properties": { "default": { "type": [ @@ -108,20 +32,19 @@ "$ref": "#/definitions/McpElicitationBooleanType" } }, - "additionalProperties": false + "required": [ + "type" + ], + "type": "object" }, "McpElicitationBooleanType": { - "type": "string", "enum": [ "boolean" - ] + ], + "type": "string" }, "McpElicitationConstOption": { - "type": "object", - "required": [ - "const", - "title" - ], + "additionalProperties": false, "properties": { "const": { "type": "string" @@ -130,7 +53,11 @@ "type": "string" } }, - "additionalProperties": false + "required": [ + "const", + "title" + ], + "type": "object" }, "McpElicitationEnumSchema": { "anyOf": [ @@ -146,11 +73,7 @@ ] }, "McpElicitationLegacyTitledEnumSchema": { - "type": "object", - "required": [ - "enum", - "type" - ], + "additionalProperties": false, "properties": { "default": { "type": [ @@ -165,19 +88,19 @@ ] }, "enum": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "enumNames": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "title": { "type": [ @@ -189,7 +112,11 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false + "required": [ + "enum", + "type" + ], + "type": "object" }, "McpElicitationMultiSelectEnumSchema": { "anyOf": [ @@ -202,17 +129,14 @@ ] }, "McpElicitationNumberSchema": { - "type": "object", - "required": [ - "type" - ], + "additionalProperties": false, "properties": { "default": { + "format": "double", "type": [ "number", "null" - ], - "format": "double" + ] }, "description": { "type": [ @@ -221,18 +145,18 @@ ] }, "maximum": { + "format": "double", "type": [ "number", "null" - ], - "format": "double" + ] }, "minimum": { + "format": "double", "type": [ "number", "null" - ], - "format": "double" + ] }, "title": { "type": [ @@ -244,20 +168,23 @@ "$ref": "#/definitions/McpElicitationNumberType" } }, - "additionalProperties": false + "required": [ + "type" + ], + "type": "object" }, "McpElicitationNumberType": { - "type": "string", "enum": [ "number", "integer" - ] + ], + "type": "string" }, "McpElicitationObjectType": { - "type": "string", "enum": [ "object" - ] + ], + "type": "string" }, "McpElicitationPrimitiveSchema": { "anyOf": [ @@ -276,12 +203,8 @@ ] }, "McpElicitationSchema": { + "additionalProperties": false, "description": "Typed form schema for MCP `elicitation/create` requests.\n\nThis matches the `requestedSchema` shape from the MCP 2025-11-25 `ElicitRequestFormParams` schema.", - "type": "object", - "required": [ - "properties", - "type" - ], "properties": { "$schema": { "type": [ @@ -290,25 +213,29 @@ ] }, "properties": { - "type": "object", "additionalProperties": { "$ref": "#/definitions/McpElicitationPrimitiveSchema" - } + }, + "type": "object" }, "required": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "type": { "$ref": "#/definitions/McpElicitationObjectType" } }, - "additionalProperties": false + "required": [ + "properties", + "type" + ], + "type": "object" }, "McpElicitationSingleSelectEnumSchema": { "anyOf": [ @@ -321,19 +248,16 @@ ] }, "McpElicitationStringFormat": { - "type": "string", "enum": [ "email", "uri", "date", "date-time" - ] + ], + "type": "string" }, "McpElicitationStringSchema": { - "type": "object", - "required": [ - "type" - ], + "additionalProperties": false, "properties": { "default": { "type": [ @@ -358,20 +282,20 @@ ] }, "maxLength": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "minLength": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "title": { "type": [ @@ -383,44 +307,43 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false + "required": [ + "type" + ], + "type": "object" }, "McpElicitationStringType": { - "type": "string", "enum": [ "string" - ] + ], + "type": "string" }, "McpElicitationTitledEnumItems": { - "type": "object", + "additionalProperties": false, + "properties": { + "anyOf": { + "items": { + "$ref": "#/definitions/McpElicitationConstOption" + }, + "type": "array" + } + }, "required": [ "anyOf" ], - "properties": { - "anyOf": { - "type": "array", - "items": { - "$ref": "#/definitions/McpElicitationConstOption" - } - } - }, - "additionalProperties": false + "type": "object" }, "McpElicitationTitledMultiSelectEnumSchema": { - "type": "object", - "required": [ - "items", - "type" - ], + "additionalProperties": false, "properties": { "default": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "description": { "type": [ @@ -432,20 +355,20 @@ "$ref": "#/definitions/McpElicitationTitledEnumItems" }, "maxItems": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "minItems": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "title": { "type": [ @@ -457,14 +380,14 @@ "$ref": "#/definitions/McpElicitationArrayType" } }, - "additionalProperties": false - }, - "McpElicitationTitledSingleSelectEnumSchema": { - "type": "object", "required": [ - "oneOf", + "items", "type" ], + "type": "object" + }, + "McpElicitationTitledSingleSelectEnumSchema": { + "additionalProperties": false, "properties": { "default": { "type": [ @@ -479,10 +402,10 @@ ] }, "oneOf": { - "type": "array", "items": { "$ref": "#/definitions/McpElicitationConstOption" - } + }, + "type": "array" }, "title": { "type": [ @@ -494,42 +417,42 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false - }, - "McpElicitationUntitledEnumItems": { - "type": "object", "required": [ - "enum", + "oneOf", "type" ], + "type": "object" + }, + "McpElicitationUntitledEnumItems": { + "additionalProperties": false, "properties": { "enum": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false - }, - "McpElicitationUntitledMultiSelectEnumSchema": { - "type": "object", "required": [ - "items", + "enum", "type" ], + "type": "object" + }, + "McpElicitationUntitledMultiSelectEnumSchema": { + "additionalProperties": false, "properties": { "default": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "description": { "type": [ @@ -541,20 +464,20 @@ "$ref": "#/definitions/McpElicitationUntitledEnumItems" }, "maxItems": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "minItems": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "title": { "type": [ @@ -566,14 +489,14 @@ "$ref": "#/definitions/McpElicitationArrayType" } }, - "additionalProperties": false - }, - "McpElicitationUntitledSingleSelectEnumSchema": { - "type": "object", "required": [ - "enum", + "items", "type" ], + "type": "object" + }, + "McpElicitationUntitledSingleSelectEnumSchema": { + "additionalProperties": false, "properties": { "default": { "type": [ @@ -588,10 +511,10 @@ ] }, "enum": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": [ @@ -603,7 +526,84 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false + "required": [ + "enum", + "type" + ], + "type": "object" } - } + }, + "oneOf": [ + { + "properties": { + "_meta": true, + "message": { + "type": "string" + }, + "mode": { + "enum": [ + "form" + ], + "type": "string" + }, + "requestedSchema": { + "$ref": "#/definitions/McpElicitationSchema" + } + }, + "required": [ + "message", + "mode", + "requestedSchema" + ], + "type": "object" + }, + { + "properties": { + "_meta": true, + "elicitationId": { + "type": "string" + }, + "message": { + "type": "string" + }, + "mode": { + "enum": [ + "url" + ], + "type": "string" + }, + "url": { + "type": "string" + } + }, + "required": [ + "elicitationId", + "message", + "mode", + "url" + ], + "type": "object" + } + ], + "properties": { + "serverName": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "description": "Active Codex turn when this elicitation was observed, if app-server could correlate one.\n\nThis is nullable because MCP models elicitation as a standalone server-to-client request identified by the MCP server request id. It may be triggered during a turn, but turn context is app-server correlation rather than part of the protocol identity of the elicitation itself.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "serverName", + "threadId" + ], + "title": "McpServerElicitationRequestParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/McpServerElicitationRequestResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/McpServerElicitationRequestResponse.json index f0fe3105..13390a06 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/McpServerElicitationRequestResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/McpServerElicitationRequestResponse.json @@ -1,10 +1,15 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerElicitationRequestResponse", - "type": "object", - "required": [ - "action" - ], + "definitions": { + "McpServerElicitationAction": { + "enum": [ + "accept", + "decline", + "cancel" + ], + "type": "string" + } + }, "properties": { "_meta": { "description": "Optional client metadata for form-mode action handling." @@ -16,14 +21,9 @@ "description": "Structured user input for accepted elicitations, mirroring RMCP `CreateElicitationResult`.\n\nThis is nullable because decline/cancel responses have no content." } }, - "definitions": { - "McpServerElicitationAction": { - "type": "string", - "enum": [ - "accept", - "decline", - "cancel" - ] - } - } + "required": [ + "action" + ], + "title": "McpServerElicitationRequestResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/PermissionsRequestApprovalParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/PermissionsRequestApprovalParams.json index 84e9e326..c2e26c55 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/PermissionsRequestApprovalParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/PermissionsRequestApprovalParams.json @@ -1,14 +1,299 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "PermissionsRequestApprovalParams", - "type": "object", - "required": [ - "cwd", - "itemId", - "permissions", - "threadId", - "turnId" - ], + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + }, + "AdditionalFileSystemPermissions": { + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + }, + "type": [ + "array", + "null" + ] + }, + "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, + "type": [ + "integer", + "null" + ] + }, + "read": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": [ + "array", + "null" + ] + }, + "write": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": [ + "array", + "null" + ] + } + }, + "type": "object" + }, + "AdditionalNetworkPermissions": { + "properties": { + "enabled": { + "type": [ + "boolean", + "null" + ] + } + }, + "type": "object" + }, + "FileSystemAccessMode": { + "enum": [ + "read", + "write", + "none" + ], + "type": "string" + }, + "FileSystemPath": { + "oneOf": [ + { + "properties": { + "path": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": { + "enum": [ + "path" + ], + "title": "PathFileSystemPathType", + "type": "string" + } + }, + "required": [ + "path", + "type" + ], + "title": "PathFileSystemPath", + "type": "object" + }, + { + "properties": { + "pattern": { + "type": "string" + }, + "type": { + "enum": [ + "glob_pattern" + ], + "title": "GlobPatternFileSystemPathType", + "type": "string" + } + }, + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "special" + ], + "title": "SpecialFileSystemPathType", + "type": "string" + }, + "value": { + "$ref": "#/definitions/FileSystemSpecialPath" + } + }, + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" + } + ] + }, + "FileSystemSandboxEntry": { + "properties": { + "access": { + "$ref": "#/definitions/FileSystemAccessMode" + }, + "path": { + "$ref": "#/definitions/FileSystemPath" + } + }, + "required": [ + "access", + "path" + ], + "type": "object" + }, + "FileSystemSpecialPath": { + "oneOf": [ + { + "properties": { + "kind": { + "enum": [ + "root" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "minimal" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "current_working_directory" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "project_roots" + ], + "type": "string" + }, + "subpath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind" + ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "tmpdir" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "unknown" + ], + "type": "string" + }, + "path": { + "type": "string" + }, + "subpath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind", + "path" + ], + "type": "object" + } + ] + }, + "RequestPermissionProfile": { + "additionalProperties": false, + "properties": { + "fileSystem": { + "anyOf": [ + { + "$ref": "#/definitions/AdditionalFileSystemPermissions" + }, + { + "type": "null" + } + ] + }, + "network": { + "anyOf": [ + { + "$ref": "#/definitions/AdditionalNetworkPermissions" + }, + { + "type": "null" + } + ] + } + }, + "type": "object" + } + }, "properties": { "cwd": { "$ref": "#/definitions/AbsolutePathBuf" @@ -32,298 +317,13 @@ "type": "string" } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - }, - "AdditionalFileSystemPermissions": { - "type": "object", - "properties": { - "entries": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - } - }, - "globScanMaxDepth": { - "type": [ - "integer", - "null" - ], - "format": "uint", - "minimum": 1.0 - }, - "read": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "write": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - } - } - }, - "AdditionalNetworkPermissions": { - "type": "object", - "properties": { - "enabled": { - "type": [ - "boolean", - "null" - ] - } - } - }, - "FileSystemAccessMode": { - "type": "string", - "enum": [ - "read", - "write", - "none" - ] - }, - "FileSystemPath": { - "oneOf": [ - { - "type": "object", - "required": [ - "path", - "type" - ], - "properties": { - "path": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": { - "type": "string", - "enum": [ - "path" - ], - "title": "PathFileSystemPathType" - } - }, - "title": "PathFileSystemPath" - }, - { - "type": "object", - "required": [ - "pattern", - "type" - ], - "properties": { - "pattern": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "glob_pattern" - ], - "title": "GlobPatternFileSystemPathType" - } - }, - "title": "GlobPatternFileSystemPath" - }, - { - "type": "object", - "required": [ - "type", - "value" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "special" - ], - "title": "SpecialFileSystemPathType" - }, - "value": { - "$ref": "#/definitions/FileSystemSpecialPath" - } - }, - "title": "SpecialFileSystemPath" - } - ] - }, - "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], - "properties": { - "access": { - "$ref": "#/definitions/FileSystemAccessMode" - }, - "path": { - "$ref": "#/definitions/FileSystemPath" - } - } - }, - "FileSystemSpecialPath": { - "oneOf": [ - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "root" - ] - } - }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "minimal" - ] - } - }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "current_working_directory" - ] - } - }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "project_roots" - ] - }, - "subpath": { - "type": [ - "string", - "null" - ] - } - }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "tmpdir" - ] - } - }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind", - "path" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "unknown" - ] - }, - "path": { - "type": "string" - }, - "subpath": { - "type": [ - "string", - "null" - ] - } - } - } - ] - }, - "RequestPermissionProfile": { - "type": "object", - "properties": { - "fileSystem": { - "anyOf": [ - { - "$ref": "#/definitions/AdditionalFileSystemPermissions" - }, - { - "type": "null" - } - ] - }, - "network": { - "anyOf": [ - { - "$ref": "#/definitions/AdditionalNetworkPermissions" - }, - { - "type": "null" - } - ] - } - }, - "additionalProperties": false - } - } + "required": [ + "cwd", + "itemId", + "permissions", + "threadId", + "turnId" + ], + "title": "PermissionsRequestApprovalParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/PermissionsRequestApprovalResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/PermissionsRequestApprovalResponse.json index abeb7079..e066108e 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/PermissionsRequestApprovalResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/PermissionsRequestApprovalResponse.json @@ -1,77 +1,51 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "PermissionsRequestApprovalResponse", - "type": "object", - "required": [ - "permissions" - ], - "properties": { - "permissions": { - "$ref": "#/definitions/GrantedPermissionProfile" - }, - "scope": { - "default": "turn", - "allOf": [ - { - "$ref": "#/definitions/PermissionGrantScope" - } - ] - }, - "strictAutoReview": { - "description": "Review every subsequent command in this turn before normal sandboxed execution.", - "type": [ - "boolean", - "null" - ] - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "AdditionalFileSystemPermissions": { - "type": "object", "properties": { "entries": { + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - } + ] }, "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 1.0 + ] }, "read": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } + ] }, "write": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } + ] } - } + }, + "type": "object" }, "AdditionalNetworkPermissions": { - "type": "object", "properties": { "enabled": { "type": [ @@ -79,86 +53,82 @@ "null" ] } - } + }, + "type": "object" }, "FileSystemAccessMode": { - "type": "string", "enum": [ "read", "write", "none" - ] + ], + "type": "string" }, "FileSystemPath": { "oneOf": [ { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "path" ], - "title": "PathFileSystemPathType" + "title": "PathFileSystemPathType", + "type": "string" } }, - "title": "PathFileSystemPath" - }, - { - "type": "object", "required": [ - "pattern", + "path", "type" ], + "title": "PathFileSystemPath", + "type": "object" + }, + { "properties": { "pattern": { "type": "string" }, "type": { - "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType" + "title": "GlobPatternFileSystemPathType", + "type": "string" } }, - "title": "GlobPatternFileSystemPath" + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType" + "title": "SpecialFileSystemPathType", + "type": "string" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "title": "SpecialFileSystemPath" + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" } ] }, "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -166,66 +136,67 @@ "path": { "$ref": "#/definitions/FileSystemPath" } - } + }, + "required": [ + "access", + "path" + ], + "type": "object" }, "FileSystemSpecialPath": { "oneOf": [ { - "type": "object", - "required": [ - "kind" - ], "properties": { "kind": { - "type": "string", "enum": [ "root" - ] + ], + "type": "string" } }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "minimal" - ] + ], + "type": "string" } }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "current_working_directory" - ] + ], + "type": "string" } }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "project_roots" - ] + ], + "type": "string" }, "subpath": { "type": [ @@ -234,50 +205,49 @@ ] } }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "tmpdir" - ] + ], + "type": "string" } }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" }, { - "type": "object", - "required": [ - "kind", - "path" - ], "properties": { "kind": { - "type": "string", "enum": [ "unknown" - ] + ], + "type": "string" }, "path": { "type": "string" @@ -288,12 +258,16 @@ "null" ] } - } + }, + "required": [ + "kind", + "path" + ], + "type": "object" } ] }, "GrantedPermissionProfile": { - "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -315,14 +289,40 @@ } ] } - } + }, + "type": "object" }, "PermissionGrantScope": { - "type": "string", "enum": [ "turn", "session" + ], + "type": "string" + } + }, + "properties": { + "permissions": { + "$ref": "#/definitions/GrantedPermissionProfile" + }, + "scope": { + "allOf": [ + { + "$ref": "#/definitions/PermissionGrantScope" + } + ], + "default": "turn" + }, + "strictAutoReview": { + "description": "Review every subsequent command in this turn before normal sandboxed execution.", + "type": [ + "boolean", + "null" ] } - } + }, + "required": [ + "permissions" + ], + "title": "PermissionsRequestApprovalResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/RequestId.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/RequestId.json index 8cb7b945..d0fa43db 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/RequestId.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/RequestId.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "RequestId", "anyOf": [ { "type": "string" }, { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } - ] + ], + "title": "RequestId" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/ServerNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/ServerNotification.json index e07fdc22..b2257e75 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/ServerNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/ServerNotification.json @@ -1,1144 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ServerNotification", - "description": "Notification sent from the server to the client.", - "oneOf": [ - { - "description": "NEW NOTIFICATIONS", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "error" - ], - "title": "ErrorNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ErrorNotification" - } - }, - "title": "ErrorNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/started" - ], - "title": "Thread/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadStartedNotification" - } - }, - "title": "Thread/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/status/changed" - ], - "title": "Thread/status/changedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadStatusChangedNotification" - } - }, - "title": "Thread/status/changedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/archived" - ], - "title": "Thread/archivedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadArchivedNotification" - } - }, - "title": "Thread/archivedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/unarchived" - ], - "title": "Thread/unarchivedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadUnarchivedNotification" - } - }, - "title": "Thread/unarchivedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/closed" - ], - "title": "Thread/closedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadClosedNotification" - } - }, - "title": "Thread/closedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/name/updated" - ], - "title": "Thread/name/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadNameUpdatedNotification" - } - }, - "title": "Thread/name/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/tokenUsage/updated" - ], - "title": "Thread/tokenUsage/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadTokenUsageUpdatedNotification" - } - }, - "title": "Thread/tokenUsage/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "turn/started" - ], - "title": "Turn/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/TurnStartedNotification" - } - }, - "title": "Turn/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "hook/started" - ], - "title": "Hook/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/HookStartedNotification" - } - }, - "title": "Hook/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "turn/completed" - ], - "title": "Turn/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/TurnCompletedNotification" - } - }, - "title": "Turn/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "hook/completed" - ], - "title": "Hook/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/HookCompletedNotification" - } - }, - "title": "Hook/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "turn/diff/updated" - ], - "title": "Turn/diff/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/TurnDiffUpdatedNotification" - } - }, - "title": "Turn/diff/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "turn/plan/updated" - ], - "title": "Turn/plan/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/TurnPlanUpdatedNotification" - } - }, - "title": "Turn/plan/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/started" - ], - "title": "Item/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ItemStartedNotification" - } - }, - "title": "Item/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/autoApprovalReview/started" - ], - "title": "Item/autoApprovalReview/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ItemGuardianApprovalReviewStartedNotification" - } - }, - "title": "Item/autoApprovalReview/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/autoApprovalReview/completed" - ], - "title": "Item/autoApprovalReview/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ItemGuardianApprovalReviewCompletedNotification" - } - }, - "title": "Item/autoApprovalReview/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/completed" - ], - "title": "Item/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ItemCompletedNotification" - } - }, - "title": "Item/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/agentMessage/delta" - ], - "title": "Item/agentMessage/deltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/AgentMessageDeltaNotification" - } - }, - "title": "Item/agentMessage/deltaNotification" - }, - { - "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items.", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/plan/delta" - ], - "title": "Item/plan/deltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/PlanDeltaNotification" - } - }, - "title": "Item/plan/deltaNotification" - }, - { - "description": "Stream base64-encoded stdout/stderr chunks for a running `command/exec` session.", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "command/exec/outputDelta" - ], - "title": "Command/exec/outputDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecOutputDeltaNotification" - } - }, - "title": "Command/exec/outputDeltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/commandExecution/outputDelta" - ], - "title": "Item/commandExecution/outputDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecutionOutputDeltaNotification" - } - }, - "title": "Item/commandExecution/outputDeltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/commandExecution/terminalInteraction" - ], - "title": "Item/commandExecution/terminalInteractionNotificationMethod" - }, - "params": { - "$ref": "#/definitions/TerminalInteractionNotification" - } - }, - "title": "Item/commandExecution/terminalInteractionNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/fileChange/outputDelta" - ], - "title": "Item/fileChange/outputDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/FileChangeOutputDeltaNotification" - } - }, - "title": "Item/fileChange/outputDeltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/fileChange/patchUpdated" - ], - "title": "Item/fileChange/patchUpdatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/FileChangePatchUpdatedNotification" - } - }, - "title": "Item/fileChange/patchUpdatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "serverRequest/resolved" - ], - "title": "ServerRequest/resolvedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ServerRequestResolvedNotification" - } - }, - "title": "ServerRequest/resolvedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/mcpToolCall/progress" - ], - "title": "Item/mcpToolCall/progressNotificationMethod" - }, - "params": { - "$ref": "#/definitions/McpToolCallProgressNotification" - } - }, - "title": "Item/mcpToolCall/progressNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "mcpServer/oauthLogin/completed" - ], - "title": "McpServer/oauthLogin/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/McpServerOauthLoginCompletedNotification" - } - }, - "title": "McpServer/oauthLogin/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "mcpServer/startupStatus/updated" - ], - "title": "McpServer/startupStatus/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/McpServerStatusUpdatedNotification" - } - }, - "title": "McpServer/startupStatus/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "account/updated" - ], - "title": "Account/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/AccountUpdatedNotification" - } - }, - "title": "Account/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "account/rateLimits/updated" - ], - "title": "Account/rateLimits/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/AccountRateLimitsUpdatedNotification" - } - }, - "title": "Account/rateLimits/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "fs/changed" - ], - "title": "Fs/changedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/FsChangedNotification" - } - }, - "title": "Fs/changedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/reasoning/summaryTextDelta" - ], - "title": "Item/reasoning/summaryTextDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ReasoningSummaryTextDeltaNotification" - } - }, - "title": "Item/reasoning/summaryTextDeltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/reasoning/summaryPartAdded" - ], - "title": "Item/reasoning/summaryPartAddedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ReasoningSummaryPartAddedNotification" - } - }, - "title": "Item/reasoning/summaryPartAddedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/reasoning/textDelta" - ], - "title": "Item/reasoning/textDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ReasoningTextDeltaNotification" - } - }, - "title": "Item/reasoning/textDeltaNotification" - }, - { - "description": "Deprecated: Use `ContextCompaction` item type instead.", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/compacted" - ], - "title": "Thread/compactedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ContextCompactedNotification" - } - }, - "title": "Thread/compactedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "model/rerouted" - ], - "title": "Model/reroutedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ModelReroutedNotification" - } - }, - "title": "Model/reroutedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "warning" - ], - "title": "WarningNotificationMethod" - }, - "params": { - "$ref": "#/definitions/WarningNotification" - } - }, - "title": "WarningNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "guardianWarning" - ], - "title": "GuardianWarningNotificationMethod" - }, - "params": { - "$ref": "#/definitions/GuardianWarningNotification" - } - }, - "title": "GuardianWarningNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "deprecationNotice" - ], - "title": "DeprecationNoticeNotificationMethod" - }, - "params": { - "$ref": "#/definitions/DeprecationNoticeNotification" - } - }, - "title": "DeprecationNoticeNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "configWarning" - ], - "title": "ConfigWarningNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ConfigWarningNotification" - } - }, - "title": "ConfigWarningNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/epiphany/stateUpdated" - ], - "title": "Thread/epiphany/stateUpdatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadEpiphanyStateUpdatedNotification" - } - }, - "title": "Thread/epiphany/stateUpdatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/epiphany/jobsUpdated" - ], - "title": "Thread/epiphany/jobsUpdatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadEpiphanyJobsUpdatedNotification" - } - }, - "title": "Thread/epiphany/jobsUpdatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "fuzzyFileSearch/sessionUpdated" - ], - "title": "FuzzyFileSearch/sessionUpdatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/FuzzyFileSearchSessionUpdatedNotification" - } - }, - "title": "FuzzyFileSearch/sessionUpdatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "fuzzyFileSearch/sessionCompleted" - ], - "title": "FuzzyFileSearch/sessionCompletedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/FuzzyFileSearchSessionCompletedNotification" - } - }, - "title": "FuzzyFileSearch/sessionCompletedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/started" - ], - "title": "Thread/realtime/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeStartedNotification" - } - }, - "title": "Thread/realtime/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/itemAdded" - ], - "title": "Thread/realtime/itemAddedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeItemAddedNotification" - } - }, - "title": "Thread/realtime/itemAddedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/transcript/delta" - ], - "title": "Thread/realtime/transcript/deltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeTranscriptDeltaNotification" - } - }, - "title": "Thread/realtime/transcript/deltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/transcript/done" - ], - "title": "Thread/realtime/transcript/doneNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeTranscriptDoneNotification" - } - }, - "title": "Thread/realtime/transcript/doneNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/outputAudio/delta" - ], - "title": "Thread/realtime/outputAudio/deltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeOutputAudioDeltaNotification" - } - }, - "title": "Thread/realtime/outputAudio/deltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/sdp" - ], - "title": "Thread/realtime/sdpNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeSdpNotification" - } - }, - "title": "Thread/realtime/sdpNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/error" - ], - "title": "Thread/realtime/errorNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeErrorNotification" - } - }, - "title": "Thread/realtime/errorNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/closed" - ], - "title": "Thread/realtime/closedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeClosedNotification" - } - }, - "title": "Thread/realtime/closedNotification" - }, - { - "description": "Notifies the user of world-writable directories on Windows, which cannot be protected by the sandbox.", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "windows/worldWritableWarning" - ], - "title": "Windows/worldWritableWarningNotificationMethod" - }, - "params": { - "$ref": "#/definitions/WindowsWorldWritableWarningNotification" - } - }, - "title": "Windows/worldWritableWarningNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "windowsSandbox/setupCompleted" - ], - "title": "WindowsSandbox/setupCompletedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/WindowsSandboxSetupCompletedNotification" - } - }, - "title": "WindowsSandbox/setupCompletedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "account/login/completed" - ], - "title": "Account/login/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/AccountLoginCompletedNotification" - } - }, - "title": "Account/login/completedNotification" - } - ], "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "AccountLoginCompletedNotification": { - "type": "object", - "required": [ - "success" - ], "properties": { "error": { "type": [ @@ -1155,21 +22,24 @@ "success": { "type": "boolean" } - } + }, + "required": [ + "success" + ], + "type": "object" }, "AccountRateLimitsUpdatedNotification": { - "type": "object", - "required": [ - "rateLimits" - ], "properties": { "rateLimits": { "$ref": "#/definitions/RateLimitSnapshot" } - } + }, + "required": [ + "rateLimits" + ], + "type": "object" }, "AccountUpdatedNotification": { - "type": "object", "properties": { "authMode": { "anyOf": [ @@ -1191,50 +61,50 @@ } ] } - } + }, + "type": "object" }, "AdditionalFileSystemPermissions": { - "type": "object", "properties": { "entries": { + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - } + ] }, "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 1.0 + ] }, "read": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } + ] }, "write": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } + ] } - } + }, + "type": "object" }, "AdditionalNetworkPermissions": { - "type": "object", "properties": { "enabled": { "type": [ @@ -1242,16 +112,10 @@ "null" ] } - } + }, + "type": "object" }, "AgentMessageDeltaNotification": { - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], "properties": { "delta": { "type": "string" @@ -1265,7 +129,14 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "type": "object" }, "AgentPath": { "type": "string" @@ -1275,65 +146,64 @@ "oneOf": [ { "description": "OpenAI API key provided by the caller and stored by Codex.", - "type": "string", "enum": [ "apikey" - ] + ], + "type": "string" }, { "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).", - "type": "string", "enum": [ "chatgpt" - ] + ], + "type": "string" }, { "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE.\n\nChatGPT auth tokens are supplied by an external host app and are only stored in memory. Token refresh must be handled by the external host app.", - "type": "string", "enum": [ "chatgptAuthTokens" - ] + ], + "type": "string" }, { "description": "Programmatic Codex auth backed by a registered Agent Identity.", - "type": "string", "enum": [ "agentIdentity" - ] + ], + "type": "string" } ] }, "AutoReviewDecisionSource": { "description": "[UNSTABLE] Source that produced a terminal approval auto-review decision.", - "type": "string", "enum": [ "agent" - ] + ], + "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -1344,132 +214,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -1480,10 +347,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -1492,36 +362,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -1533,21 +397,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -1559,21 +425,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -1591,46 +457,44 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecOutputDeltaNotification": { "description": "Base64-encoded output chunk emitted for a streaming `command/exec` request.\n\nThese notifications are connection-scoped. If the originating connection closes, the server terminates the process.", - "type": "object", - "required": [ - "capReached", - "deltaBase64", - "processId", - "stream" - ], "properties": { "capReached": { "description": "`true` on the final streamed chunk for a stream when `outputBytesCap` truncated later output on that stream.", @@ -1645,42 +509,42 @@ "type": "string" }, "stream": { - "description": "Output stream for this chunk.", "allOf": [ { "$ref": "#/definitions/CommandExecOutputStream" } - ] + ], + "description": "Output stream for this chunk." } - } + }, + "required": [ + "capReached", + "deltaBase64", + "processId", + "stream" + ], + "type": "object" }, "CommandExecOutputStream": { "description": "Stream label for `command/exec/outputDelta` notifications.", "oneOf": [ { "description": "stdout stream. PTY mode multiplexes terminal output here.", - "type": "string", "enum": [ "stdout" - ] + ], + "type": "string" }, { "description": "stderr stream.", - "type": "string", "enum": [ "stderr" - ] + ], + "type": "string" } ] }, "CommandExecutionOutputDeltaNotification": { - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], "properties": { "delta": { "type": "string" @@ -1694,31 +558,34 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "type": "object" }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "ConfigWarningNotification": { - "type": "object", - "required": [ - "summary" - ], "properties": { "details": { "description": "Optional extra guidance or error details.", @@ -1735,7 +602,6 @@ ] }, "range": { - "description": "Optional range for the error location inside the config file.", "anyOf": [ { "$ref": "#/definitions/TextRange" @@ -1743,21 +609,21 @@ { "type": "null" } - ] + ], + "description": "Optional range for the error location inside the config file." }, "summary": { "description": "Concise summary of the warning.", "type": "string" } - } + }, + "required": [ + "summary" + ], + "type": "object" }, "ContextCompactedNotification": { "description": "Deprecated: Use `ContextCompaction` item type instead.", - "type": "object", - "required": [ - "threadId", - "turnId" - ], "properties": { "threadId": { "type": "string" @@ -1765,14 +631,14 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "threadId", + "turnId" + ], + "type": "object" }, "CreditsSnapshot": { - "type": "object", - "required": [ - "hasCredits", - "unlimited" - ], "properties": { "balance": { "type": [ @@ -1786,13 +652,14 @@ "unlimited": { "type": "boolean" } - } + }, + "required": [ + "hasCredits", + "unlimited" + ], + "type": "object" }, "DeprecationNoticeNotification": { - "type": "object", - "required": [ - "summary" - ], "properties": { "details": { "description": "Optional extra guidance, such as migration steps or rationale.", @@ -1805,72 +672,65 @@ "description": "Concise summary of what is deprecated.", "type": "string" } - } + }, + "required": [ + "summary" + ], + "type": "object" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], "properties": { "accepted_at": { "type": "string" @@ -1914,42 +774,41 @@ "surface": { "type": "string" } - } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" }, "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], "properties": { "acceptance_sketch": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "blockers": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": "string" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "duplicate_of": { "type": [ @@ -1958,10 +817,10 @@ ] }, "evidence_refs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "horizon": { "type": "string" @@ -1973,10 +832,10 @@ "type": "string" }, "lane_hints": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -1985,10 +844,10 @@ "type": "string" }, "source_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } + }, + "type": "array" }, "status": { "type": "string" @@ -2005,14 +864,21 @@ "null" ] } - } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], "properties": { "diff_pressure": { "type": "string" @@ -2027,12 +893,12 @@ "type": "string" }, "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "warning": { "type": [ @@ -2040,21 +906,22 @@ "null" ] } - } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" }, "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], "properties": { "end_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "note": { "type": [ @@ -2066,12 +933,12 @@ "type": "string" }, "start_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "symbol": { "type": [ @@ -2079,22 +946,19 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2108,57 +972,59 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyGraph": { - "type": "object", "properties": { "edges": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphEdge" - } + }, + "type": "array" }, "nodes": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphNode" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], "properties": { "checkpoint_id": { "type": "string" }, "frontier_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "graph_revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -2166,21 +1032,20 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" }, "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": [ @@ -2209,58 +1074,59 @@ "target_id": { "type": "string" } - } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" }, "EpiphanyGraphFrontier": { - "type": "object", "properties": { "active_edge_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "active_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], "properties": { "architecture_node_id": { "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "dataflow_node_id": { "type": "string" @@ -2271,21 +1137,20 @@ "null" ] } - } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" }, "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2314,10 +1179,15 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" }, "EpiphanyGraphs": { - "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -2326,20 +1196,15 @@ "$ref": "#/definitions/EpiphanyGraph" }, "links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphLink" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], "properties": { "description": { "type": "string" @@ -2356,16 +1221,15 @@ "status": { "type": "string" } - } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" }, "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], "properties": { "captured_at_turn_id": { "type": [ @@ -2377,19 +1241,19 @@ "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "disposition": { "$ref": "#/definitions/EpiphanyInvestigationDisposition" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "focus": { "type": "string" @@ -2404,10 +1268,10 @@ ] }, "open_questions": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -2415,23 +1279,23 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" }, "EpiphanyInvestigationDisposition": { - "type": "string", "enum": [ "resume_ready", "regather_required" - ] + ], + "type": "string" }, "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], "properties": { "authority_scope": { "type": [ @@ -2452,16 +1316,16 @@ "$ref": "#/definitions/EpiphanyJobKind" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "owner_role": { "type": "string" @@ -2469,29 +1333,32 @@ "scope": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" }, "EpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "EpiphanyModeKind": { - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], "properties": { "kind": { "anyOf": [ @@ -2506,36 +1373,31 @@ "name": { "type": "string" } - } + }, + "required": [ + "name" + ], + "type": "object" }, "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], "properties": { "acceptance_criteria": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "evidence_required": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2544,25 +1406,25 @@ "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" }, "review_gates": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "risks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "scope": { "$ref": "#/definitions/EpiphanyObjectiveDraftScope" }, "source_item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "status": { "type": "string" @@ -2573,10 +1435,18 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyObjectiveDraftLanePlan": { - "type": "object", "properties": { "body": { "type": [ @@ -2614,45 +1484,39 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyObjectiveDraftScope": { - "type": "object", "properties": { "excludes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2666,17 +1530,16 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], "properties": { "body": { "type": [ @@ -2709,10 +1572,10 @@ "type": "string" }, "tags": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": "string" @@ -2723,20 +1586,23 @@ "null" ] } - } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" }, "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], "properties": { "blocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": [ @@ -2766,10 +1632,10 @@ ] }, "unblocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "urgency": { "type": [ @@ -2780,19 +1646,20 @@ "value": { "type": "string" } - } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" }, "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], "properties": { "assignees": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "author": { "type": [ @@ -2813,11 +1680,11 @@ ] }, "database_id": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "external_id": { "type": [ @@ -2838,21 +1705,21 @@ ] }, "issue_number": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "kind": { "type": "string" }, "labels": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "milestone": { "type": [ @@ -2902,34 +1769,37 @@ "null" ] } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "EpiphanyPlanningState": { - "type": "object", "properties": { "backlog_items": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyBacklogItem" - } + }, + "type": "array" }, "captures": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningCapture" - } + }, + "type": "array" }, "objective_drafts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObjectiveDraft" - } + }, + "type": "array" }, "roadmap_streams": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRoadmapStream" - } + }, + "type": "array" }, "workspace_root": { "type": [ @@ -2937,33 +1807,29 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], "properties": { "exact_available": { "type": "boolean" }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "path_prefix": { "type": "string" @@ -2975,26 +1841,27 @@ "type": "string" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" } - } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" }, "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], "properties": { "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "index_revision": { "type": [ @@ -3003,82 +1870,79 @@ ] }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "last_indexed_at_unix_seconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "semantic_available": { "type": "boolean" }, "shards": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRetrievalShardSummary" - } + }, + "type": "array" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" }, "workspace_root": { "type": "string" } - } + }, + "required": [ + "workspace_root" + ], + "type": "object" }, "EpiphanyRetrievalStatus": { - "type": "string", "enum": [ "unavailable", "ready", "stale", "indexing" - ] + ], + "type": "string" }, "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], "properties": { "blocked_by": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "near_term_focus": { "type": [ @@ -3101,18 +1965,16 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" }, "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], "properties": { "authority_scope": { "type": "string" @@ -3124,16 +1986,16 @@ "type": "string" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "role_id": { "type": "string" @@ -3150,10 +2012,18 @@ "surface": { "type": "string" } - } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" }, "EpiphanyScratchPad": { - "type": "object", "properties": { "hypothesis": { "type": [ @@ -3168,10 +2038,10 @@ ] }, "notes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -3179,15 +2049,10 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], "properties": { "id": { "type": "string" @@ -3204,19 +2069,21 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" }, "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], "properties": { "acceptance_receipts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } + }, + "type": "array" }, "active_subgoal_id": { "type": [ @@ -3258,10 +2125,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - } + }, + "type": "array" }, "investigation_checkpoint": { "anyOf": [ @@ -3274,10 +2141,10 @@ ] }, "job_bindings": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - } + }, + "type": "array" }, "last_updated_turn_id": { "type": [ @@ -3302,19 +2169,19 @@ ] }, "observations": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - } + }, + "type": "array" }, "planning": { "$ref": "#/definitions/EpiphanyPlanningState" }, "recent_evidence": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - } + }, + "type": "array" }, "retrieval": { "anyOf": [ @@ -3327,15 +2194,15 @@ ] }, "revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "runtime_links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - } + }, + "type": "array" }, "scratch": { "anyOf": [ @@ -3348,21 +2215,18 @@ ] }, "subgoals": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - } + }, + "type": "array" } - } + }, + "required": [ + "revision" + ], + "type": "object" }, "ErrorNotification": { - "type": "object", - "required": [ - "error", - "threadId", - "turnId", - "willRetry" - ], "properties": { "error": { "$ref": "#/definitions/TurnError" @@ -3376,16 +2240,16 @@ "willRetry": { "type": "boolean" } - } + }, + "required": [ + "error", + "threadId", + "turnId", + "willRetry" + ], + "type": "object" }, "FileChangeOutputDeltaNotification": { - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], "properties": { "delta": { "type": "string" @@ -3399,22 +2263,22 @@ "turnId": { "type": "string" } - } - }, - "FileChangePatchUpdatedNotification": { - "type": "object", + }, "required": [ - "changes", + "delta", "itemId", "threadId", "turnId" ], + "type": "object" + }, + "FileChangePatchUpdatedNotification": { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "itemId": { "type": "string" @@ -3425,86 +2289,88 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "changes", + "itemId", + "threadId", + "turnId" + ], + "type": "object" }, "FileSystemAccessMode": { - "type": "string", "enum": [ "read", "write", "none" - ] + ], + "type": "string" }, "FileSystemPath": { "oneOf": [ { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "path" ], - "title": "PathFileSystemPathType" + "title": "PathFileSystemPathType", + "type": "string" } }, - "title": "PathFileSystemPath" - }, - { - "type": "object", "required": [ - "pattern", + "path", "type" ], + "title": "PathFileSystemPath", + "type": "object" + }, + { "properties": { "pattern": { "type": "string" }, "type": { - "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType" + "title": "GlobPatternFileSystemPathType", + "type": "string" } }, - "title": "GlobPatternFileSystemPath" + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType" + "title": "SpecialFileSystemPathType", + "type": "string" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "title": "SpecialFileSystemPath" + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" } ] }, "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -3512,66 +2378,67 @@ "path": { "$ref": "#/definitions/FileSystemPath" } - } + }, + "required": [ + "access", + "path" + ], + "type": "object" }, "FileSystemSpecialPath": { "oneOf": [ { - "type": "object", - "required": [ - "kind" - ], "properties": { "kind": { - "type": "string", "enum": [ "root" - ] + ], + "type": "string" } }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "minimal" - ] + ], + "type": "string" } }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "current_working_directory" - ] + ], + "type": "string" } }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "project_roots" - ] + ], + "type": "string" }, "subpath": { "type": [ @@ -3580,50 +2447,49 @@ ] } }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "tmpdir" - ] + ], + "type": "string" } }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" }, { - "type": "object", - "required": [ - "kind", - "path" - ], "properties": { "kind": { - "type": "string", "enum": [ "unknown" - ] + ], + "type": "string" }, "path": { "type": "string" @@ -3634,17 +2500,16 @@ "null" ] } - } + }, + "required": [ + "kind", + "path" + ], + "type": "object" } ] }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -3655,60 +2520,58 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "FsChangedNotification": { "description": "Filesystem watch notification emitted for `fs/watch` subscribers.", - "type": "object", - "required": [ - "changedPaths", - "watchId" - ], "properties": { "changedPaths": { "description": "File or directory paths associated with this event.", - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" }, "watchId": { "description": "Watch identifier previously provided to `fs/watch`.", "type": "string" } - } + }, + "required": [ + "changedPaths", + "watchId" + ], + "type": "object" }, "FuzzyFileSearchMatchType": { - "type": "string", "enum": [ "file", "directory" - ] + ], + "type": "string" }, "FuzzyFileSearchResult": { "description": "Superset of [`codex_file_search::FileMatch`]", - "type": "object", - "required": [ - "file_name", - "match_type", - "path", - "root", - "score" - ], "properties": { "file_name": { "type": "string" }, "indices": { + "items": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, "type": [ "array", "null" - ], - "items": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - } + ] }, "match_type": { "$ref": "#/definitions/FuzzyFileSearchMatchType" @@ -3720,36 +2583,38 @@ "type": "string" }, "score": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" } - } + }, + "required": [ + "file_name", + "match_type", + "path", + "root", + "score" + ], + "type": "object" }, "FuzzyFileSearchSessionCompletedNotification": { - "type": "object", - "required": [ - "sessionId" - ], "properties": { "sessionId": { "type": "string" } - } - }, - "FuzzyFileSearchSessionUpdatedNotification": { - "type": "object", + }, "required": [ - "files", - "query", "sessionId" ], + "type": "object" + }, + "FuzzyFileSearchSessionUpdatedNotification": { "properties": { "files": { - "type": "array", "items": { "$ref": "#/definitions/FuzzyFileSearchResult" - } + }, + "type": "array" }, "query": { "type": "string" @@ -3757,10 +2622,15 @@ "sessionId": { "type": "string" } - } + }, + "required": [ + "files", + "query", + "sessionId" + ], + "type": "object" }, "GitInfo": { - "type": "object", "properties": { "branch": { "type": [ @@ -3780,14 +2650,11 @@ "null" ] } - } + }, + "type": "object" }, "GuardianApprovalReview": { "description": "[UNSTABLE] Temporary approval auto-review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.", - "type": "object", - "required": [ - "status" - ], "properties": { "rationale": { "type": [ @@ -3818,18 +2685,15 @@ } ] } - } + }, + "required": [ + "status" + ], + "type": "object" }, "GuardianApprovalReviewAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "cwd", - "source", - "type" - ], "properties": { "command": { "type": "string" @@ -3841,30 +2705,29 @@ "$ref": "#/definitions/GuardianCommandSource" }, "type": { - "type": "string", "enum": [ "command" ], - "title": "CommandGuardianApprovalReviewActionType" + "title": "CommandGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "CommandGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "argv", + "command", "cwd", - "program", "source", "type" ], + "title": "CommandGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "argv": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "cwd": { "$ref": "#/definitions/AbsolutePathBuf" @@ -3876,59 +2739,59 @@ "$ref": "#/definitions/GuardianCommandSource" }, "type": { - "type": "string", "enum": [ "execve" ], - "title": "ExecveGuardianApprovalReviewActionType" + "title": "ExecveGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "ExecveGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ + "argv", "cwd", - "files", + "program", + "source", "type" ], + "title": "ExecveGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "cwd": { "$ref": "#/definitions/AbsolutePathBuf" }, "files": { - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "applyPatch" ], - "title": "ApplyPatchGuardianApprovalReviewActionType" + "title": "ApplyPatchGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "ApplyPatchGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "host", - "port", - "protocol", - "target", + "cwd", + "files", "type" ], + "title": "ApplyPatchGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "host": { "type": "string" }, "port": { - "type": "integer", "format": "uint16", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "protocol": { "$ref": "#/definitions/NetworkApprovalProtocol" @@ -3937,22 +2800,24 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "networkAccess" ], - "title": "NetworkAccessGuardianApprovalReviewActionType" + "title": "NetworkAccessGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "NetworkAccessGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "server", - "toolName", + "host", + "port", + "protocol", + "target", "type" ], + "title": "NetworkAccessGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "connectorId": { "type": [ @@ -3979,21 +2844,22 @@ ] }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallGuardianApprovalReviewActionType" + "title": "McpToolCallGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "McpToolCallGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "permissions", + "server", + "toolName", "type" ], + "title": "McpToolCallGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "permissions": { "$ref": "#/definitions/RequestPermissionProfile" @@ -4005,61 +2871,61 @@ ] }, "type": { - "type": "string", "enum": [ "requestPermissions" ], - "title": "RequestPermissionsGuardianApprovalReviewActionType" + "title": "RequestPermissionsGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "RequestPermissionsGuardianApprovalReviewAction" + "required": [ + "permissions", + "type" + ], + "title": "RequestPermissionsGuardianApprovalReviewAction", + "type": "object" } ] }, "GuardianApprovalReviewStatus": { "description": "[UNSTABLE] Lifecycle state for an approval auto-review.", - "type": "string", "enum": [ "inProgress", "approved", "denied", "timedOut", "aborted" - ] + ], + "type": "string" }, "GuardianCommandSource": { - "type": "string", "enum": [ "shell", "unifiedExec" - ] + ], + "type": "string" }, "GuardianRiskLevel": { "description": "[UNSTABLE] Risk level assigned by approval auto-review.", - "type": "string", "enum": [ "low", "medium", "high", "critical" - ] + ], + "type": "string" }, "GuardianUserAuthorization": { "description": "[UNSTABLE] Authorization level assigned by approval auto-review.", - "type": "string", "enum": [ "unknown", "low", "medium", "high" - ] + ], + "type": "string" }, "GuardianWarningNotification": { - "type": "object", - "required": [ - "message", - "threadId" - ], "properties": { "message": { "description": "Concise guardian warning message for the user.", @@ -4069,14 +2935,14 @@ "description": "Thread target for the guardian warning.", "type": "string" } - } - }, - "HookCompletedNotification": { - "type": "object", + }, "required": [ - "run", + "message", "threadId" ], + "type": "object" + }, + "HookCompletedNotification": { "properties": { "run": { "$ref": "#/definitions/HookRunSummary" @@ -4090,10 +2956,14 @@ "null" ] } - } + }, + "required": [ + "run", + "threadId" + ], + "type": "object" }, "HookEventName": { - "type": "string", "enum": [ "preToolUse", "permissionRequest", @@ -4101,29 +2971,25 @@ "sessionStart", "userPromptSubmit", "stop" - ] + ], + "type": "string" }, "HookExecutionMode": { - "type": "string", "enum": [ "sync", "async" - ] + ], + "type": "string" }, "HookHandlerType": { - "type": "string", "enum": [ "command", "prompt", "agent" - ] + ], + "type": "string" }, "HookOutputEntry": { - "type": "object", - "required": [ - "kind", - "text" - ], "properties": { "kind": { "$ref": "#/definitions/HookOutputEntryKind" @@ -4131,24 +2997,24 @@ "text": { "type": "string" } - } + }, + "required": [ + "kind", + "text" + ], + "type": "object" }, "HookOutputEntryKind": { - "type": "string", "enum": [ "warning", "stop", "feedback", "context", "error" - ] + ], + "type": "string" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -4156,56 +3022,48 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "HookRunStatus": { - "type": "string", "enum": [ "running", "completed", "failed", "blocked", "stopped" - ] + ], + "type": "string" }, "HookRunSummary": { - "type": "object", - "required": [ - "displayOrder", - "entries", - "eventName", - "executionMode", - "handlerType", - "id", - "scope", - "sourcePath", - "startedAt", - "status" - ], "properties": { "completedAt": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "displayOrder": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "durationMs": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "entries": { - "type": "array", "items": { "$ref": "#/definitions/HookOutputEntry" - } + }, + "type": "array" }, "eventName": { "$ref": "#/definitions/HookEventName" @@ -4223,19 +3081,19 @@ "$ref": "#/definitions/HookScope" }, "source": { - "default": "unknown", "allOf": [ { "$ref": "#/definitions/HookSource" } - ] + ], + "default": "unknown" }, "sourcePath": { "$ref": "#/definitions/AbsolutePathBuf" }, "startedAt": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "status": { "$ref": "#/definitions/HookRunStatus" @@ -4246,17 +3104,29 @@ "null" ] } - } + }, + "required": [ + "displayOrder", + "entries", + "eventName", + "executionMode", + "handlerType", + "id", + "scope", + "sourcePath", + "startedAt", + "status" + ], + "type": "object" }, "HookScope": { - "type": "string", "enum": [ "thread", "turn" - ] + ], + "type": "string" }, "HookSource": { - "type": "string", "enum": [ "system", "user", @@ -4266,14 +3136,10 @@ "legacyManagedConfigFile", "legacyManagedConfigMdm", "unknown" - ] + ], + "type": "string" }, "HookStartedNotification": { - "type": "object", - "required": [ - "run", - "threadId" - ], "properties": { "run": { "$ref": "#/definitions/HookRunSummary" @@ -4287,15 +3153,14 @@ "null" ] } - } + }, + "required": [ + "run", + "threadId" + ], + "type": "object" }, "ItemCompletedNotification": { - "type": "object", - "required": [ - "item", - "threadId", - "turnId" - ], "properties": { "item": { "$ref": "#/definitions/ThreadItem" @@ -4306,19 +3171,16 @@ "turnId": { "type": "string" } - } - }, - "ItemGuardianApprovalReviewCompletedNotification": { - "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", - "type": "object", + }, "required": [ - "action", - "decisionSource", - "review", - "reviewId", + "item", "threadId", "turnId" ], + "type": "object" + }, + "ItemGuardianApprovalReviewCompletedNotification": { + "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", "properties": { "action": { "$ref": "#/definitions/GuardianApprovalReviewAction" @@ -4346,18 +3208,19 @@ "turnId": { "type": "string" } - } - }, - "ItemGuardianApprovalReviewStartedNotification": { - "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", - "type": "object", + }, "required": [ "action", + "decisionSource", "review", "reviewId", "threadId", "turnId" ], + "type": "object" + }, + "ItemGuardianApprovalReviewStartedNotification": { + "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", "properties": { "action": { "$ref": "#/definitions/GuardianApprovalReviewAction" @@ -4382,15 +3245,17 @@ "turnId": { "type": "string" } - } - }, - "ItemStartedNotification": { - "type": "object", + }, "required": [ - "item", + "action", + "review", + "reviewId", "threadId", "turnId" ], + "type": "object" + }, + "ItemStartedNotification": { "properties": { "item": { "$ref": "#/definitions/ThreadItem" @@ -4401,14 +3266,15 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "item", + "threadId", + "turnId" + ], + "type": "object" }, "McpServerOauthLoginCompletedNotification": { - "type": "object", - "required": [ - "name", - "success" - ], "properties": { "error": { "type": [ @@ -4422,23 +3288,23 @@ "success": { "type": "boolean" } - } + }, + "required": [ + "name", + "success" + ], + "type": "object" }, "McpServerStartupState": { - "type": "string", "enum": [ "starting", "ready", "failed", "cancelled" - ] + ], + "type": "string" }, "McpServerStatusUpdatedNotification": { - "type": "object", - "required": [ - "name", - "status" - ], "properties": { "error": { "type": [ @@ -4452,27 +3318,25 @@ "status": { "$ref": "#/definitions/McpServerStartupState" } - } + }, + "required": [ + "name", + "status" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallProgressNotification": { - "type": "object", - "required": [ - "itemId", - "message", - "threadId", - "turnId" - ], "properties": { "itemId": { "type": "string" @@ -4486,69 +3350,69 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "itemId", + "message", + "threadId", + "turnId" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -4556,42 +3420,41 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "ModelRerouteReason": { - "type": "string", "enum": [ "highRiskCyberActivity" - ] + ], + "type": "string" }, "ModelReroutedNotification": { - "type": "object", - "required": [ - "fromModel", - "reason", - "threadId", - "toModel", - "turnId" - ], "properties": { "fromModel": { "type": "string" @@ -4608,72 +3471,76 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "fromModel", + "reason", + "threadId", + "toModel", + "turnId" + ], + "type": "object" }, "NetworkApprovalProtocol": { - "type": "string", "enum": [ "http", "https", "socks5Tcp", "socks5Udp" - ] + ], + "type": "string" }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -4682,26 +3549,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "PlanDeltaNotification": { "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items. Clients should not assume concatenated deltas match the completed plan item content.", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], "properties": { "delta": { "type": "string" @@ -4715,10 +3579,16 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "type": "object" }, "PlanType": { - "type": "string", "enum": [ "free", "go", @@ -4732,20 +3602,20 @@ "enterprise", "edu", "unknown" - ] + ], + "type": "string" }, "RateLimitReachedType": { - "type": "string", "enum": [ "rate_limit_reached", "workspace_owner_credits_depleted", "workspace_member_credits_depleted", "workspace_owner_usage_limit_reached", "workspace_member_usage_limit_reached" - ] + ], + "type": "string" }, "RateLimitSnapshot": { - "type": "object", "properties": { "credits": { "anyOf": [ @@ -4809,44 +3679,44 @@ } ] } - } + }, + "type": "object" }, "RateLimitWindow": { - "type": "object", + "properties": { + "resetsAt": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "usedPercent": { + "format": "int32", + "type": "integer" + }, + "windowDurationMins": { + "format": "int64", + "type": [ + "integer", + "null" + ] + } + }, "required": [ "usedPercent" ], - "properties": { - "resetsAt": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "usedPercent": { - "type": "integer", - "format": "int32" - }, - "windowDurationMins": { - "type": [ - "integer", - "null" - ], - "format": "int64" - } - } + "type": "object" }, "RealtimeConversationVersion": { - "type": "string", "enum": [ "v1", "v2" - ] + ], + "type": "string" }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -4854,23 +3724,17 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "ReasoningSummaryPartAddedNotification": { - "type": "object", - "required": [ - "itemId", - "summaryIndex", - "threadId", - "turnId" - ], "properties": { "itemId": { "type": "string" }, "summaryIndex": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "threadId": { "type": "string" @@ -4878,17 +3742,16 @@ "turnId": { "type": "string" } - } - }, - "ReasoningSummaryTextDeltaNotification": { - "type": "object", + }, "required": [ - "delta", "itemId", "summaryIndex", "threadId", "turnId" ], + "type": "object" + }, + "ReasoningSummaryTextDeltaNotification": { "properties": { "delta": { "type": "string" @@ -4897,8 +3760,8 @@ "type": "string" }, "summaryIndex": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "threadId": { "type": "string" @@ -4906,10 +3769,35 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "delta", + "itemId", + "summaryIndex", + "threadId", + "turnId" + ], + "type": "object" }, "ReasoningTextDeltaNotification": { - "type": "object", + "properties": { + "contentIndex": { + "format": "int64", + "type": "integer" + }, + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, "required": [ "contentIndex", "delta", @@ -4917,24 +3805,7 @@ "threadId", "turnId" ], - "properties": { - "contentIndex": { - "type": "integer", - "format": "int64" - }, - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } + "type": "object" }, "RequestId": { "anyOf": [ @@ -4942,13 +3813,13 @@ "type": "string" }, { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } ] }, "RequestPermissionProfile": { - "type": "object", + "additionalProperties": false, "properties": { "fileSystem": { "anyOf": [ @@ -4971,14 +3842,9 @@ ] } }, - "additionalProperties": false + "type": "object" }, "ServerRequestResolvedNotification": { - "type": "object", - "required": [ - "requestId", - "threadId" - ], "properties": { "requestId": { "$ref": "#/definitions/RequestId" @@ -4986,70 +3852,67 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "requestId", + "threadId" + ], + "type": "object" }, "SessionSource": { "oneOf": [ { - "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "custom" - ], + "additionalProperties": false, "properties": { "custom": { "type": "string" } }, - "additionalProperties": false, - "title": "CustomSessionSource" + "required": [ + "custom" + ], + "title": "CustomSessionSource", + "type": "object" }, { - "type": "object", - "required": [ - "subAgent" - ], + "additionalProperties": false, "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "additionalProperties": false, - "title": "SubAgentSessionSource" + "required": [ + "subAgent" + ], + "title": "SubAgentSessionSource", + "type": "object" } ] }, "SubAgentSource": { "oneOf": [ { - "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "thread_spawn" - ], + "additionalProperties": false, "properties": { "thread_spawn": { - "type": "object", - "required": [ - "depth", - "parent_thread_id" - ], "properties": { "agent_nickname": { "default": null, @@ -5059,7 +3922,6 @@ ] }, "agent_path": { - "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -5067,7 +3929,8 @@ { "type": "null" } - ] + ], + "default": null }, "agent_role": { "default": null, @@ -5077,42 +3940,42 @@ ] }, "depth": { - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - } + }, + "required": [ + "depth", + "parent_thread_id" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ThreadSpawnSubAgentSource" + "required": [ + "thread_spawn" + ], + "title": "ThreadSpawnSubAgentSource", + "type": "object" }, { - "type": "object", - "required": [ - "other" - ], + "additionalProperties": false, "properties": { "other": { "type": "string" } }, - "additionalProperties": false, - "title": "OtherSubAgentSource" + "required": [ + "other" + ], + "title": "OtherSubAgentSource", + "type": "object" } ] }, "TerminalInteractionNotification": { - "type": "object", - "required": [ - "itemId", - "processId", - "stdin", - "threadId", - "turnId" - ], "properties": { "itemId": { "type": "string" @@ -5129,21 +3992,25 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "itemId", + "processId", + "stdin", + "threadId", + "turnId" + ], + "type": "object" }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -5152,35 +4019,34 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "TextPosition": { - "type": "object", + "properties": { + "column": { + "description": "1-based column number (in Unicode scalar values).", + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "line": { + "description": "1-based line number.", + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "column", "line" ], - "properties": { - "column": { - "description": "1-based column number (in Unicode scalar values).", - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "line": { - "description": "1-based line number.", - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "TextRange": { - "type": "object", - "required": [ - "end", - "start" - ], "properties": { "end": { "$ref": "#/definitions/TextPosition" @@ -5188,23 +4054,14 @@ "start": { "$ref": "#/definitions/TextPosition" } - } + }, + "required": [ + "end", + "start" + ], + "type": "object" }, "Thread": { - "type": "object", - "required": [ - "cliVersion", - "createdAt", - "cwd", - "ephemeral", - "id", - "modelProvider", - "preview", - "source", - "status", - "turns", - "updatedAt" - ], "properties": { "agentNickname": { "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", @@ -5226,23 +4083,22 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "cwd": { - "description": "Working directory captured for the thread.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Working directory captured for the thread." }, "ephemeral": { "description": "Whether the thread is ephemeral and should not be materialized on disk.", "type": "boolean" }, "epiphanyState": { - "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads.", "anyOf": [ { "$ref": "#/definitions/EpiphanyThreadState" @@ -5250,7 +4106,8 @@ { "type": "null" } - ] + ], + "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads." }, "forkedFromId": { "description": "Source thread id when this thread was created by forking another thread.", @@ -5260,7 +4117,6 @@ ] }, "gitInfo": { - "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -5268,7 +4124,8 @@ { "type": "null" } - ] + ], + "description": "Optional Git metadata captured when the thread was created." }, "id": { "type": "string" @@ -5296,79 +4153,85 @@ "type": "string" }, "source": { - "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).", "allOf": [ { "$ref": "#/definitions/SessionSource" } - ] + ], + "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." }, "status": { - "description": "Current runtime status for the thread.", "allOf": [ { "$ref": "#/definitions/ThreadStatus" } - ] + ], + "description": "Current runtime status for the thread." }, "turns": { "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/Turn" - } + }, + "type": "array" }, "updatedAt": { "description": "Unix timestamp (in seconds) when the thread was last updated.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } - } + }, + "required": [ + "cliVersion", + "createdAt", + "cwd", + "ephemeral", + "id", + "modelProvider", + "preview", + "source", + "status", + "turns", + "updatedAt" + ], + "type": "object" }, "ThreadActiveFlag": { - "type": "string", "enum": [ "waitingOnApproval", "waitingOnUserInput" - ] + ], + "type": "string" }, "ThreadArchivedNotification": { - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "type": "object" }, "ThreadClosedNotification": { - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "type": "object" }, "ThreadEpiphanyJob": { - "type": "object", - "required": [ - "id", - "kind", - "ownerRole", - "scope", - "status" - ], "properties": { "activeThreadIds": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "authorityScope": { "type": [ @@ -5392,30 +4255,30 @@ "type": "string" }, "itemsProcessed": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "itemsTotal": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "kind": { "$ref": "#/definitions/ThreadEpiphanyJobKind" }, "lastCheckpointAtUnixSeconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "launcherJobId": { "type": [ @@ -5424,16 +4287,16 @@ ] }, "linkedGraphNodeIds": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linkedSubgoalIds": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "ownerRole": { "type": "string" @@ -5450,19 +4313,26 @@ "status": { "$ref": "#/definitions/ThreadEpiphanyJobStatus" } - } + }, + "required": [ + "id", + "kind", + "ownerRole", + "scope", + "status" + ], + "type": "object" }, "ThreadEpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "ThreadEpiphanyJobStatus": { - "type": "string", "enum": [ "idle", "needed", @@ -5473,45 +4343,45 @@ "cancelled", "blocked", "unavailable" - ] + ], + "type": "string" }, "ThreadEpiphanyJobsUpdatedNotification": { - "type": "object", - "required": [ - "source", - "threadId" - ], "properties": { "jobs": { - "type": "array", "items": { "$ref": "#/definitions/ThreadEpiphanyJob" - } + }, + "type": "array" }, "source": { "$ref": "#/definitions/ThreadEpiphanyJobsUpdatedSource" }, "stateRevision": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "threadId": { "type": "string" } - } + }, + "required": [ + "source", + "threadId" + ], + "type": "object" }, "ThreadEpiphanyJobsUpdatedSource": { - "type": "string", "enum": [ "runtimeProgress" - ] + ], + "type": "string" }, "ThreadEpiphanyStateUpdatedField": { - "type": "string", "enum": [ "objective", "activeSubgoalId", @@ -5530,31 +4400,24 @@ "churn", "mode", "planning" - ] + ], + "type": "string" }, "ThreadEpiphanyStateUpdatedNotification": { - "type": "object", - "required": [ - "changedFields", - "epiphanyState", - "revision", - "source", - "threadId" - ], "properties": { "changedFields": { - "type": "array", "items": { "$ref": "#/definitions/ThreadEpiphanyStateUpdatedField" - } + }, + "type": "array" }, "epiphanyState": { "$ref": "#/definitions/EpiphanyThreadState" }, "revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "source": { "$ref": "#/definitions/ThreadEpiphanyStateUpdatedSource" @@ -5562,10 +4425,17 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "changedFields", + "epiphanyState", + "revision", + "source", + "threadId" + ], + "type": "object" }, "ThreadEpiphanyStateUpdatedSource": { - "type": "string", "enum": [ "update", "promote", @@ -5573,7 +4443,8 @@ "jobInterrupt", "reorientAccept", "roleAccept" - ] + ], + "type": "string" }, "ThreadId": { "type": "string" @@ -5581,72 +4452,65 @@ "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -5654,10 +4518,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -5665,29 +4529,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -5696,59 +4561,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -5763,34 +4625,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -5803,40 +4665,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -5845,34 +4709,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -5913,42 +4775,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -5972,33 +4835,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -6019,7 +4880,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -6027,52 +4887,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -6091,22 +4956,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -6115,23 +4980,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -6159,22 +5023,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -6183,22 +5048,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -6207,42 +5072,44 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "ThreadNameUpdatedNotification": { - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" @@ -6253,16 +5120,14 @@ "null" ] } - } + }, + "required": [ + "threadId" + ], + "type": "object" }, "ThreadRealtimeAudioChunk": { "description": "EXPERIMENTAL - thread realtime audio chunk.", - "type": "object", - "required": [ - "data", - "numChannels", - "sampleRate" - ], "properties": { "data": { "type": "string" @@ -6274,31 +5139,33 @@ ] }, "numChannels": { - "type": "integer", "format": "uint16", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "sampleRate": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "samplesPerChannel": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] } - } + }, + "required": [ + "data", + "numChannels", + "sampleRate" + ], + "type": "object" }, "ThreadRealtimeClosedNotification": { "description": "EXPERIMENTAL - emitted when thread realtime transport closes.", - "type": "object", - "required": [ - "threadId" - ], "properties": { "reason": { "type": [ @@ -6309,15 +5176,14 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "type": "object" }, "ThreadRealtimeErrorNotification": { "description": "EXPERIMENTAL - emitted when thread realtime encounters an error.", - "type": "object", - "required": [ - "message", - "threadId" - ], "properties": { "message": { "type": "string" @@ -6325,29 +5191,29 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "message", + "threadId" + ], + "type": "object" }, "ThreadRealtimeItemAddedNotification": { "description": "EXPERIMENTAL - raw non-audio thread realtime item emitted by the backend.", - "type": "object", - "required": [ - "item", - "threadId" - ], "properties": { "item": true, "threadId": { "type": "string" } - } + }, + "required": [ + "item", + "threadId" + ], + "type": "object" }, "ThreadRealtimeOutputAudioDeltaNotification": { "description": "EXPERIMENTAL - streamed output audio emitted by thread realtime.", - "type": "object", - "required": [ - "audio", - "threadId" - ], "properties": { "audio": { "$ref": "#/definitions/ThreadRealtimeAudioChunk" @@ -6355,15 +5221,15 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "audio", + "threadId" + ], + "type": "object" }, "ThreadRealtimeSdpNotification": { "description": "EXPERIMENTAL - emitted with the remote SDP for a WebRTC realtime session.", - "type": "object", - "required": [ - "sdp", - "threadId" - ], "properties": { "sdp": { "type": "string" @@ -6371,15 +5237,15 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "sdp", + "threadId" + ], + "type": "object" }, "ThreadRealtimeStartedNotification": { "description": "EXPERIMENTAL - emitted when thread realtime startup is accepted.", - "type": "object", - "required": [ - "threadId", - "version" - ], "properties": { "sessionId": { "type": [ @@ -6393,16 +5259,15 @@ "version": { "$ref": "#/definitions/RealtimeConversationVersion" } - } + }, + "required": [ + "threadId", + "version" + ], + "type": "object" }, "ThreadRealtimeTranscriptDeltaNotification": { "description": "EXPERIMENTAL - flat transcript delta emitted whenever realtime transcript text changes.", - "type": "object", - "required": [ - "delta", - "role", - "threadId" - ], "properties": { "delta": { "description": "Live transcript delta from the realtime event.", @@ -6414,16 +5279,16 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "delta", + "role", + "threadId" + ], + "type": "object" }, "ThreadRealtimeTranscriptDoneNotification": { "description": "EXPERIMENTAL - final transcript text emitted when realtime completes a transcript part.", - "type": "object", - "required": [ - "role", - "text", - "threadId" - ], "properties": { "role": { "type": "string" @@ -6435,100 +5300,101 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "role", + "text", + "threadId" + ], + "type": "object" }, "ThreadStartedNotification": { - "type": "object", - "required": [ - "thread" - ], "properties": { "thread": { "$ref": "#/definitions/Thread" } - } + }, + "required": [ + "thread" + ], + "type": "object" }, "ThreadStatus": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType" + "title": "NotLoadedThreadStatusType", + "type": "string" } }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType" + "title": "IdleThreadStatusType", + "type": "string" } }, - "title": "IdleThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "IdleThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType" + "title": "SystemErrorThreadStatusType", + "type": "string" } }, - "title": "SystemErrorThreadStatus" + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" }, { - "type": "object", + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, "required": [ "activeFlags", "type" ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" + "title": "ActiveThreadStatus", + "type": "object" } ] }, "ThreadStatusChangedNotification": { - "type": "object", - "required": [ - "status", - "threadId" - ], "properties": { "status": { "$ref": "#/definitions/ThreadStatus" @@ -6536,44 +5402,43 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "status", + "threadId" + ], + "type": "object" }, "ThreadTokenUsage": { - "type": "object", - "required": [ - "last", - "total" - ], "properties": { "last": { "$ref": "#/definitions/TokenUsageBreakdown" }, "modelAutoCompactTokenLimit": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "modelContextWindow": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "total": { "$ref": "#/definitions/TokenUsageBreakdown" } - } + }, + "required": [ + "last", + "total" + ], + "type": "object" }, "ThreadTokenUsageUpdatedNotification": { - "type": "object", - "required": [ - "threadId", - "tokenUsage", - "turnId" - ], "properties": { "threadId": { "type": "string" @@ -6584,21 +5449,48 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "threadId", + "tokenUsage", + "turnId" + ], + "type": "object" }, "ThreadUnarchivedNotification": { - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "type": "object" }, "TokenUsageBreakdown": { - "type": "object", + "properties": { + "cachedInputTokens": { + "format": "int64", + "type": "integer" + }, + "inputTokens": { + "format": "int64", + "type": "integer" + }, + "outputTokens": { + "format": "int64", + "type": "integer" + }, + "reasoningOutputTokens": { + "format": "int64", + "type": "integer" + }, + "totalTokens": { + "format": "int64", + "type": "integer" + } + }, "required": [ "cachedInputTokens", "inputTokens", @@ -6606,55 +5498,27 @@ "reasoningOutputTokens", "totalTokens" ], - "properties": { - "cachedInputTokens": { - "type": "integer", - "format": "int64" - }, - "inputTokens": { - "type": "integer", - "format": "int64" - }, - "outputTokens": { - "type": "integer", - "format": "int64" - }, - "reasoningOutputTokens": { - "type": "integer", - "format": "int64" - }, - "totalTokens": { - "type": "integer", - "format": "int64" - } - } + "type": "object" }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -6662,37 +5526,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnCompletedNotification": { - "type": "object", - "required": [ - "threadId", - "turn" - ], "properties": { "threadId": { "type": "string" @@ -6700,16 +5566,15 @@ "turn": { "$ref": "#/definitions/Turn" } - } + }, + "required": [ + "threadId", + "turn" + ], + "type": "object" }, "TurnDiffUpdatedNotification": { "description": "Notification that the turn-level unified diff has changed. Contains the latest aggregated diff across all file changes in the turn.", - "type": "object", - "required": [ - "diff", - "threadId", - "turnId" - ], "properties": { "diff": { "type": "string" @@ -6720,13 +5585,15 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "diff", + "threadId", + "turnId" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -6748,14 +5615,13 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnPlanStep": { - "type": "object", - "required": [ - "status", - "step" - ], "properties": { "status": { "$ref": "#/definitions/TurnPlanStepStatus" @@ -6763,23 +5629,22 @@ "step": { "type": "string" } - } + }, + "required": [ + "status", + "step" + ], + "type": "object" }, "TurnPlanStepStatus": { - "type": "string", "enum": [ "pending", "inProgress", "completed" - ] + ], + "type": "string" }, "TurnPlanUpdatedNotification": { - "type": "object", - "required": [ - "plan", - "threadId", - "turnId" - ], "properties": { "explanation": { "type": [ @@ -6788,10 +5653,10 @@ ] }, "plan": { - "type": "array", "items": { "$ref": "#/definitions/TurnPlanStep" - } + }, + "type": "array" }, "threadId": { "type": "string" @@ -6799,14 +5664,15 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "plan", + "threadId", + "turnId" + ], + "type": "object" }, "TurnStartedNotification": { - "type": "object", - "required": [ - "threadId", - "turn" - ], "properties": { "threadId": { "type": "string" @@ -6814,94 +5680,93 @@ "turn": { "$ref": "#/definitions/Turn" } - } + }, + "required": [ + "threadId", + "turn" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -6910,22 +5775,24 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WarningNotification": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "description": "Concise warning message for the user.", @@ -6938,24 +5805,24 @@ "null" ] } - } + }, + "required": [ + "message" + ], + "type": "object" }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -6964,27 +5831,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -6993,13 +5860,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -7008,11 +5875,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -7021,32 +5888,31 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] }, "WindowsSandboxSetupCompletedNotification": { - "type": "object", - "required": [ - "mode", - "success" - ], "properties": { "error": { "type": [ @@ -7060,38 +5926,1172 @@ "success": { "type": "boolean" } - } + }, + "required": [ + "mode", + "success" + ], + "type": "object" }, "WindowsSandboxSetupMode": { - "type": "string", "enum": [ "elevated", "unelevated" - ] + ], + "type": "string" }, "WindowsWorldWritableWarningNotification": { - "type": "object", - "required": [ - "extraCount", - "failedScan", - "samplePaths" - ], "properties": { "extraCount": { - "type": "integer", "format": "uint", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "failedScan": { "type": "boolean" }, "samplePaths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "required": [ + "extraCount", + "failedScan", + "samplePaths" + ], + "type": "object" } - } + }, + "description": "Notification sent from the server to the client.", + "oneOf": [ + { + "description": "NEW NOTIFICATIONS", + "properties": { + "method": { + "enum": [ + "error" + ], + "title": "ErrorNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ErrorNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "ErrorNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/started" + ], + "title": "Thread/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/status/changed" + ], + "title": "Thread/status/changedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadStatusChangedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/status/changedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/archived" + ], + "title": "Thread/archivedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadArchivedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/archivedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/unarchived" + ], + "title": "Thread/unarchivedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadUnarchivedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/unarchivedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/closed" + ], + "title": "Thread/closedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadClosedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/closedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/name/updated" + ], + "title": "Thread/name/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadNameUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/name/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/tokenUsage/updated" + ], + "title": "Thread/tokenUsage/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadTokenUsageUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/tokenUsage/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "turn/started" + ], + "title": "Turn/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Turn/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "hook/started" + ], + "title": "Hook/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/HookStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Hook/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "turn/completed" + ], + "title": "Turn/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Turn/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "hook/completed" + ], + "title": "Hook/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/HookCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Hook/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "turn/diff/updated" + ], + "title": "Turn/diff/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnDiffUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Turn/diff/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "turn/plan/updated" + ], + "title": "Turn/plan/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnPlanUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Turn/plan/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/started" + ], + "title": "Item/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ItemStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/autoApprovalReview/started" + ], + "title": "Item/autoApprovalReview/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ItemGuardianApprovalReviewStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/autoApprovalReview/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/autoApprovalReview/completed" + ], + "title": "Item/autoApprovalReview/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ItemGuardianApprovalReviewCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/autoApprovalReview/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/completed" + ], + "title": "Item/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ItemCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/agentMessage/delta" + ], + "title": "Item/agentMessage/deltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/AgentMessageDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/agentMessage/deltaNotification", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items.", + "properties": { + "method": { + "enum": [ + "item/plan/delta" + ], + "title": "Item/plan/deltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/PlanDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/plan/deltaNotification", + "type": "object" + }, + { + "description": "Stream base64-encoded stdout/stderr chunks for a running `command/exec` session.", + "properties": { + "method": { + "enum": [ + "command/exec/outputDelta" + ], + "title": "Command/exec/outputDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecOutputDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Command/exec/outputDeltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/commandExecution/outputDelta" + ], + "title": "Item/commandExecution/outputDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecutionOutputDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/commandExecution/outputDeltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/commandExecution/terminalInteraction" + ], + "title": "Item/commandExecution/terminalInteractionNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TerminalInteractionNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/commandExecution/terminalInteractionNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/fileChange/outputDelta" + ], + "title": "Item/fileChange/outputDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FileChangeOutputDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/fileChange/outputDeltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/fileChange/patchUpdated" + ], + "title": "Item/fileChange/patchUpdatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FileChangePatchUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/fileChange/patchUpdatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "serverRequest/resolved" + ], + "title": "ServerRequest/resolvedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ServerRequestResolvedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "ServerRequest/resolvedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/mcpToolCall/progress" + ], + "title": "Item/mcpToolCall/progressNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpToolCallProgressNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/mcpToolCall/progressNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "mcpServer/oauthLogin/completed" + ], + "title": "McpServer/oauthLogin/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpServerOauthLoginCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "McpServer/oauthLogin/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "mcpServer/startupStatus/updated" + ], + "title": "McpServer/startupStatus/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpServerStatusUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "McpServer/startupStatus/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "account/updated" + ], + "title": "Account/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/AccountUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Account/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "account/rateLimits/updated" + ], + "title": "Account/rateLimits/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/AccountRateLimitsUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Account/rateLimits/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "fs/changed" + ], + "title": "Fs/changedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsChangedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Fs/changedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/reasoning/summaryTextDelta" + ], + "title": "Item/reasoning/summaryTextDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ReasoningSummaryTextDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/reasoning/summaryTextDeltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/reasoning/summaryPartAdded" + ], + "title": "Item/reasoning/summaryPartAddedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ReasoningSummaryPartAddedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/reasoning/summaryPartAddedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/reasoning/textDelta" + ], + "title": "Item/reasoning/textDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ReasoningTextDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/reasoning/textDeltaNotification", + "type": "object" + }, + { + "description": "Deprecated: Use `ContextCompaction` item type instead.", + "properties": { + "method": { + "enum": [ + "thread/compacted" + ], + "title": "Thread/compactedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ContextCompactedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/compactedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "model/rerouted" + ], + "title": "Model/reroutedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ModelReroutedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Model/reroutedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "warning" + ], + "title": "WarningNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/WarningNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "WarningNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "guardianWarning" + ], + "title": "GuardianWarningNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/GuardianWarningNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "GuardianWarningNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "deprecationNotice" + ], + "title": "DeprecationNoticeNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/DeprecationNoticeNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "DeprecationNoticeNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "configWarning" + ], + "title": "ConfigWarningNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ConfigWarningNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "ConfigWarningNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/epiphany/stateUpdated" + ], + "title": "Thread/epiphany/stateUpdatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadEpiphanyStateUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/epiphany/stateUpdatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/epiphany/jobsUpdated" + ], + "title": "Thread/epiphany/jobsUpdatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadEpiphanyJobsUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/epiphany/jobsUpdatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "fuzzyFileSearch/sessionUpdated" + ], + "title": "FuzzyFileSearch/sessionUpdatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FuzzyFileSearchSessionUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "FuzzyFileSearch/sessionUpdatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "fuzzyFileSearch/sessionCompleted" + ], + "title": "FuzzyFileSearch/sessionCompletedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FuzzyFileSearchSessionCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "FuzzyFileSearch/sessionCompletedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/started" + ], + "title": "Thread/realtime/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/itemAdded" + ], + "title": "Thread/realtime/itemAddedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeItemAddedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/itemAddedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/transcript/delta" + ], + "title": "Thread/realtime/transcript/deltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeTranscriptDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/transcript/deltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/transcript/done" + ], + "title": "Thread/realtime/transcript/doneNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeTranscriptDoneNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/transcript/doneNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/outputAudio/delta" + ], + "title": "Thread/realtime/outputAudio/deltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeOutputAudioDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/outputAudio/deltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/sdp" + ], + "title": "Thread/realtime/sdpNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeSdpNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/sdpNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/error" + ], + "title": "Thread/realtime/errorNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeErrorNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/errorNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/closed" + ], + "title": "Thread/realtime/closedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeClosedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/closedNotification", + "type": "object" + }, + { + "description": "Notifies the user of world-writable directories on Windows, which cannot be protected by the sandbox.", + "properties": { + "method": { + "enum": [ + "windows/worldWritableWarning" + ], + "title": "Windows/worldWritableWarningNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/WindowsWorldWritableWarningNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Windows/worldWritableWarningNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "windowsSandbox/setupCompleted" + ], + "title": "WindowsSandbox/setupCompletedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/WindowsSandboxSetupCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "WindowsSandbox/setupCompletedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "account/login/completed" + ], + "title": "Account/login/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/AccountLoginCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Account/login/completedNotification", + "type": "object" + } + ], + "title": "ServerNotification" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/ServerRequest.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/ServerRequest.json index 17abd327..016dbe34 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/ServerRequest.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/ServerRequest.json @@ -1,280 +1,51 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ServerRequest", - "description": "Request initiated from the server and sent to the client.", - "oneOf": [ - { - "description": "NEW APIs Sent when approval is requested for a specific command execution. This request is used for Turns started via turn/start.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "item/commandExecution/requestApproval" - ], - "title": "Item/commandExecution/requestApprovalRequestMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecutionRequestApprovalParams" - } - }, - "title": "Item/commandExecution/requestApprovalRequest" - }, - { - "description": "Sent when approval is requested for a specific file change. This request is used for Turns started via turn/start.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "item/fileChange/requestApproval" - ], - "title": "Item/fileChange/requestApprovalRequestMethod" - }, - "params": { - "$ref": "#/definitions/FileChangeRequestApprovalParams" - } - }, - "title": "Item/fileChange/requestApprovalRequest" - }, - { - "description": "EXPERIMENTAL - Request input from the user for a tool call.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "item/tool/requestUserInput" - ], - "title": "Item/tool/requestUserInputRequestMethod" - }, - "params": { - "$ref": "#/definitions/ToolRequestUserInputParams" - } - }, - "title": "Item/tool/requestUserInputRequest" - }, - { - "description": "Request input for an MCP server elicitation.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServer/elicitation/request" - ], - "title": "McpServer/elicitation/requestRequestMethod" - }, - "params": { - "$ref": "#/definitions/McpServerElicitationRequestParams" - } - }, - "title": "McpServer/elicitation/requestRequest" - }, - { - "description": "Request approval for additional permissions from the user.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "item/permissions/requestApproval" - ], - "title": "Item/permissions/requestApprovalRequestMethod" - }, - "params": { - "$ref": "#/definitions/PermissionsRequestApprovalParams" - } - }, - "title": "Item/permissions/requestApprovalRequest" - }, - { - "description": "Execute a dynamic tool call on the client.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "item/tool/call" - ], - "title": "Item/tool/callRequestMethod" - }, - "params": { - "$ref": "#/definitions/DynamicToolCallParams" - } - }, - "title": "Item/tool/callRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/chatgptAuthTokens/refresh" - ], - "title": "Account/chatgptAuthTokens/refreshRequestMethod" - }, - "params": { - "$ref": "#/definitions/ChatgptAuthTokensRefreshParams" - } - }, - "title": "Account/chatgptAuthTokens/refreshRequest" - }, - { - "description": "DEPRECATED APIs below Request to approve a patch. This request is used for Turns started via the legacy APIs (i.e. SendUserTurn, SendUserMessage).", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "applyPatchApproval" - ], - "title": "ApplyPatchApprovalRequestMethod" - }, - "params": { - "$ref": "#/definitions/ApplyPatchApprovalParams" - } - }, - "title": "ApplyPatchApprovalRequest" - }, - { - "description": "Request to exec a command. This request is used for Turns started via the legacy APIs (i.e. SendUserTurn, SendUserMessage).", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "execCommandApproval" - ], - "title": "ExecCommandApprovalRequestMethod" - }, - "params": { - "$ref": "#/definitions/ExecCommandApprovalParams" - } - }, - "title": "ExecCommandApprovalRequest" - } - ], "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "AdditionalFileSystemPermissions": { - "type": "object", "properties": { "entries": { + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - } + ] }, "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 1.0 + ] }, "read": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } + ] }, "write": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } + ] } - } + }, + "type": "object" }, "AdditionalNetworkPermissions": { - "type": "object", "properties": { "enabled": { "type": [ @@ -282,10 +53,10 @@ "null" ] } - } + }, + "type": "object" }, "AdditionalPermissionProfile": { - "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -307,15 +78,10 @@ } ] } - } + }, + "type": "object" }, "ApplyPatchApprovalParams": { - "type": "object", - "required": [ - "callId", - "conversationId", - "fileChanges" - ], "properties": { "callId": { "description": "Use to correlate this with [codex_protocol::protocol::PatchApplyBeginEvent] and [codex_protocol::protocol::PatchApplyEndEvent].", @@ -325,10 +91,10 @@ "$ref": "#/definitions/ThreadId" }, "fileChanges": { - "type": "object", "additionalProperties": { "$ref": "#/definitions/FileChange" - } + }, + "type": "object" }, "grantRoot": { "description": "When set, the agent is asking the user to allow writes under this root for the remainder of the session (unclear if this is honored today).", @@ -344,13 +110,15 @@ "null" ] } - } + }, + "required": [ + "callId", + "conversationId", + "fileChanges" + ], + "type": "object" }, "ChatgptAuthTokensRefreshParams": { - "type": "object", - "required": [ - "reason" - ], "properties": { "previousAccountId": { "description": "Workspace/account identifier that Codex was previously using.\n\nClients that manage multiple accounts/workspaces can use this as a hint to refresh the token for the correct workspace.\n\nThis may be `null` when the prior auth state did not include a workspace identifier (`chatgpt_account_id`).", @@ -362,29 +130,26 @@ "reason": { "$ref": "#/definitions/ChatgptAuthTokensRefreshReason" } - } + }, + "required": [ + "reason" + ], + "type": "object" }, "ChatgptAuthTokensRefreshReason": { "oneOf": [ { "description": "Codex attempted a backend request and received `401 Unauthorized`.", - "type": "string", "enum": [ "unauthorized" - ] + ], + "type": "string" } ] }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -396,21 +161,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -422,21 +189,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -454,34 +221,39 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, @@ -489,92 +261,83 @@ "oneOf": [ { "description": "User approved the command.", - "type": "string", "enum": [ "accept" - ] + ], + "type": "string" }, { "description": "User approved the command and future prompts in the same session-scoped approval cache should run without prompting.", - "type": "string", "enum": [ "acceptForSession" - ] + ], + "type": "string" }, { + "additionalProperties": false, "description": "User approved the command, and wants to apply the proposed execpolicy amendment so future matching commands can run without prompting.", - "type": "object", - "required": [ - "acceptWithExecpolicyAmendment" - ], "properties": { "acceptWithExecpolicyAmendment": { - "type": "object", + "properties": { + "execpolicy_amendment": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "execpolicy_amendment" ], - "properties": { - "execpolicy_amendment": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" } }, - "additionalProperties": false, - "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision" + "required": [ + "acceptWithExecpolicyAmendment" + ], + "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision", + "type": "object" }, { + "additionalProperties": false, "description": "User chose a persistent network policy rule (allow/deny) for this host.", - "type": "object", - "required": [ - "applyNetworkPolicyAmendment" - ], "properties": { "applyNetworkPolicyAmendment": { - "type": "object", - "required": [ - "network_policy_amendment" - ], "properties": { "network_policy_amendment": { "$ref": "#/definitions/NetworkPolicyAmendment" } - } + }, + "required": [ + "network_policy_amendment" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision" + "required": [ + "applyNetworkPolicyAmendment" + ], + "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision", + "type": "object" }, { "description": "User denied the command. The agent will continue the turn.", - "type": "string", "enum": [ "decline" - ] + ], + "type": "string" }, { "description": "User denied the command. The turn will also be immediately interrupted.", - "type": "string", "enum": [ "cancel" - ] + ], + "type": "string" } ] }, "CommandExecutionRequestApprovalParams": { - "type": "object", - "required": [ - "itemId", - "threadId", - "turnId" - ], "properties": { - "threadId": { - "type": "string" - }, "approvalId": { "description": "Unique identifier for this specific approval callback.\n\nFor regular shell/unified_exec approvals, this is null.\n\nFor zsh-exec-bridge subcommand approvals, multiple callbacks can belong to one parent `itemId`, so `approvalId` is a distinct opaque callback id (a UUID) used to disambiguate routing.", "type": [ @@ -582,9 +345,6 @@ "null" ] }, - "turnId": { - "type": "string" - }, "command": { "description": "The command to be executed.", "type": [ @@ -594,16 +354,15 @@ }, "commandActions": { "description": "Best-effort parsed command actions for friendly display.", + "items": { + "$ref": "#/definitions/CommandAction" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/CommandAction" - } + ] }, "cwd": { - "description": "The command's working directory.", "anyOf": [ { "$ref": "#/definitions/AbsolutePathBuf" @@ -611,13 +370,13 @@ { "type": "null" } - ] + ], + "description": "The command's working directory." }, "itemId": { "type": "string" }, "networkApprovalContext": { - "description": "Optional context for a managed-network approval prompt.", "anyOf": [ { "$ref": "#/definitions/NetworkApprovalContext" @@ -625,27 +384,28 @@ { "type": "null" } - ] + ], + "description": "Optional context for a managed-network approval prompt." }, "proposedExecpolicyAmendment": { "description": "Optional proposed execpolicy amendment to allow similar commands without prompting.", + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "proposedNetworkPolicyAmendments": { "description": "Optional proposed network policy amendments (allow/deny host) for future requests.", + "items": { + "$ref": "#/definitions/NetworkPolicyAmendment" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/NetworkPolicyAmendment" - } + ] }, "reason": { "description": "Optional explanatory reason (e.g. request for network access).", @@ -653,18 +413,22 @@ "string", "null" ] + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" } - } - }, - "DynamicToolCallParams": { - "type": "object", + }, "required": [ - "arguments", - "callId", + "itemId", "threadId", - "tool", "turnId" ], + "type": "object" + }, + "DynamicToolCallParams": { "properties": { "arguments": true, "callId": { @@ -685,17 +449,17 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "arguments", + "callId", + "threadId", + "tool", + "turnId" + ], + "type": "object" }, "ExecCommandApprovalParams": { - "type": "object", - "required": [ - "callId", - "command", - "conversationId", - "cwd", - "parsedCmd" - ], "properties": { "approvalId": { "description": "Identifier for this specific approval callback.", @@ -709,10 +473,10 @@ "type": "string" }, "command": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "conversationId": { "$ref": "#/definitions/ThreadId" @@ -721,10 +485,10 @@ "type": "string" }, "parsedCmd": { - "type": "array", "items": { "$ref": "#/definitions/ParsedCommand" - } + }, + "type": "array" }, "reason": { "type": [ @@ -732,56 +496,59 @@ "null" ] } - } + }, + "required": [ + "callId", + "command", + "conversationId", + "cwd", + "parsedCmd" + ], + "type": "object" }, "FileChange": { "oneOf": [ { - "type": "object", - "required": [ - "content", - "type" - ], "properties": { "content": { "type": "string" }, "type": { - "type": "string", "enum": [ "add" ], - "title": "AddFileChangeType" + "title": "AddFileChangeType", + "type": "string" } }, - "title": "AddFileChange" - }, - { - "type": "object", "required": [ "content", "type" ], + "title": "AddFileChange", + "type": "object" + }, + { "properties": { "content": { "type": "string" }, "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeleteFileChangeType" + "title": "DeleteFileChangeType", + "type": "string" } }, - "title": "DeleteFileChange" + "required": [ + "content", + "type" + ], + "title": "DeleteFileChange", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "unified_diff" - ], "properties": { "move_path": { "type": [ @@ -790,27 +557,26 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdateFileChangeType" + "title": "UpdateFileChangeType", + "type": "string" }, "unified_diff": { "type": "string" } }, - "title": "UpdateFileChange" + "required": [ + "type", + "unified_diff" + ], + "title": "UpdateFileChange", + "type": "object" } ] }, "FileChangeRequestApprovalParams": { - "type": "object", - "required": [ - "itemId", - "threadId", - "turnId" - ], "properties": { "grantRoot": { "description": "[UNSTABLE] When set, the agent is asking the user to allow writes under this root for the remainder of the session (unclear if this is honored today).", @@ -835,86 +601,87 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "itemId", + "threadId", + "turnId" + ], + "type": "object" }, "FileSystemAccessMode": { - "type": "string", "enum": [ "read", "write", "none" - ] + ], + "type": "string" }, "FileSystemPath": { "oneOf": [ { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "path" ], - "title": "PathFileSystemPathType" + "title": "PathFileSystemPathType", + "type": "string" } }, - "title": "PathFileSystemPath" - }, - { - "type": "object", "required": [ - "pattern", + "path", "type" ], + "title": "PathFileSystemPath", + "type": "object" + }, + { "properties": { "pattern": { "type": "string" }, "type": { - "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType" + "title": "GlobPatternFileSystemPathType", + "type": "string" } }, - "title": "GlobPatternFileSystemPath" + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType" + "title": "SpecialFileSystemPathType", + "type": "string" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "title": "SpecialFileSystemPath" + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" } ] }, "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -922,66 +689,67 @@ "path": { "$ref": "#/definitions/FileSystemPath" } - } + }, + "required": [ + "access", + "path" + ], + "type": "object" }, "FileSystemSpecialPath": { "oneOf": [ { - "type": "object", - "required": [ - "kind" - ], "properties": { "kind": { - "type": "string", "enum": [ "root" - ] + ], + "type": "string" } }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "minimal" - ] + ], + "type": "string" } }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "current_working_directory" - ] + ], + "type": "string" } }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "project_roots" - ] + ], + "type": "string" }, "subpath": { "type": [ @@ -990,50 +758,49 @@ ] } }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "tmpdir" - ] + ], + "type": "string" } }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" }, { - "type": "object", - "required": [ - "kind", - "path" - ], "properties": { "kind": { - "type": "string", "enum": [ "unknown" - ] + ], + "type": "string" }, "path": { "type": "string" @@ -1044,21 +811,23 @@ "null" ] } - } + }, + "required": [ + "kind", + "path" + ], + "type": "object" } ] }, "McpElicitationArrayType": { - "type": "string", "enum": [ "array" - ] + ], + "type": "string" }, "McpElicitationBooleanSchema": { - "type": "object", - "required": [ - "type" - ], + "additionalProperties": false, "properties": { "default": { "type": [ @@ -1082,20 +851,19 @@ "$ref": "#/definitions/McpElicitationBooleanType" } }, - "additionalProperties": false + "required": [ + "type" + ], + "type": "object" }, "McpElicitationBooleanType": { - "type": "string", "enum": [ "boolean" - ] + ], + "type": "string" }, "McpElicitationConstOption": { - "type": "object", - "required": [ - "const", - "title" - ], + "additionalProperties": false, "properties": { "const": { "type": "string" @@ -1104,7 +872,11 @@ "type": "string" } }, - "additionalProperties": false + "required": [ + "const", + "title" + ], + "type": "object" }, "McpElicitationEnumSchema": { "anyOf": [ @@ -1120,11 +892,7 @@ ] }, "McpElicitationLegacyTitledEnumSchema": { - "type": "object", - "required": [ - "enum", - "type" - ], + "additionalProperties": false, "properties": { "default": { "type": [ @@ -1139,19 +907,19 @@ ] }, "enum": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "enumNames": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "title": { "type": [ @@ -1163,7 +931,11 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false + "required": [ + "enum", + "type" + ], + "type": "object" }, "McpElicitationMultiSelectEnumSchema": { "anyOf": [ @@ -1176,17 +948,14 @@ ] }, "McpElicitationNumberSchema": { - "type": "object", - "required": [ - "type" - ], + "additionalProperties": false, "properties": { "default": { + "format": "double", "type": [ "number", "null" - ], - "format": "double" + ] }, "description": { "type": [ @@ -1195,18 +964,18 @@ ] }, "maximum": { + "format": "double", "type": [ "number", "null" - ], - "format": "double" + ] }, "minimum": { + "format": "double", "type": [ "number", "null" - ], - "format": "double" + ] }, "title": { "type": [ @@ -1218,20 +987,23 @@ "$ref": "#/definitions/McpElicitationNumberType" } }, - "additionalProperties": false + "required": [ + "type" + ], + "type": "object" }, "McpElicitationNumberType": { - "type": "string", "enum": [ "number", "integer" - ] + ], + "type": "string" }, "McpElicitationObjectType": { - "type": "string", "enum": [ "object" - ] + ], + "type": "string" }, "McpElicitationPrimitiveSchema": { "anyOf": [ @@ -1250,12 +1022,8 @@ ] }, "McpElicitationSchema": { + "additionalProperties": false, "description": "Typed form schema for MCP `elicitation/create` requests.\n\nThis matches the `requestedSchema` shape from the MCP 2025-11-25 `ElicitRequestFormParams` schema.", - "type": "object", - "required": [ - "properties", - "type" - ], "properties": { "$schema": { "type": [ @@ -1264,25 +1032,29 @@ ] }, "properties": { - "type": "object", "additionalProperties": { "$ref": "#/definitions/McpElicitationPrimitiveSchema" - } + }, + "type": "object" }, "required": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "type": { "$ref": "#/definitions/McpElicitationObjectType" } }, - "additionalProperties": false + "required": [ + "properties", + "type" + ], + "type": "object" }, "McpElicitationSingleSelectEnumSchema": { "anyOf": [ @@ -1295,19 +1067,16 @@ ] }, "McpElicitationStringFormat": { - "type": "string", "enum": [ "email", "uri", "date", "date-time" - ] + ], + "type": "string" }, "McpElicitationStringSchema": { - "type": "object", - "required": [ - "type" - ], + "additionalProperties": false, "properties": { "default": { "type": [ @@ -1332,20 +1101,20 @@ ] }, "maxLength": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "minLength": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "title": { "type": [ @@ -1357,44 +1126,43 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false + "required": [ + "type" + ], + "type": "object" }, "McpElicitationStringType": { - "type": "string", "enum": [ "string" - ] + ], + "type": "string" }, "McpElicitationTitledEnumItems": { - "type": "object", + "additionalProperties": false, + "properties": { + "anyOf": { + "items": { + "$ref": "#/definitions/McpElicitationConstOption" + }, + "type": "array" + } + }, "required": [ "anyOf" ], - "properties": { - "anyOf": { - "type": "array", - "items": { - "$ref": "#/definitions/McpElicitationConstOption" - } - } - }, - "additionalProperties": false + "type": "object" }, "McpElicitationTitledMultiSelectEnumSchema": { - "type": "object", - "required": [ - "items", - "type" - ], + "additionalProperties": false, "properties": { "default": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "description": { "type": [ @@ -1406,20 +1174,20 @@ "$ref": "#/definitions/McpElicitationTitledEnumItems" }, "maxItems": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "minItems": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "title": { "type": [ @@ -1431,14 +1199,14 @@ "$ref": "#/definitions/McpElicitationArrayType" } }, - "additionalProperties": false - }, - "McpElicitationTitledSingleSelectEnumSchema": { - "type": "object", "required": [ - "oneOf", + "items", "type" ], + "type": "object" + }, + "McpElicitationTitledSingleSelectEnumSchema": { + "additionalProperties": false, "properties": { "default": { "type": [ @@ -1453,10 +1221,10 @@ ] }, "oneOf": { - "type": "array", "items": { "$ref": "#/definitions/McpElicitationConstOption" - } + }, + "type": "array" }, "title": { "type": [ @@ -1468,42 +1236,42 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false - }, - "McpElicitationUntitledEnumItems": { - "type": "object", "required": [ - "enum", + "oneOf", "type" ], + "type": "object" + }, + "McpElicitationUntitledEnumItems": { + "additionalProperties": false, "properties": { "enum": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false - }, - "McpElicitationUntitledMultiSelectEnumSchema": { - "type": "object", "required": [ - "items", + "enum", "type" ], + "type": "object" + }, + "McpElicitationUntitledMultiSelectEnumSchema": { + "additionalProperties": false, "properties": { "default": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "description": { "type": [ @@ -1515,20 +1283,20 @@ "$ref": "#/definitions/McpElicitationUntitledEnumItems" }, "maxItems": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "minItems": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "title": { "type": [ @@ -1540,14 +1308,14 @@ "$ref": "#/definitions/McpElicitationArrayType" } }, - "additionalProperties": false - }, - "McpElicitationUntitledSingleSelectEnumSchema": { - "type": "object", "required": [ - "enum", + "items", "type" ], + "type": "object" + }, + "McpElicitationUntitledSingleSelectEnumSchema": { + "additionalProperties": false, "properties": { "default": { "type": [ @@ -1562,10 +1330,10 @@ ] }, "enum": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": [ @@ -1577,42 +1345,38 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false + "required": [ + "enum", + "type" + ], + "type": "object" }, "McpServerElicitationRequestParams": { - "type": "object", "oneOf": [ { - "type": "object", - "required": [ - "message", - "mode", - "requestedSchema" - ], "properties": { "_meta": true, "message": { "type": "string" }, "mode": { - "type": "string", "enum": [ "form" - ] + ], + "type": "string" }, "requestedSchema": { "$ref": "#/definitions/McpElicitationSchema" } - } - }, - { - "type": "object", + }, "required": [ - "elicitationId", "message", "mode", - "url" + "requestedSchema" ], + "type": "object" + }, + { "properties": { "_meta": true, "elicitationId": { @@ -1622,21 +1386,24 @@ "type": "string" }, "mode": { - "type": "string", "enum": [ "url" - ] + ], + "type": "string" }, "url": { "type": "string" } - } + }, + "required": [ + "elicitationId", + "message", + "mode", + "url" + ], + "type": "object" } ], - "required": [ - "serverName", - "threadId" - ], "properties": { "serverName": { "type": "string" @@ -1651,14 +1418,14 @@ "null" ] } - } + }, + "required": [ + "serverName", + "threadId" + ], + "type": "object" }, "NetworkApprovalContext": { - "type": "object", - "required": [ - "host", - "protocol" - ], "properties": { "host": { "type": "string" @@ -1666,23 +1433,23 @@ "protocol": { "$ref": "#/definitions/NetworkApprovalProtocol" } - } + }, + "required": [ + "host", + "protocol" + ], + "type": "object" }, "NetworkApprovalProtocol": { - "type": "string", "enum": [ "http", "https", "socks5Tcp", "socks5Udp" - ] + ], + "type": "string" }, "NetworkPolicyAmendment": { - "type": "object", - "required": [ - "action", - "host" - ], "properties": { "action": { "$ref": "#/definitions/NetworkPolicyRuleAction" @@ -1690,25 +1457,23 @@ "host": { "type": "string" } - } + }, + "required": [ + "action", + "host" + ], + "type": "object" }, "NetworkPolicyRuleAction": { - "type": "string", "enum": [ "allow", "deny" - ] + ], + "type": "string" }, "ParsedCommand": { "oneOf": [ { - "type": "object", - "required": [ - "cmd", - "name", - "path", - "type" - ], "properties": { "cmd": { "type": "string" @@ -1721,21 +1486,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadParsedCommandType" + "title": "ReadParsedCommandType", + "type": "string" } }, - "title": "ReadParsedCommand" - }, - { - "type": "object", "required": [ "cmd", + "name", + "path", "type" ], + "title": "ReadParsedCommand", + "type": "object" + }, + { "properties": { "cmd": { "type": "string" @@ -1747,21 +1514,21 @@ ] }, "type": { - "type": "string", "enum": [ "list_files" ], - "title": "ListFilesParsedCommandType" + "title": "ListFilesParsedCommandType", + "type": "string" } }, - "title": "ListFilesParsedCommand" - }, - { - "type": "object", "required": [ "cmd", "type" ], + "title": "ListFilesParsedCommand", + "type": "object" + }, + { "properties": { "cmd": { "type": "string" @@ -1779,46 +1546,43 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchParsedCommandType" + "title": "SearchParsedCommandType", + "type": "string" } }, - "title": "SearchParsedCommand" - }, - { - "type": "object", "required": [ "cmd", "type" ], + "title": "SearchParsedCommand", + "type": "object" + }, + { "properties": { "cmd": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownParsedCommandType" + "title": "UnknownParsedCommandType", + "type": "string" } }, - "title": "UnknownParsedCommand" + "required": [ + "cmd", + "type" + ], + "title": "UnknownParsedCommand", + "type": "object" } ] }, "PermissionsRequestApprovalParams": { - "type": "object", - "required": [ - "cwd", - "itemId", - "permissions", - "threadId", - "turnId" - ], "properties": { "cwd": { "$ref": "#/definitions/AbsolutePathBuf" @@ -1841,7 +1605,15 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "cwd", + "itemId", + "permissions", + "threadId", + "turnId" + ], + "type": "object" }, "RequestId": { "anyOf": [ @@ -1849,13 +1621,13 @@ "type": "string" }, { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } ] }, "RequestPermissionProfile": { - "type": "object", + "additionalProperties": false, "properties": { "fileSystem": { "anyOf": [ @@ -1878,18 +1650,13 @@ ] } }, - "additionalProperties": false + "type": "object" }, "ThreadId": { "type": "string" }, "ToolRequestUserInputOption": { "description": "EXPERIMENTAL. Defines a single selectable option for request_user_input.", - "type": "object", - "required": [ - "description", - "label" - ], "properties": { "description": { "type": "string" @@ -1897,26 +1664,24 @@ "label": { "type": "string" } - } + }, + "required": [ + "description", + "label" + ], + "type": "object" }, "ToolRequestUserInputParams": { "description": "EXPERIMENTAL. Params sent with a request_user_input event.", - "type": "object", - "required": [ - "itemId", - "questions", - "threadId", - "turnId" - ], "properties": { "itemId": { "type": "string" }, "questions": { - "type": "array", "items": { "$ref": "#/definitions/ToolRequestUserInputQuestion" - } + }, + "type": "array" }, "threadId": { "type": "string" @@ -1924,16 +1689,17 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "itemId", + "questions", + "threadId", + "turnId" + ], + "type": "object" }, "ToolRequestUserInputQuestion": { "description": "EXPERIMENTAL. Represents one request_user_input question and its required options.", - "type": "object", - "required": [ - "header", - "id", - "question" - ], "properties": { "header": { "type": "string" @@ -1950,18 +1716,252 @@ "type": "boolean" }, "options": { + "items": { + "$ref": "#/definitions/ToolRequestUserInputOption" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/ToolRequestUserInputOption" - } + ] }, "question": { "type": "string" } - } + }, + "required": [ + "header", + "id", + "question" + ], + "type": "object" } - } + }, + "description": "Request initiated from the server and sent to the client.", + "oneOf": [ + { + "description": "NEW APIs Sent when approval is requested for a specific command execution. This request is used for Turns started via turn/start.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "item/commandExecution/requestApproval" + ], + "title": "Item/commandExecution/requestApprovalRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecutionRequestApprovalParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Item/commandExecution/requestApprovalRequest", + "type": "object" + }, + { + "description": "Sent when approval is requested for a specific file change. This request is used for Turns started via turn/start.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "item/fileChange/requestApproval" + ], + "title": "Item/fileChange/requestApprovalRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FileChangeRequestApprovalParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Item/fileChange/requestApprovalRequest", + "type": "object" + }, + { + "description": "EXPERIMENTAL - Request input from the user for a tool call.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "item/tool/requestUserInput" + ], + "title": "Item/tool/requestUserInputRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ToolRequestUserInputParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Item/tool/requestUserInputRequest", + "type": "object" + }, + { + "description": "Request input for an MCP server elicitation.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "mcpServer/elicitation/request" + ], + "title": "McpServer/elicitation/requestRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpServerElicitationRequestParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServer/elicitation/requestRequest", + "type": "object" + }, + { + "description": "Request approval for additional permissions from the user.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "item/permissions/requestApproval" + ], + "title": "Item/permissions/requestApprovalRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/PermissionsRequestApprovalParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Item/permissions/requestApprovalRequest", + "type": "object" + }, + { + "description": "Execute a dynamic tool call on the client.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "item/tool/call" + ], + "title": "Item/tool/callRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/DynamicToolCallParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Item/tool/callRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/chatgptAuthTokens/refresh" + ], + "title": "Account/chatgptAuthTokens/refreshRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ChatgptAuthTokensRefreshParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/chatgptAuthTokens/refreshRequest", + "type": "object" + }, + { + "description": "DEPRECATED APIs below Request to approve a patch. This request is used for Turns started via the legacy APIs (i.e. SendUserTurn, SendUserMessage).", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "applyPatchApproval" + ], + "title": "ApplyPatchApprovalRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ApplyPatchApprovalParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "ApplyPatchApprovalRequest", + "type": "object" + }, + { + "description": "Request to exec a command. This request is used for Turns started via the legacy APIs (i.e. SendUserTurn, SendUserMessage).", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "execCommandApproval" + ], + "title": "ExecCommandApprovalRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ExecCommandApprovalParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "ExecCommandApprovalRequest", + "type": "object" + } + ], + "title": "ServerRequest" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputParams.json index 75b985dc..153d3bad 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputParams.json @@ -1,39 +1,8 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ToolRequestUserInputParams", - "description": "EXPERIMENTAL. Params sent with a request_user_input event.", - "type": "object", - "required": [ - "itemId", - "questions", - "threadId", - "turnId" - ], - "properties": { - "itemId": { - "type": "string" - }, - "questions": { - "type": "array", - "items": { - "$ref": "#/definitions/ToolRequestUserInputQuestion" - } - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - }, "definitions": { "ToolRequestUserInputOption": { "description": "EXPERIMENTAL. Defines a single selectable option for request_user_input.", - "type": "object", - "required": [ - "description", - "label" - ], "properties": { "description": { "type": "string" @@ -41,16 +10,15 @@ "label": { "type": "string" } - } + }, + "required": [ + "description", + "label" + ], + "type": "object" }, "ToolRequestUserInputQuestion": { "description": "EXPERIMENTAL. Represents one request_user_input question and its required options.", - "type": "object", - "required": [ - "header", - "id", - "question" - ], "properties": { "header": { "type": "string" @@ -67,18 +35,50 @@ "type": "boolean" }, "options": { + "items": { + "$ref": "#/definitions/ToolRequestUserInputOption" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/ToolRequestUserInputOption" - } + ] }, "question": { "type": "string" } - } + }, + "required": [ + "header", + "id", + "question" + ], + "type": "object" } - } + }, + "description": "EXPERIMENTAL. Params sent with a request_user_input event.", + "properties": { + "itemId": { + "type": "string" + }, + "questions": { + "items": { + "$ref": "#/definitions/ToolRequestUserInputQuestion" + }, + "type": "array" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "itemId", + "questions", + "threadId", + "turnId" + ], + "title": "ToolRequestUserInputParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputResponse.json index 73d87dd0..3fd6fbc3 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputResponse.json @@ -1,34 +1,34 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ToolRequestUserInputResponse", - "description": "EXPERIMENTAL. Response payload mapping question ids to answers.", - "type": "object", - "required": [ - "answers" - ], - "properties": { - "answers": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/ToolRequestUserInputAnswer" - } - } - }, "definitions": { "ToolRequestUserInputAnswer": { "description": "EXPERIMENTAL. Captures a user's answer to a request_user_input question.", - "type": "object", + "properties": { + "answers": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "answers" ], - "properties": { - "answers": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" } - } + }, + "description": "EXPERIMENTAL. Response payload mapping question ids to answers.", + "properties": { + "answers": { + "additionalProperties": { + "$ref": "#/definitions/ToolRequestUserInputAnswer" + }, + "type": "object" + } + }, + "required": [ + "answers" + ], + "title": "ToolRequestUserInputResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json index 73b0e836..69cb8502 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json @@ -1,1786 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CodexAppServerProtocol", - "type": "object", "definitions": { - "RequestId": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "RequestId", - "anyOf": [ - { - "type": "string" - }, - { - "type": "integer", - "format": "int64" - } - ] - }, - "JSONRPCError": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "JSONRPCError", - "description": "A response to a request that indicates an error occurred.", - "type": "object", - "required": [ - "error", - "id" - ], - "properties": { - "error": { - "$ref": "#/definitions/JSONRPCErrorError" - }, - "id": { - "$ref": "#/definitions/v2/RequestId" - } - } - }, - "JSONRPCErrorError": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "JSONRPCErrorError", - "type": "object", - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int64" - }, - "data": true, - "message": { - "type": "string" - } - } - }, - "JSONRPCNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "JSONRPCNotification", - "description": "A notification which does not expect a response.", - "type": "object", - "required": [ - "method" - ], - "properties": { - "method": { - "type": "string" - }, - "params": true - } - }, - "JSONRPCRequest": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "JSONRPCRequest", - "description": "A request that expects a response.", - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string" - }, - "params": true, - "trace": { - "description": "Optional W3C Trace Context for distributed tracing.", - "anyOf": [ - { - "$ref": "#/definitions/W3cTraceContext" - }, - { - "type": "null" - } - ] - } - } - }, - "JSONRPCResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "JSONRPCResponse", - "description": "A successful (non-error) response to a request.", - "type": "object", - "required": [ - "id", - "result" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "result": true - } - }, - "W3cTraceContext": { - "type": "object", - "properties": { - "traceparent": { - "type": [ - "string", - "null" - ] - }, - "tracestate": { - "type": [ - "string", - "null" - ] - } - } - }, - "JSONRPCMessage": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "JSONRPCMessage", - "description": "Refers to any valid JSON-RPC object that can be decoded off the wire, or encoded to be sent.", - "anyOf": [ - { - "$ref": "#/definitions/JSONRPCRequest" - }, - { - "$ref": "#/definitions/JSONRPCNotification" - }, - { - "$ref": "#/definitions/JSONRPCResponse" - }, - { - "$ref": "#/definitions/JSONRPCError" - } - ] - }, - "ClientInfo": { - "type": "object", - "required": [ - "name", - "version" - ], - "properties": { - "name": { - "type": "string" - }, - "title": { - "type": [ - "string", - "null" - ] - }, - "version": { - "type": "string" - } - } - }, - "FuzzyFileSearchParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FuzzyFileSearchParams", - "type": "object", - "required": [ - "query", - "roots" - ], - "properties": { - "cancellationToken": { - "type": [ - "string", - "null" - ] - }, - "query": { - "type": "string" - }, - "roots": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ExecCommandApprovalResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExecCommandApprovalResponse", - "type": "object", - "required": [ - "decision" - ], - "properties": { - "decision": { - "$ref": "#/definitions/ReviewDecision" - } - } - }, - "ApplyPatchApprovalResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ApplyPatchApprovalResponse", - "type": "object", - "required": [ - "decision" - ], - "properties": { - "decision": { - "$ref": "#/definitions/ReviewDecision" - } - } - }, - "ReviewDecision": { - "description": "User's decision in response to an ExecApprovalRequest.", - "oneOf": [ - { - "description": "User has approved this command and the agent should execute it.", - "type": "string", - "enum": [ - "approved" - ] - }, - { - "description": "User has approved this command and wants to apply the proposed execpolicy amendment so future matching commands are permitted.", - "type": "object", - "required": [ - "approved_execpolicy_amendment" - ], - "properties": { - "approved_execpolicy_amendment": { - "type": "object", - "required": [ - "proposed_execpolicy_amendment" - ], - "properties": { - "proposed_execpolicy_amendment": { - "type": "array", - "items": { - "type": "string" - } - } - } - } - }, - "additionalProperties": false, - "title": "ApprovedExecpolicyAmendmentReviewDecision" - }, - { - "description": "User has approved this request and wants future prompts in the same session-scoped approval cache to be automatically approved for the remainder of the session.", - "type": "string", - "enum": [ - "approved_for_session" - ] - }, - { - "description": "User chose to persist a network policy rule (allow/deny) for future requests to the same host.", - "type": "object", - "required": [ - "network_policy_amendment" - ], - "properties": { - "network_policy_amendment": { - "type": "object", - "required": [ - "network_policy_amendment" - ], - "properties": { - "network_policy_amendment": { - "$ref": "#/definitions/NetworkPolicyAmendment" - } - } - } - }, - "additionalProperties": false, - "title": "NetworkPolicyAmendmentReviewDecision" - }, - { - "description": "User has denied this command and the agent should not execute it, but it should continue the session and try something else.", - "type": "string", - "enum": [ - "denied" - ] - }, - { - "description": "Automatic approval review timed out before reaching a decision.", - "type": "string", - "enum": [ - "timed_out" - ] - }, - { - "description": "User has denied this command and the agent should not do anything until the user's next command.", - "type": "string", - "enum": [ - "abort" - ] - } - ] - }, - "InitializeCapabilities": { - "description": "Client-declared capabilities negotiated during initialize.", - "type": "object", - "properties": { - "experimentalApi": { - "description": "Opt into receiving experimental API methods and fields.", - "default": false, - "type": "boolean" - }, - "optOutNotificationMethods": { - "description": "Exact notification method names that should be suppressed for this connection (for example `thread/started`).", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - } - } - }, - "InitializeParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "InitializeParams", - "type": "object", - "required": [ - "clientInfo" - ], - "properties": { - "capabilities": { - "anyOf": [ - { - "$ref": "#/definitions/InitializeCapabilities" - }, - { - "type": "null" - } - ] - }, - "clientInfo": { - "$ref": "#/definitions/ClientInfo" - } - } - }, - "ClientRequest": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ClientRequest", - "description": "Request from the client to the server.", - "oneOf": [ - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "initialize" - ], - "title": "InitializeRequestMethod" - }, - "params": { - "$ref": "#/definitions/InitializeParams" - } - }, - "title": "InitializeRequest" - }, - { - "description": "NEW APIs", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/start" - ], - "title": "Thread/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadStartParams" - } - }, - "title": "Thread/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/resume" - ], - "title": "Thread/resumeRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadResumeParams" - } - }, - "title": "Thread/resumeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/fork" - ], - "title": "Thread/forkRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadForkParams" - } - }, - "title": "Thread/forkRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/archive" - ], - "title": "Thread/archiveRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadArchiveParams" - } - }, - "title": "Thread/archiveRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/unsubscribe" - ], - "title": "Thread/unsubscribeRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadUnsubscribeParams" - } - }, - "title": "Thread/unsubscribeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/name/set" - ], - "title": "Thread/name/setRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadSetNameParams" - } - }, - "title": "Thread/name/setRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/metadata/update" - ], - "title": "Thread/metadata/updateRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadMetadataUpdateParams" - } - }, - "title": "Thread/metadata/updateRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/unarchive" - ], - "title": "Thread/unarchiveRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadUnarchiveParams" - } - }, - "title": "Thread/unarchiveRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/compact/start" - ], - "title": "Thread/compact/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadCompactStartParams" - } - }, - "title": "Thread/compact/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/shellCommand" - ], - "title": "Thread/shellCommandRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadShellCommandParams" - } - }, - "title": "Thread/shellCommandRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/approveGuardianDeniedAction" - ], - "title": "Thread/approveGuardianDeniedActionRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadApproveGuardianDeniedActionParams" - } - }, - "title": "Thread/approveGuardianDeniedActionRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/rollback" - ], - "title": "Thread/rollbackRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadRollbackParams" - } - }, - "title": "Thread/rollbackRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/list" - ], - "title": "Thread/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadListParams" - } - }, - "title": "Thread/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/loaded/list" - ], - "title": "Thread/loaded/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadLoadedListParams" - } - }, - "title": "Thread/loaded/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/read" - ], - "title": "Thread/readRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadReadParams" - } - }, - "title": "Thread/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/turns/list" - ], - "title": "Thread/turns/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadTurnsListParams" - } - }, - "title": "Thread/turns/listRequest" - }, - { - "description": "Append raw Responses API items to the thread history without starting a user turn.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/inject_items" - ], - "title": "Thread/injectItemsRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadInjectItemsParams" - } - }, - "title": "Thread/injectItemsRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "device/key/create" - ], - "title": "Device/key/createRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/DeviceKeyCreateParams" - } - }, - "title": "Device/key/createRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "device/key/public" - ], - "title": "Device/key/publicRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/DeviceKeyPublicParams" - } - }, - "title": "Device/key/publicRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "device/key/sign" - ], - "title": "Device/key/signRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/DeviceKeySignParams" - } - }, - "title": "Device/key/signRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/readFile" - ], - "title": "Fs/readFileRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/FsReadFileParams" - } - }, - "title": "Fs/readFileRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/writeFile" - ], - "title": "Fs/writeFileRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/FsWriteFileParams" - } - }, - "title": "Fs/writeFileRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/createDirectory" - ], - "title": "Fs/createDirectoryRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/FsCreateDirectoryParams" - } - }, - "title": "Fs/createDirectoryRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/getMetadata" - ], - "title": "Fs/getMetadataRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/FsGetMetadataParams" - } - }, - "title": "Fs/getMetadataRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/readDirectory" - ], - "title": "Fs/readDirectoryRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/FsReadDirectoryParams" - } - }, - "title": "Fs/readDirectoryRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/remove" - ], - "title": "Fs/removeRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/FsRemoveParams" - } - }, - "title": "Fs/removeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/copy" - ], - "title": "Fs/copyRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/FsCopyParams" - } - }, - "title": "Fs/copyRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/watch" - ], - "title": "Fs/watchRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/FsWatchParams" - } - }, - "title": "Fs/watchRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/unwatch" - ], - "title": "Fs/unwatchRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/FsUnwatchParams" - } - }, - "title": "Fs/unwatchRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "turn/start" - ], - "title": "Turn/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/TurnStartParams" - } - }, - "title": "Turn/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "turn/steer" - ], - "title": "Turn/steerRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/TurnSteerParams" - } - }, - "title": "Turn/steerRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "turn/interrupt" - ], - "title": "Turn/interruptRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/TurnInterruptParams" - } - }, - "title": "Turn/interruptRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "review/start" - ], - "title": "Review/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ReviewStartParams" - } - }, - "title": "Review/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "model/list" - ], - "title": "Model/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ModelListParams" - } - }, - "title": "Model/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "experimentalFeature/list" - ], - "title": "ExperimentalFeature/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ExperimentalFeatureListParams" - } - }, - "title": "ExperimentalFeature/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "experimentalFeature/enablement/set" - ], - "title": "ExperimentalFeature/enablement/setRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ExperimentalFeatureEnablementSetParams" - } - }, - "title": "ExperimentalFeature/enablement/setRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServer/oauth/login" - ], - "title": "McpServer/oauth/loginRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/McpServerOauthLoginParams" - } - }, - "title": "McpServer/oauth/loginRequest" - }, - { - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "config/mcpServer/reload" - ], - "title": "Config/mcpServer/reloadRequestMethod" - }, - "params": { - "type": "null" - } - }, - "title": "Config/mcpServer/reloadRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServerStatus/list" - ], - "title": "McpServerStatus/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ListMcpServerStatusParams" - } - }, - "title": "McpServerStatus/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServer/resource/read" - ], - "title": "McpServer/resource/readRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/McpResourceReadParams" - } - }, - "title": "McpServer/resource/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServer/tool/call" - ], - "title": "McpServer/tool/callRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/McpServerToolCallParams" - } - }, - "title": "McpServer/tool/callRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "windowsSandbox/setupStart" - ], - "title": "WindowsSandbox/setupStartRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/WindowsSandboxSetupStartParams" - } - }, - "title": "WindowsSandbox/setupStartRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/login/start" - ], - "title": "Account/login/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/LoginAccountParams" - } - }, - "title": "Account/login/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/login/cancel" - ], - "title": "Account/login/cancelRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/CancelLoginAccountParams" - } - }, - "title": "Account/login/cancelRequest" - }, - { - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/logout" - ], - "title": "Account/logoutRequestMethod" - }, - "params": { - "type": "null" - } - }, - "title": "Account/logoutRequest" - }, - { - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/rateLimits/read" - ], - "title": "Account/rateLimits/readRequestMethod" - }, - "params": { - "type": "null" - } - }, - "title": "Account/rateLimits/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/sendAddCreditsNudgeEmail" - ], - "title": "Account/sendAddCreditsNudgeEmailRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/SendAddCreditsNudgeEmailParams" - } - }, - "title": "Account/sendAddCreditsNudgeEmailRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "feedback/upload" - ], - "title": "Feedback/uploadRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/FeedbackUploadParams" - } - }, - "title": "Feedback/uploadRequest" - }, - { - "description": "Execute a standalone command (argv vector) under the server's sandbox.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "command/exec" - ], - "title": "Command/execRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/CommandExecParams" - } - }, - "title": "Command/execRequest" - }, - { - "description": "Write stdin bytes to a running `command/exec` session or close stdin.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "command/exec/write" - ], - "title": "Command/exec/writeRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/CommandExecWriteParams" - } - }, - "title": "Command/exec/writeRequest" - }, - { - "description": "Terminate a running `command/exec` session by client-supplied `processId`.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "command/exec/terminate" - ], - "title": "Command/exec/terminateRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/CommandExecTerminateParams" - } - }, - "title": "Command/exec/terminateRequest" - }, - { - "description": "Resize a running PTY-backed `command/exec` session by client-supplied `processId`.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "command/exec/resize" - ], - "title": "Command/exec/resizeRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/CommandExecResizeParams" - } - }, - "title": "Command/exec/resizeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "config/read" - ], - "title": "Config/readRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ConfigReadParams" - } - }, - "title": "Config/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "config/value/write" - ], - "title": "Config/value/writeRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ConfigValueWriteParams" - } - }, - "title": "Config/value/writeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "config/batchWrite" - ], - "title": "Config/batchWriteRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/ConfigBatchWriteParams" - } - }, - "title": "Config/batchWriteRequest" - }, - { - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "configRequirements/read" - ], - "title": "ConfigRequirements/readRequestMethod" - }, - "params": { - "type": "null" - } - }, - "title": "ConfigRequirements/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/read" - ], - "title": "Account/readRequestMethod" - }, - "params": { - "$ref": "#/definitions/v2/GetAccountParams" - } - }, - "title": "Account/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fuzzyFileSearch" - ], - "title": "FuzzyFileSearchRequestMethod" - }, - "params": { - "$ref": "#/definitions/FuzzyFileSearchParams" - } - }, - "title": "FuzzyFileSearchRequest" - } - ] + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" }, "AdditionalPermissionProfile": { - "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -1802,17 +27,11 @@ } ] } - } + }, + "type": "object" }, "ApplyPatchApprovalParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ApplyPatchApprovalParams", - "type": "object", - "required": [ - "callId", - "conversationId", - "fileChanges" - ], "properties": { "callId": { "description": "Use to correlate this with [codex_protocol::protocol::PatchApplyBeginEvent] and [codex_protocol::protocol::PatchApplyEndEvent].", @@ -1822,10 +41,10 @@ "$ref": "#/definitions/v2/ThreadId" }, "fileChanges": { - "type": "object", "additionalProperties": { "$ref": "#/definitions/FileChange" - } + }, + "type": "object" }, "grantRoot": { "description": "When set, the agent is asking the user to allow writes under this root for the remainder of the session (unclear if this is honored today).", @@ -1841,15 +60,30 @@ "null" ] } - } + }, + "required": [ + "callId", + "conversationId", + "fileChanges" + ], + "title": "ApplyPatchApprovalParams", + "type": "object" + }, + "ApplyPatchApprovalResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "decision": { + "$ref": "#/definitions/ReviewDecision" + } + }, + "required": [ + "decision" + ], + "title": "ApplyPatchApprovalResponse", + "type": "object" }, "ChatgptAuthTokensRefreshParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ChatgptAuthTokensRefreshParams", - "type": "object", - "required": [ - "reason" - ], "properties": { "previousAccountId": { "description": "Workspace/account identifier that Codex was previously using.\n\nClients that manage multiple accounts/workspaces can use this as a hint to refresh the token for the correct workspace.\n\nThis may be `null` when the prior auth state did not include a workspace identifier (`chatgpt_account_id`).", @@ -1861,111 +95,1597 @@ "reason": { "$ref": "#/definitions/ChatgptAuthTokensRefreshReason" } - } + }, + "required": [ + "reason" + ], + "title": "ChatgptAuthTokensRefreshParams", + "type": "object" }, "ChatgptAuthTokensRefreshReason": { "oneOf": [ { "description": "Codex attempted a backend request and received `401 Unauthorized`.", - "type": "string", "enum": [ "unauthorized" - ] + ], + "type": "string" } ] }, + "ChatgptAuthTokensRefreshResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "accessToken": { + "type": "string" + }, + "chatgptAccountId": { + "type": "string" + }, + "chatgptPlanType": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "accessToken", + "chatgptAccountId" + ], + "title": "ChatgptAuthTokensRefreshResponse", + "type": "object" + }, + "ClientInfo": { + "properties": { + "name": { + "type": "string" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "version": { + "type": "string" + } + }, + "required": [ + "name", + "version" + ], + "type": "object" + }, + "ClientNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "oneOf": [ + { + "properties": { + "method": { + "enum": [ + "initialized" + ], + "title": "InitializedNotificationMethod", + "type": "string" + } + }, + "required": [ + "method" + ], + "title": "InitializedNotification", + "type": "object" + } + ], + "title": "ClientNotification" + }, + "ClientRequest": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Request from the client to the server.", + "oneOf": [ + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "initialize" + ], + "title": "InitializeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/InitializeParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "InitializeRequest", + "type": "object" + }, + { + "description": "NEW APIs", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/start" + ], + "title": "Thread/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/resume" + ], + "title": "Thread/resumeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadResumeParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/resumeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/fork" + ], + "title": "Thread/forkRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadForkParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/forkRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/archive" + ], + "title": "Thread/archiveRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadArchiveParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/archiveRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/unsubscribe" + ], + "title": "Thread/unsubscribeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadUnsubscribeParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/unsubscribeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/name/set" + ], + "title": "Thread/name/setRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadSetNameParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/name/setRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/metadata/update" + ], + "title": "Thread/metadata/updateRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadMetadataUpdateParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/metadata/updateRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/unarchive" + ], + "title": "Thread/unarchiveRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadUnarchiveParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/unarchiveRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/compact/start" + ], + "title": "Thread/compact/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadCompactStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/compact/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/shellCommand" + ], + "title": "Thread/shellCommandRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadShellCommandParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/shellCommandRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/approveGuardianDeniedAction" + ], + "title": "Thread/approveGuardianDeniedActionRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadApproveGuardianDeniedActionParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/approveGuardianDeniedActionRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/rollback" + ], + "title": "Thread/rollbackRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadRollbackParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/rollbackRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/list" + ], + "title": "Thread/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/loaded/list" + ], + "title": "Thread/loaded/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadLoadedListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/loaded/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/read" + ], + "title": "Thread/readRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadReadParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/turns/list" + ], + "title": "Thread/turns/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadTurnsListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/turns/listRequest", + "type": "object" + }, + { + "description": "Append raw Responses API items to the thread history without starting a user turn.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "thread/inject_items" + ], + "title": "Thread/injectItemsRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadInjectItemsParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/injectItemsRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "device/key/create" + ], + "title": "Device/key/createRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/DeviceKeyCreateParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Device/key/createRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "device/key/public" + ], + "title": "Device/key/publicRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/DeviceKeyPublicParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Device/key/publicRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "device/key/sign" + ], + "title": "Device/key/signRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/DeviceKeySignParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Device/key/signRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "fs/readFile" + ], + "title": "Fs/readFileRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FsReadFileParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/readFileRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "fs/writeFile" + ], + "title": "Fs/writeFileRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FsWriteFileParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/writeFileRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "fs/createDirectory" + ], + "title": "Fs/createDirectoryRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FsCreateDirectoryParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/createDirectoryRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "fs/getMetadata" + ], + "title": "Fs/getMetadataRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FsGetMetadataParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/getMetadataRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "fs/readDirectory" + ], + "title": "Fs/readDirectoryRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FsReadDirectoryParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/readDirectoryRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "fs/remove" + ], + "title": "Fs/removeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FsRemoveParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/removeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "fs/copy" + ], + "title": "Fs/copyRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FsCopyParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/copyRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "fs/watch" + ], + "title": "Fs/watchRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FsWatchParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/watchRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "fs/unwatch" + ], + "title": "Fs/unwatchRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FsUnwatchParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/unwatchRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "turn/start" + ], + "title": "Turn/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/TurnStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Turn/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "turn/steer" + ], + "title": "Turn/steerRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/TurnSteerParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Turn/steerRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "turn/interrupt" + ], + "title": "Turn/interruptRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/TurnInterruptParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Turn/interruptRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "review/start" + ], + "title": "Review/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ReviewStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Review/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "model/list" + ], + "title": "Model/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ModelListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Model/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "experimentalFeature/list" + ], + "title": "ExperimentalFeature/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ExperimentalFeatureListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "ExperimentalFeature/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "experimentalFeature/enablement/set" + ], + "title": "ExperimentalFeature/enablement/setRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ExperimentalFeatureEnablementSetParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "ExperimentalFeature/enablement/setRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "mcpServer/oauth/login" + ], + "title": "McpServer/oauth/loginRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/McpServerOauthLoginParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServer/oauth/loginRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "config/mcpServer/reload" + ], + "title": "Config/mcpServer/reloadRequestMethod", + "type": "string" + }, + "params": { + "type": "null" + } + }, + "required": [ + "id", + "method" + ], + "title": "Config/mcpServer/reloadRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "mcpServerStatus/list" + ], + "title": "McpServerStatus/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ListMcpServerStatusParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServerStatus/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "mcpServer/resource/read" + ], + "title": "McpServer/resource/readRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/McpResourceReadParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServer/resource/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "mcpServer/tool/call" + ], + "title": "McpServer/tool/callRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/McpServerToolCallParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServer/tool/callRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "windowsSandbox/setupStart" + ], + "title": "WindowsSandbox/setupStartRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/WindowsSandboxSetupStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "WindowsSandbox/setupStartRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "account/login/start" + ], + "title": "Account/login/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/LoginAccountParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/login/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "account/login/cancel" + ], + "title": "Account/login/cancelRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/CancelLoginAccountParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/login/cancelRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "account/logout" + ], + "title": "Account/logoutRequestMethod", + "type": "string" + }, + "params": { + "type": "null" + } + }, + "required": [ + "id", + "method" + ], + "title": "Account/logoutRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "account/rateLimits/read" + ], + "title": "Account/rateLimits/readRequestMethod", + "type": "string" + }, + "params": { + "type": "null" + } + }, + "required": [ + "id", + "method" + ], + "title": "Account/rateLimits/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "account/sendAddCreditsNudgeEmail" + ], + "title": "Account/sendAddCreditsNudgeEmailRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/SendAddCreditsNudgeEmailParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/sendAddCreditsNudgeEmailRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "feedback/upload" + ], + "title": "Feedback/uploadRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FeedbackUploadParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Feedback/uploadRequest", + "type": "object" + }, + { + "description": "Execute a standalone command (argv vector) under the server's sandbox.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "command/exec" + ], + "title": "Command/execRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/CommandExecParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Command/execRequest", + "type": "object" + }, + { + "description": "Write stdin bytes to a running `command/exec` session or close stdin.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "command/exec/write" + ], + "title": "Command/exec/writeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/CommandExecWriteParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Command/exec/writeRequest", + "type": "object" + }, + { + "description": "Terminate a running `command/exec` session by client-supplied `processId`.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "command/exec/terminate" + ], + "title": "Command/exec/terminateRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/CommandExecTerminateParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Command/exec/terminateRequest", + "type": "object" + }, + { + "description": "Resize a running PTY-backed `command/exec` session by client-supplied `processId`.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "command/exec/resize" + ], + "title": "Command/exec/resizeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/CommandExecResizeParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Command/exec/resizeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "config/read" + ], + "title": "Config/readRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ConfigReadParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Config/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "config/value/write" + ], + "title": "Config/value/writeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ConfigValueWriteParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Config/value/writeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "config/batchWrite" + ], + "title": "Config/batchWriteRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ConfigBatchWriteParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Config/batchWriteRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "configRequirements/read" + ], + "title": "ConfigRequirements/readRequestMethod", + "type": "string" + }, + "params": { + "type": "null" + } + }, + "required": [ + "id", + "method" + ], + "title": "ConfigRequirements/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "account/read" + ], + "title": "Account/readRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/GetAccountParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "fuzzyFileSearch" + ], + "title": "FuzzyFileSearchRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FuzzyFileSearchParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "FuzzyFileSearchRequest", + "type": "object" + } + ], + "title": "ClientRequest" + }, "CommandExecutionApprovalDecision": { "oneOf": [ { "description": "User approved the command.", - "type": "string", "enum": [ "accept" - ] + ], + "type": "string" }, { "description": "User approved the command and future prompts in the same session-scoped approval cache should run without prompting.", - "type": "string", "enum": [ "acceptForSession" - ] + ], + "type": "string" }, { + "additionalProperties": false, "description": "User approved the command, and wants to apply the proposed execpolicy amendment so future matching commands can run without prompting.", - "type": "object", - "required": [ - "acceptWithExecpolicyAmendment" - ], "properties": { "acceptWithExecpolicyAmendment": { - "type": "object", + "properties": { + "execpolicy_amendment": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "execpolicy_amendment" ], - "properties": { - "execpolicy_amendment": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" } }, - "additionalProperties": false, - "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision" + "required": [ + "acceptWithExecpolicyAmendment" + ], + "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision", + "type": "object" }, { + "additionalProperties": false, "description": "User chose a persistent network policy rule (allow/deny) for this host.", - "type": "object", - "required": [ - "applyNetworkPolicyAmendment" - ], "properties": { "applyNetworkPolicyAmendment": { - "type": "object", - "required": [ - "network_policy_amendment" - ], "properties": { "network_policy_amendment": { "$ref": "#/definitions/NetworkPolicyAmendment" } - } + }, + "required": [ + "network_policy_amendment" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision" + "required": [ + "applyNetworkPolicyAmendment" + ], + "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision", + "type": "object" }, { "description": "User denied the command. The agent will continue the turn.", - "type": "string", "enum": [ "decline" - ] + ], + "type": "string" }, { "description": "User denied the command. The turn will also be immediately interrupted.", - "type": "string", "enum": [ "cancel" - ] + ], + "type": "string" } ] }, "CommandExecutionRequestApprovalParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecutionRequestApprovalParams", - "type": "object", - "required": [ - "itemId", - "threadId", - "turnId" - ], "properties": { - "threadId": { - "type": "string" - }, "approvalId": { "description": "Unique identifier for this specific approval callback.\n\nFor regular shell/unified_exec approvals, this is null.\n\nFor zsh-exec-bridge subcommand approvals, multiple callbacks can belong to one parent `itemId`, so `approvalId` is a distinct opaque callback id (a UUID) used to disambiguate routing.", "type": [ @@ -1973,9 +1693,6 @@ "null" ] }, - "turnId": { - "type": "string" - }, "command": { "description": "The command to be executed.", "type": [ @@ -1985,16 +1702,15 @@ }, "commandActions": { "description": "Best-effort parsed command actions for friendly display.", + "items": { + "$ref": "#/definitions/v2/CommandAction" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/v2/CommandAction" - } + ] }, "cwd": { - "description": "The command's working directory.", "anyOf": [ { "$ref": "#/definitions/v2/AbsolutePathBuf" @@ -2002,13 +1718,13 @@ { "type": "null" } - ] + ], + "description": "The command's working directory." }, "itemId": { "type": "string" }, "networkApprovalContext": { - "description": "Optional context for a managed-network approval prompt.", "anyOf": [ { "$ref": "#/definitions/NetworkApprovalContext" @@ -2016,27 +1732,28 @@ { "type": "null" } - ] + ], + "description": "Optional context for a managed-network approval prompt." }, "proposedExecpolicyAmendment": { "description": "Optional proposed execpolicy amendment to allow similar commands without prompting.", + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "proposedNetworkPolicyAmendments": { "description": "Optional proposed network policy amendments (allow/deny host) for future requests.", + "items": { + "$ref": "#/definitions/NetworkPolicyAmendment" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/NetworkPolicyAmendment" - } + ] }, "reason": { "description": "Optional explanatory reason (e.g. request for network access).", @@ -2044,20 +1761,37 @@ "string", "null" ] + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" } - } + }, + "required": [ + "itemId", + "threadId", + "turnId" + ], + "title": "CommandExecutionRequestApprovalParams", + "type": "object" + }, + "CommandExecutionRequestApprovalResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "decision": { + "$ref": "#/definitions/CommandExecutionApprovalDecision" + } + }, + "required": [ + "decision" + ], + "title": "CommandExecutionRequestApprovalResponse", + "type": "object" }, "DynamicToolCallParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DynamicToolCallParams", - "type": "object", - "required": [ - "arguments", - "callId", - "threadId", - "tool", - "turnId" - ], "properties": { "arguments": true, "callId": { @@ -2078,19 +1812,39 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "arguments", + "callId", + "threadId", + "tool", + "turnId" + ], + "title": "DynamicToolCallParams", + "type": "object" + }, + "DynamicToolCallResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "contentItems": { + "items": { + "$ref": "#/definitions/v2/DynamicToolCallOutputContentItem" + }, + "type": "array" + }, + "success": { + "type": "boolean" + } + }, + "required": [ + "contentItems", + "success" + ], + "title": "DynamicToolCallResponse", + "type": "object" }, "ExecCommandApprovalParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExecCommandApprovalParams", - "type": "object", - "required": [ - "callId", - "command", - "conversationId", - "cwd", - "parsedCmd" - ], "properties": { "approvalId": { "description": "Identifier for this specific approval callback.", @@ -2104,10 +1858,10 @@ "type": "string" }, "command": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "conversationId": { "$ref": "#/definitions/v2/ThreadId" @@ -2116,10 +1870,10 @@ "type": "string" }, "parsedCmd": { - "type": "array", "items": { "$ref": "#/definitions/ParsedCommand" - } + }, + "type": "array" }, "reason": { "type": [ @@ -2127,56 +1881,73 @@ "null" ] } - } + }, + "required": [ + "callId", + "command", + "conversationId", + "cwd", + "parsedCmd" + ], + "title": "ExecCommandApprovalParams", + "type": "object" + }, + "ExecCommandApprovalResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "decision": { + "$ref": "#/definitions/ReviewDecision" + } + }, + "required": [ + "decision" + ], + "title": "ExecCommandApprovalResponse", + "type": "object" }, "FileChange": { "oneOf": [ { - "type": "object", - "required": [ - "content", - "type" - ], "properties": { "content": { "type": "string" }, "type": { - "type": "string", "enum": [ "add" ], - "title": "AddFileChangeType" + "title": "AddFileChangeType", + "type": "string" } }, - "title": "AddFileChange" - }, - { - "type": "object", "required": [ "content", "type" ], + "title": "AddFileChange", + "type": "object" + }, + { "properties": { "content": { "type": "string" }, "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeleteFileChangeType" + "title": "DeleteFileChangeType", + "type": "string" } }, - "title": "DeleteFileChange" + "required": [ + "content", + "type" + ], + "title": "DeleteFileChange", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "unified_diff" - ], "properties": { "move_path": { "type": [ @@ -2185,29 +1956,59 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdateFileChangeType" + "title": "UpdateFileChangeType", + "type": "string" }, "unified_diff": { "type": "string" } }, - "title": "UpdateFileChange" + "required": [ + "type", + "unified_diff" + ], + "title": "UpdateFileChange", + "type": "object" + } + ] + }, + "FileChangeApprovalDecision": { + "oneOf": [ + { + "description": "User approved the file changes.", + "enum": [ + "accept" + ], + "type": "string" + }, + { + "description": "User approved the file changes and future changes to the same files should run without prompting.", + "enum": [ + "acceptForSession" + ], + "type": "string" + }, + { + "description": "User denied the file changes. The agent will continue the turn.", + "enum": [ + "decline" + ], + "type": "string" + }, + { + "description": "User denied the file changes. The turn will also be immediately interrupted.", + "enum": [ + "cancel" + ], + "type": "string" } ] }, "FileChangeRequestApprovalParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FileChangeRequestApprovalParams", - "type": "object", - "required": [ - "itemId", - "threadId", - "turnId" - ], "properties": { "grantRoot": { "description": "[UNSTABLE] When set, the agent is asking the user to allow writes under this root for the remainder of the session (unclear if this is honored today).", @@ -2232,19 +2033,381 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "itemId", + "threadId", + "turnId" + ], + "title": "FileChangeRequestApprovalParams", + "type": "object" + }, + "FileChangeRequestApprovalResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "decision": { + "$ref": "#/definitions/FileChangeApprovalDecision" + } + }, + "required": [ + "decision" + ], + "title": "FileChangeRequestApprovalResponse", + "type": "object" + }, + "FuzzyFileSearchMatchType": { + "enum": [ + "file", + "directory" + ], + "type": "string" + }, + "FuzzyFileSearchParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cancellationToken": { + "type": [ + "string", + "null" + ] + }, + "query": { + "type": "string" + }, + "roots": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "query", + "roots" + ], + "title": "FuzzyFileSearchParams", + "type": "object" + }, + "FuzzyFileSearchResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "files": { + "items": { + "$ref": "#/definitions/FuzzyFileSearchResult" + }, + "type": "array" + } + }, + "required": [ + "files" + ], + "title": "FuzzyFileSearchResponse", + "type": "object" + }, + "FuzzyFileSearchResult": { + "description": "Superset of [`codex_file_search::FileMatch`]", + "properties": { + "file_name": { + "type": "string" + }, + "indices": { + "items": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "type": [ + "array", + "null" + ] + }, + "match_type": { + "$ref": "#/definitions/FuzzyFileSearchMatchType" + }, + "path": { + "type": "string" + }, + "root": { + "type": "string" + }, + "score": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "file_name", + "match_type", + "path", + "root", + "score" + ], + "type": "object" + }, + "FuzzyFileSearchSessionCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "sessionId": { + "type": "string" + } + }, + "required": [ + "sessionId" + ], + "title": "FuzzyFileSearchSessionCompletedNotification", + "type": "object" + }, + "FuzzyFileSearchSessionUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "files": { + "items": { + "$ref": "#/definitions/FuzzyFileSearchResult" + }, + "type": "array" + }, + "query": { + "type": "string" + }, + "sessionId": { + "type": "string" + } + }, + "required": [ + "files", + "query", + "sessionId" + ], + "title": "FuzzyFileSearchSessionUpdatedNotification", + "type": "object" + }, + "GrantedPermissionProfile": { + "properties": { + "fileSystem": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AdditionalFileSystemPermissions" + }, + { + "type": "null" + } + ] + }, + "network": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AdditionalNetworkPermissions" + }, + { + "type": "null" + } + ] + } + }, + "type": "object" + }, + "InitializeCapabilities": { + "description": "Client-declared capabilities negotiated during initialize.", + "properties": { + "experimentalApi": { + "default": false, + "description": "Opt into receiving experimental API methods and fields.", + "type": "boolean" + }, + "optOutNotificationMethods": { + "description": "Exact notification method names that should be suppressed for this connection (for example `thread/started`).", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + } + }, + "type": "object" + }, + "InitializeParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "capabilities": { + "anyOf": [ + { + "$ref": "#/definitions/InitializeCapabilities" + }, + { + "type": "null" + } + ] + }, + "clientInfo": { + "$ref": "#/definitions/ClientInfo" + } + }, + "required": [ + "clientInfo" + ], + "title": "InitializeParams", + "type": "object" + }, + "InitializeResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "codexHome": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Absolute path to the server's $CODEX_HOME directory." + }, + "platformFamily": { + "description": "Platform family for the running app-server target, for example `\"unix\"` or `\"windows\"`.", + "type": "string" + }, + "platformOs": { + "description": "Operating system for the running app-server target, for example `\"macos\"`, `\"linux\"`, or `\"windows\"`.", + "type": "string" + }, + "userAgent": { + "type": "string" + } + }, + "required": [ + "codexHome", + "platformFamily", + "platformOs", + "userAgent" + ], + "title": "InitializeResponse", + "type": "object" + }, + "JSONRPCError": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "A response to a request that indicates an error occurred.", + "properties": { + "error": { + "$ref": "#/definitions/JSONRPCErrorError" + }, + "id": { + "$ref": "#/definitions/v2/RequestId" + } + }, + "required": [ + "error", + "id" + ], + "title": "JSONRPCError", + "type": "object" + }, + "JSONRPCErrorError": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "code": { + "format": "int64", + "type": "integer" + }, + "data": true, + "message": { + "type": "string" + } + }, + "required": [ + "code", + "message" + ], + "title": "JSONRPCErrorError", + "type": "object" + }, + "JSONRPCMessage": { + "$schema": "http://json-schema.org/draft-07/schema#", + "anyOf": [ + { + "$ref": "#/definitions/JSONRPCRequest" + }, + { + "$ref": "#/definitions/JSONRPCNotification" + }, + { + "$ref": "#/definitions/JSONRPCResponse" + }, + { + "$ref": "#/definitions/JSONRPCError" + } + ], + "description": "Refers to any valid JSON-RPC object that can be decoded off the wire, or encoded to be sent.", + "title": "JSONRPCMessage" + }, + "JSONRPCNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "A notification which does not expect a response.", + "properties": { + "method": { + "type": "string" + }, + "params": true + }, + "required": [ + "method" + ], + "title": "JSONRPCNotification", + "type": "object" + }, + "JSONRPCRequest": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "A request that expects a response.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "type": "string" + }, + "params": true, + "trace": { + "anyOf": [ + { + "$ref": "#/definitions/W3cTraceContext" + }, + { + "type": "null" + } + ], + "description": "Optional W3C Trace Context for distributed tracing." + } + }, + "required": [ + "id", + "method" + ], + "title": "JSONRPCRequest", + "type": "object" + }, + "JSONRPCResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "A successful (non-error) response to a request.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "result": true + }, + "required": [ + "id", + "result" + ], + "title": "JSONRPCResponse", + "type": "object" }, "McpElicitationArrayType": { - "type": "string", "enum": [ "array" - ] + ], + "type": "string" }, "McpElicitationBooleanSchema": { - "type": "object", - "required": [ - "type" - ], + "additionalProperties": false, "properties": { "default": { "type": [ @@ -2268,20 +2431,19 @@ "$ref": "#/definitions/McpElicitationBooleanType" } }, - "additionalProperties": false + "required": [ + "type" + ], + "type": "object" }, "McpElicitationBooleanType": { - "type": "string", "enum": [ "boolean" - ] + ], + "type": "string" }, "McpElicitationConstOption": { - "type": "object", - "required": [ - "const", - "title" - ], + "additionalProperties": false, "properties": { "const": { "type": "string" @@ -2290,7 +2452,11 @@ "type": "string" } }, - "additionalProperties": false + "required": [ + "const", + "title" + ], + "type": "object" }, "McpElicitationEnumSchema": { "anyOf": [ @@ -2306,11 +2472,7 @@ ] }, "McpElicitationLegacyTitledEnumSchema": { - "type": "object", - "required": [ - "enum", - "type" - ], + "additionalProperties": false, "properties": { "default": { "type": [ @@ -2325,19 +2487,19 @@ ] }, "enum": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "enumNames": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "title": { "type": [ @@ -2349,7 +2511,11 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false + "required": [ + "enum", + "type" + ], + "type": "object" }, "McpElicitationMultiSelectEnumSchema": { "anyOf": [ @@ -2362,17 +2528,14 @@ ] }, "McpElicitationNumberSchema": { - "type": "object", - "required": [ - "type" - ], + "additionalProperties": false, "properties": { "default": { + "format": "double", "type": [ "number", "null" - ], - "format": "double" + ] }, "description": { "type": [ @@ -2381,18 +2544,18 @@ ] }, "maximum": { + "format": "double", "type": [ "number", "null" - ], - "format": "double" + ] }, "minimum": { + "format": "double", "type": [ "number", "null" - ], - "format": "double" + ] }, "title": { "type": [ @@ -2404,20 +2567,23 @@ "$ref": "#/definitions/McpElicitationNumberType" } }, - "additionalProperties": false + "required": [ + "type" + ], + "type": "object" }, "McpElicitationNumberType": { - "type": "string", "enum": [ "number", "integer" - ] + ], + "type": "string" }, "McpElicitationObjectType": { - "type": "string", "enum": [ "object" - ] + ], + "type": "string" }, "McpElicitationPrimitiveSchema": { "anyOf": [ @@ -2436,12 +2602,8 @@ ] }, "McpElicitationSchema": { + "additionalProperties": false, "description": "Typed form schema for MCP `elicitation/create` requests.\n\nThis matches the `requestedSchema` shape from the MCP 2025-11-25 `ElicitRequestFormParams` schema.", - "type": "object", - "required": [ - "properties", - "type" - ], "properties": { "$schema": { "type": [ @@ -2450,25 +2612,29 @@ ] }, "properties": { - "type": "object", "additionalProperties": { "$ref": "#/definitions/McpElicitationPrimitiveSchema" - } + }, + "type": "object" }, "required": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "type": { "$ref": "#/definitions/McpElicitationObjectType" } }, - "additionalProperties": false + "required": [ + "properties", + "type" + ], + "type": "object" }, "McpElicitationSingleSelectEnumSchema": { "anyOf": [ @@ -2481,19 +2647,16 @@ ] }, "McpElicitationStringFormat": { - "type": "string", "enum": [ "email", "uri", "date", "date-time" - ] + ], + "type": "string" }, "McpElicitationStringSchema": { - "type": "object", - "required": [ - "type" - ], + "additionalProperties": false, "properties": { "default": { "type": [ @@ -2518,20 +2681,20 @@ ] }, "maxLength": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "minLength": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "title": { "type": [ @@ -2543,44 +2706,43 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false + "required": [ + "type" + ], + "type": "object" }, "McpElicitationStringType": { - "type": "string", "enum": [ "string" - ] + ], + "type": "string" }, "McpElicitationTitledEnumItems": { - "type": "object", + "additionalProperties": false, + "properties": { + "anyOf": { + "items": { + "$ref": "#/definitions/McpElicitationConstOption" + }, + "type": "array" + } + }, "required": [ "anyOf" ], - "properties": { - "anyOf": { - "type": "array", - "items": { - "$ref": "#/definitions/McpElicitationConstOption" - } - } - }, - "additionalProperties": false + "type": "object" }, "McpElicitationTitledMultiSelectEnumSchema": { - "type": "object", - "required": [ - "items", - "type" - ], + "additionalProperties": false, "properties": { "default": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "description": { "type": [ @@ -2592,20 +2754,20 @@ "$ref": "#/definitions/McpElicitationTitledEnumItems" }, "maxItems": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "minItems": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "title": { "type": [ @@ -2617,14 +2779,14 @@ "$ref": "#/definitions/McpElicitationArrayType" } }, - "additionalProperties": false - }, - "McpElicitationTitledSingleSelectEnumSchema": { - "type": "object", "required": [ - "oneOf", + "items", "type" ], + "type": "object" + }, + "McpElicitationTitledSingleSelectEnumSchema": { + "additionalProperties": false, "properties": { "default": { "type": [ @@ -2639,10 +2801,10 @@ ] }, "oneOf": { - "type": "array", "items": { "$ref": "#/definitions/McpElicitationConstOption" - } + }, + "type": "array" }, "title": { "type": [ @@ -2654,42 +2816,42 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false - }, - "McpElicitationUntitledEnumItems": { - "type": "object", "required": [ - "enum", + "oneOf", "type" ], + "type": "object" + }, + "McpElicitationUntitledEnumItems": { + "additionalProperties": false, "properties": { "enum": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false - }, - "McpElicitationUntitledMultiSelectEnumSchema": { - "type": "object", "required": [ - "items", + "enum", "type" ], + "type": "object" + }, + "McpElicitationUntitledMultiSelectEnumSchema": { + "additionalProperties": false, "properties": { "default": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "description": { "type": [ @@ -2701,20 +2863,20 @@ "$ref": "#/definitions/McpElicitationUntitledEnumItems" }, "maxItems": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "minItems": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "title": { "type": [ @@ -2726,14 +2888,14 @@ "$ref": "#/definitions/McpElicitationArrayType" } }, - "additionalProperties": false - }, - "McpElicitationUntitledSingleSelectEnumSchema": { - "type": "object", "required": [ - "enum", + "items", "type" ], + "type": "object" + }, + "McpElicitationUntitledSingleSelectEnumSchema": { + "additionalProperties": false, "properties": { "default": { "type": [ @@ -2748,10 +2910,10 @@ ] }, "enum": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": [ @@ -2763,44 +2925,47 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "additionalProperties": false + "required": [ + "enum", + "type" + ], + "type": "object" + }, + "McpServerElicitationAction": { + "enum": [ + "accept", + "decline", + "cancel" + ], + "type": "string" }, "McpServerElicitationRequestParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerElicitationRequestParams", - "type": "object", "oneOf": [ { - "type": "object", - "required": [ - "message", - "mode", - "requestedSchema" - ], "properties": { "_meta": true, "message": { "type": "string" }, "mode": { - "type": "string", "enum": [ "form" - ] + ], + "type": "string" }, "requestedSchema": { "$ref": "#/definitions/McpElicitationSchema" } - } - }, - { - "type": "object", + }, "required": [ - "elicitationId", "message", "mode", - "url" + "requestedSchema" ], + "type": "object" + }, + { "properties": { "_meta": true, "elicitationId": { @@ -2810,21 +2975,24 @@ "type": "string" }, "mode": { - "type": "string", "enum": [ "url" - ] + ], + "type": "string" }, "url": { "type": "string" } - } + }, + "required": [ + "elicitationId", + "message", + "mode", + "url" + ], + "type": "object" } ], - "required": [ - "serverName", - "threadId" - ], "properties": { "serverName": { "type": "string" @@ -2839,14 +3007,34 @@ "null" ] } - } + }, + "required": [ + "serverName", + "threadId" + ], + "title": "McpServerElicitationRequestParams", + "type": "object" + }, + "McpServerElicitationRequestResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "_meta": { + "description": "Optional client metadata for form-mode action handling." + }, + "action": { + "$ref": "#/definitions/McpServerElicitationAction" + }, + "content": { + "description": "Structured user input for accepted elicitations, mirroring RMCP `CreateElicitationResult`.\n\nThis is nullable because decline/cancel responses have no content." + } + }, + "required": [ + "action" + ], + "title": "McpServerElicitationRequestResponse", + "type": "object" }, "NetworkApprovalContext": { - "type": "object", - "required": [ - "host", - "protocol" - ], "properties": { "host": { "type": "string" @@ -2854,14 +3042,14 @@ "protocol": { "$ref": "#/definitions/v2/NetworkApprovalProtocol" } - } + }, + "required": [ + "host", + "protocol" + ], + "type": "object" }, "NetworkPolicyAmendment": { - "type": "object", - "required": [ - "action", - "host" - ], "properties": { "action": { "$ref": "#/definitions/NetworkPolicyRuleAction" @@ -2869,25 +3057,23 @@ "host": { "type": "string" } - } + }, + "required": [ + "action", + "host" + ], + "type": "object" }, "NetworkPolicyRuleAction": { - "type": "string", "enum": [ "allow", "deny" - ] + ], + "type": "string" }, "ParsedCommand": { "oneOf": [ { - "type": "object", - "required": [ - "cmd", - "name", - "path", - "type" - ], "properties": { "cmd": { "type": "string" @@ -2900,21 +3086,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadParsedCommandType" + "title": "ReadParsedCommandType", + "type": "string" } }, - "title": "ReadParsedCommand" - }, - { - "type": "object", "required": [ "cmd", + "name", + "path", "type" ], + "title": "ReadParsedCommand", + "type": "object" + }, + { "properties": { "cmd": { "type": "string" @@ -2926,21 +3114,21 @@ ] }, "type": { - "type": "string", "enum": [ "list_files" ], - "title": "ListFilesParsedCommandType" + "title": "ListFilesParsedCommandType", + "type": "string" } }, - "title": "ListFilesParsedCommand" - }, - { - "type": "object", "required": [ "cmd", "type" ], + "title": "ListFilesParsedCommand", + "type": "object" + }, + { "properties": { "cmd": { "type": "string" @@ -2958,48 +3146,51 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchParsedCommandType" + "title": "SearchParsedCommandType", + "type": "string" } }, - "title": "SearchParsedCommand" - }, - { - "type": "object", "required": [ "cmd", "type" ], + "title": "SearchParsedCommand", + "type": "object" + }, + { "properties": { "cmd": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownParsedCommandType" + "title": "UnknownParsedCommandType", + "type": "string" } }, - "title": "UnknownParsedCommand" + "required": [ + "cmd", + "type" + ], + "title": "UnknownParsedCommand", + "type": "object" } ] }, + "PermissionGrantScope": { + "enum": [ + "turn", + "session" + ], + "type": "string" + }, "PermissionsRequestApprovalParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "PermissionsRequestApprovalParams", - "type": "object", - "required": [ - "cwd", - "itemId", - "permissions", - "threadId", - "turnId" - ], "properties": { "cwd": { "$ref": "#/definitions/v2/AbsolutePathBuf" @@ -3022,15 +3213,1525 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "cwd", + "itemId", + "permissions", + "threadId", + "turnId" + ], + "title": "PermissionsRequestApprovalParams", + "type": "object" + }, + "PermissionsRequestApprovalResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "permissions": { + "$ref": "#/definitions/GrantedPermissionProfile" + }, + "scope": { + "allOf": [ + { + "$ref": "#/definitions/PermissionGrantScope" + } + ], + "default": "turn" + }, + "strictAutoReview": { + "description": "Review every subsequent command in this turn before normal sandboxed execution.", + "type": [ + "boolean", + "null" + ] + } + }, + "required": [ + "permissions" + ], + "title": "PermissionsRequestApprovalResponse", + "type": "object" + }, + "RequestId": { + "$schema": "http://json-schema.org/draft-07/schema#", + "anyOf": [ + { + "type": "string" + }, + { + "format": "int64", + "type": "integer" + } + ], + "title": "RequestId" + }, + "ReviewDecision": { + "description": "User's decision in response to an ExecApprovalRequest.", + "oneOf": [ + { + "description": "User has approved this command and the agent should execute it.", + "enum": [ + "approved" + ], + "type": "string" + }, + { + "additionalProperties": false, + "description": "User has approved this command and wants to apply the proposed execpolicy amendment so future matching commands are permitted.", + "properties": { + "approved_execpolicy_amendment": { + "properties": { + "proposed_execpolicy_amendment": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "proposed_execpolicy_amendment" + ], + "type": "object" + } + }, + "required": [ + "approved_execpolicy_amendment" + ], + "title": "ApprovedExecpolicyAmendmentReviewDecision", + "type": "object" + }, + { + "description": "User has approved this request and wants future prompts in the same session-scoped approval cache to be automatically approved for the remainder of the session.", + "enum": [ + "approved_for_session" + ], + "type": "string" + }, + { + "additionalProperties": false, + "description": "User chose to persist a network policy rule (allow/deny) for future requests to the same host.", + "properties": { + "network_policy_amendment": { + "properties": { + "network_policy_amendment": { + "$ref": "#/definitions/NetworkPolicyAmendment" + } + }, + "required": [ + "network_policy_amendment" + ], + "type": "object" + } + }, + "required": [ + "network_policy_amendment" + ], + "title": "NetworkPolicyAmendmentReviewDecision", + "type": "object" + }, + { + "description": "User has denied this command and the agent should not execute it, but it should continue the session and try something else.", + "enum": [ + "denied" + ], + "type": "string" + }, + { + "description": "Automatic approval review timed out before reaching a decision.", + "enum": [ + "timed_out" + ], + "type": "string" + }, + { + "description": "User has denied this command and the agent should not do anything until the user's next command.", + "enum": [ + "abort" + ], + "type": "string" + } + ] + }, + "ServerNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Notification sent from the server to the client.", + "oneOf": [ + { + "description": "NEW NOTIFICATIONS", + "properties": { + "method": { + "enum": [ + "error" + ], + "title": "ErrorNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ErrorNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "ErrorNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/started" + ], + "title": "Thread/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/status/changed" + ], + "title": "Thread/status/changedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadStatusChangedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/status/changedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/archived" + ], + "title": "Thread/archivedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadArchivedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/archivedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/unarchived" + ], + "title": "Thread/unarchivedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadUnarchivedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/unarchivedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/closed" + ], + "title": "Thread/closedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadClosedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/closedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/name/updated" + ], + "title": "Thread/name/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadNameUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/name/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/tokenUsage/updated" + ], + "title": "Thread/tokenUsage/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadTokenUsageUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/tokenUsage/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "turn/started" + ], + "title": "Turn/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/TurnStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Turn/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "hook/started" + ], + "title": "Hook/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/HookStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Hook/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "turn/completed" + ], + "title": "Turn/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/TurnCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Turn/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "hook/completed" + ], + "title": "Hook/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/HookCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Hook/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "turn/diff/updated" + ], + "title": "Turn/diff/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/TurnDiffUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Turn/diff/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "turn/plan/updated" + ], + "title": "Turn/plan/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/TurnPlanUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Turn/plan/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/started" + ], + "title": "Item/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ItemStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/autoApprovalReview/started" + ], + "title": "Item/autoApprovalReview/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ItemGuardianApprovalReviewStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/autoApprovalReview/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/autoApprovalReview/completed" + ], + "title": "Item/autoApprovalReview/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ItemGuardianApprovalReviewCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/autoApprovalReview/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/completed" + ], + "title": "Item/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ItemCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/agentMessage/delta" + ], + "title": "Item/agentMessage/deltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/AgentMessageDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/agentMessage/deltaNotification", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items.", + "properties": { + "method": { + "enum": [ + "item/plan/delta" + ], + "title": "Item/plan/deltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/PlanDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/plan/deltaNotification", + "type": "object" + }, + { + "description": "Stream base64-encoded stdout/stderr chunks for a running `command/exec` session.", + "properties": { + "method": { + "enum": [ + "command/exec/outputDelta" + ], + "title": "Command/exec/outputDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/CommandExecOutputDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Command/exec/outputDeltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/commandExecution/outputDelta" + ], + "title": "Item/commandExecution/outputDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/CommandExecutionOutputDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/commandExecution/outputDeltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/commandExecution/terminalInteraction" + ], + "title": "Item/commandExecution/terminalInteractionNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/TerminalInteractionNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/commandExecution/terminalInteractionNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/fileChange/outputDelta" + ], + "title": "Item/fileChange/outputDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FileChangeOutputDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/fileChange/outputDeltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/fileChange/patchUpdated" + ], + "title": "Item/fileChange/patchUpdatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FileChangePatchUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/fileChange/patchUpdatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "serverRequest/resolved" + ], + "title": "ServerRequest/resolvedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ServerRequestResolvedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "ServerRequest/resolvedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/mcpToolCall/progress" + ], + "title": "Item/mcpToolCall/progressNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/McpToolCallProgressNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/mcpToolCall/progressNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "mcpServer/oauthLogin/completed" + ], + "title": "McpServer/oauthLogin/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/McpServerOauthLoginCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "McpServer/oauthLogin/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "mcpServer/startupStatus/updated" + ], + "title": "McpServer/startupStatus/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/McpServerStatusUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "McpServer/startupStatus/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "account/updated" + ], + "title": "Account/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/AccountUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Account/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "account/rateLimits/updated" + ], + "title": "Account/rateLimits/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/AccountRateLimitsUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Account/rateLimits/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "fs/changed" + ], + "title": "Fs/changedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/FsChangedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Fs/changedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/reasoning/summaryTextDelta" + ], + "title": "Item/reasoning/summaryTextDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ReasoningSummaryTextDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/reasoning/summaryTextDeltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/reasoning/summaryPartAdded" + ], + "title": "Item/reasoning/summaryPartAddedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ReasoningSummaryPartAddedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/reasoning/summaryPartAddedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/reasoning/textDelta" + ], + "title": "Item/reasoning/textDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ReasoningTextDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/reasoning/textDeltaNotification", + "type": "object" + }, + { + "description": "Deprecated: Use `ContextCompaction` item type instead.", + "properties": { + "method": { + "enum": [ + "thread/compacted" + ], + "title": "Thread/compactedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ContextCompactedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/compactedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "model/rerouted" + ], + "title": "Model/reroutedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ModelReroutedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Model/reroutedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "warning" + ], + "title": "WarningNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/WarningNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "WarningNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "guardianWarning" + ], + "title": "GuardianWarningNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/GuardianWarningNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "GuardianWarningNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "deprecationNotice" + ], + "title": "DeprecationNoticeNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/DeprecationNoticeNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "DeprecationNoticeNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "configWarning" + ], + "title": "ConfigWarningNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ConfigWarningNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "ConfigWarningNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/epiphany/stateUpdated" + ], + "title": "Thread/epiphany/stateUpdatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadEpiphanyStateUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/epiphany/stateUpdatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/epiphany/jobsUpdated" + ], + "title": "Thread/epiphany/jobsUpdatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadEpiphanyJobsUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/epiphany/jobsUpdatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "fuzzyFileSearch/sessionUpdated" + ], + "title": "FuzzyFileSearch/sessionUpdatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FuzzyFileSearchSessionUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "FuzzyFileSearch/sessionUpdatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "fuzzyFileSearch/sessionCompleted" + ], + "title": "FuzzyFileSearch/sessionCompletedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FuzzyFileSearchSessionCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "FuzzyFileSearch/sessionCompletedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/started" + ], + "title": "Thread/realtime/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadRealtimeStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/itemAdded" + ], + "title": "Thread/realtime/itemAddedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadRealtimeItemAddedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/itemAddedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/transcript/delta" + ], + "title": "Thread/realtime/transcript/deltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadRealtimeTranscriptDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/transcript/deltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/transcript/done" + ], + "title": "Thread/realtime/transcript/doneNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadRealtimeTranscriptDoneNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/transcript/doneNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/outputAudio/delta" + ], + "title": "Thread/realtime/outputAudio/deltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadRealtimeOutputAudioDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/outputAudio/deltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/sdp" + ], + "title": "Thread/realtime/sdpNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadRealtimeSdpNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/sdpNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/error" + ], + "title": "Thread/realtime/errorNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadRealtimeErrorNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/errorNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/closed" + ], + "title": "Thread/realtime/closedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/ThreadRealtimeClosedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/closedNotification", + "type": "object" + }, + { + "description": "Notifies the user of world-writable directories on Windows, which cannot be protected by the sandbox.", + "properties": { + "method": { + "enum": [ + "windows/worldWritableWarning" + ], + "title": "Windows/worldWritableWarningNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/WindowsWorldWritableWarningNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Windows/worldWritableWarningNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "windowsSandbox/setupCompleted" + ], + "title": "WindowsSandbox/setupCompletedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/WindowsSandboxSetupCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "WindowsSandbox/setupCompletedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "account/login/completed" + ], + "title": "Account/login/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/v2/AccountLoginCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Account/login/completedNotification", + "type": "object" + } + ], + "title": "ServerNotification" + }, + "ServerRequest": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Request initiated from the server and sent to the client.", + "oneOf": [ + { + "description": "NEW APIs Sent when approval is requested for a specific command execution. This request is used for Turns started via turn/start.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "item/commandExecution/requestApproval" + ], + "title": "Item/commandExecution/requestApprovalRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecutionRequestApprovalParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Item/commandExecution/requestApprovalRequest", + "type": "object" + }, + { + "description": "Sent when approval is requested for a specific file change. This request is used for Turns started via turn/start.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "item/fileChange/requestApproval" + ], + "title": "Item/fileChange/requestApprovalRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FileChangeRequestApprovalParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Item/fileChange/requestApprovalRequest", + "type": "object" + }, + { + "description": "EXPERIMENTAL - Request input from the user for a tool call.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "item/tool/requestUserInput" + ], + "title": "Item/tool/requestUserInputRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ToolRequestUserInputParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Item/tool/requestUserInputRequest", + "type": "object" + }, + { + "description": "Request input for an MCP server elicitation.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "mcpServer/elicitation/request" + ], + "title": "McpServer/elicitation/requestRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpServerElicitationRequestParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServer/elicitation/requestRequest", + "type": "object" + }, + { + "description": "Request approval for additional permissions from the user.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "item/permissions/requestApproval" + ], + "title": "Item/permissions/requestApprovalRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/PermissionsRequestApprovalParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Item/permissions/requestApprovalRequest", + "type": "object" + }, + { + "description": "Execute a dynamic tool call on the client.", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "item/tool/call" + ], + "title": "Item/tool/callRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/DynamicToolCallParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Item/tool/callRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "account/chatgptAuthTokens/refresh" + ], + "title": "Account/chatgptAuthTokens/refreshRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ChatgptAuthTokensRefreshParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/chatgptAuthTokens/refreshRequest", + "type": "object" + }, + { + "description": "DEPRECATED APIs below Request to approve a patch. This request is used for Turns started via the legacy APIs (i.e. SendUserTurn, SendUserMessage).", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "applyPatchApproval" + ], + "title": "ApplyPatchApprovalRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ApplyPatchApprovalParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "ApplyPatchApprovalRequest", + "type": "object" + }, + { + "description": "Request to exec a command. This request is used for Turns started via the legacy APIs (i.e. SendUserTurn, SendUserMessage).", + "properties": { + "id": { + "$ref": "#/definitions/v2/RequestId" + }, + "method": { + "enum": [ + "execCommandApproval" + ], + "title": "ExecCommandApprovalRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ExecCommandApprovalParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "ExecCommandApprovalRequest", + "type": "object" + } + ], + "title": "ServerRequest" + }, + "ToolRequestUserInputAnswer": { + "description": "EXPERIMENTAL. Captures a user's answer to a request_user_input question.", + "properties": { + "answers": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "answers" + ], + "type": "object" }, "ToolRequestUserInputOption": { "description": "EXPERIMENTAL. Defines a single selectable option for request_user_input.", - "type": "object", - "required": [ - "description", - "label" - ], "properties": { "description": { "type": "string" @@ -3038,28 +4739,25 @@ "label": { "type": "string" } - } + }, + "required": [ + "description", + "label" + ], + "type": "object" }, "ToolRequestUserInputParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ToolRequestUserInputParams", "description": "EXPERIMENTAL. Params sent with a request_user_input event.", - "type": "object", - "required": [ - "itemId", - "questions", - "threadId", - "turnId" - ], "properties": { "itemId": { "type": "string" }, "questions": { - "type": "array", "items": { "$ref": "#/definitions/ToolRequestUserInputQuestion" - } + }, + "type": "array" }, "threadId": { "type": "string" @@ -3067,16 +4765,18 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "itemId", + "questions", + "threadId", + "turnId" + ], + "title": "ToolRequestUserInputParams", + "type": "object" }, "ToolRequestUserInputQuestion": { "description": "EXPERIMENTAL. Represents one request_user_input question and its required options.", - "type": "object", - "required": [ - "header", - "id", - "question" - ], "properties": { "header": { "type": "string" @@ -3093,10262 +4793,148 @@ "type": "boolean" }, "options": { + "items": { + "$ref": "#/definitions/ToolRequestUserInputOption" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/ToolRequestUserInputOption" - } + ] }, "question": { "type": "string" } - } - }, - "ServerRequest": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ServerRequest", - "description": "Request initiated from the server and sent to the client.", - "oneOf": [ - { - "description": "NEW APIs Sent when approval is requested for a specific command execution. This request is used for Turns started via turn/start.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "item/commandExecution/requestApproval" - ], - "title": "Item/commandExecution/requestApprovalRequestMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecutionRequestApprovalParams" - } - }, - "title": "Item/commandExecution/requestApprovalRequest" - }, - { - "description": "Sent when approval is requested for a specific file change. This request is used for Turns started via turn/start.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "item/fileChange/requestApproval" - ], - "title": "Item/fileChange/requestApprovalRequestMethod" - }, - "params": { - "$ref": "#/definitions/FileChangeRequestApprovalParams" - } - }, - "title": "Item/fileChange/requestApprovalRequest" - }, - { - "description": "EXPERIMENTAL - Request input from the user for a tool call.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "item/tool/requestUserInput" - ], - "title": "Item/tool/requestUserInputRequestMethod" - }, - "params": { - "$ref": "#/definitions/ToolRequestUserInputParams" - } - }, - "title": "Item/tool/requestUserInputRequest" - }, - { - "description": "Request input for an MCP server elicitation.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServer/elicitation/request" - ], - "title": "McpServer/elicitation/requestRequestMethod" - }, - "params": { - "$ref": "#/definitions/McpServerElicitationRequestParams" - } - }, - "title": "McpServer/elicitation/requestRequest" - }, - { - "description": "Request approval for additional permissions from the user.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "item/permissions/requestApproval" - ], - "title": "Item/permissions/requestApprovalRequestMethod" - }, - "params": { - "$ref": "#/definitions/PermissionsRequestApprovalParams" - } - }, - "title": "Item/permissions/requestApprovalRequest" - }, - { - "description": "Execute a dynamic tool call on the client.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "item/tool/call" - ], - "title": "Item/tool/callRequestMethod" - }, - "params": { - "$ref": "#/definitions/DynamicToolCallParams" - } - }, - "title": "Item/tool/callRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/chatgptAuthTokens/refresh" - ], - "title": "Account/chatgptAuthTokens/refreshRequestMethod" - }, - "params": { - "$ref": "#/definitions/ChatgptAuthTokensRefreshParams" - } - }, - "title": "Account/chatgptAuthTokens/refreshRequest" - }, - { - "description": "DEPRECATED APIs below Request to approve a patch. This request is used for Turns started via the legacy APIs (i.e. SendUserTurn, SendUserMessage).", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "applyPatchApproval" - ], - "title": "ApplyPatchApprovalRequestMethod" - }, - "params": { - "$ref": "#/definitions/ApplyPatchApprovalParams" - } - }, - "title": "ApplyPatchApprovalRequest" - }, - { - "description": "Request to exec a command. This request is used for Turns started via the legacy APIs (i.e. SendUserTurn, SendUserMessage).", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/v2/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "execCommandApproval" - ], - "title": "ExecCommandApprovalRequestMethod" - }, - "params": { - "$ref": "#/definitions/ExecCommandApprovalParams" - } - }, - "title": "ExecCommandApprovalRequest" - } - ] - }, - "ClientNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ClientNotification", - "oneOf": [ - { - "type": "object", - "required": [ - "method" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "initialized" - ], - "title": "InitializedNotificationMethod" - } - }, - "title": "InitializedNotification" - } - ] - }, - "FuzzyFileSearchMatchType": { - "type": "string", - "enum": [ - "file", - "directory" - ] - }, - "FuzzyFileSearchResult": { - "description": "Superset of [`codex_file_search::FileMatch`]", - "type": "object", + }, "required": [ - "file_name", - "match_type", - "path", - "root", - "score" + "header", + "id", + "question" ], + "type": "object" + }, + "ToolRequestUserInputResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL. Response payload mapping question ids to answers.", "properties": { - "file_name": { - "type": "string" - }, - "indices": { + "answers": { + "additionalProperties": { + "$ref": "#/definitions/ToolRequestUserInputAnswer" + }, + "type": "object" + } + }, + "required": [ + "answers" + ], + "title": "ToolRequestUserInputResponse", + "type": "object" + }, + "W3cTraceContext": { + "properties": { + "traceparent": { "type": [ - "array", + "string", "null" - ], - "items": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - } + ] }, - "match_type": { - "$ref": "#/definitions/FuzzyFileSearchMatchType" - }, - "path": { - "type": "string" - }, - "root": { - "type": "string" - }, - "score": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 + "tracestate": { + "type": [ + "string", + "null" + ] } - } - }, - "FuzzyFileSearchSessionCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FuzzyFileSearchSessionCompletedNotification", - "type": "object", - "required": [ - "sessionId" - ], - "properties": { - "sessionId": { - "type": "string" - } - } - }, - "FuzzyFileSearchSessionUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FuzzyFileSearchSessionUpdatedNotification", - "type": "object", - "required": [ - "files", - "query", - "sessionId" - ], - "properties": { - "files": { - "type": "array", - "items": { - "$ref": "#/definitions/FuzzyFileSearchResult" - } - }, - "query": { - "type": "string" - }, - "sessionId": { - "type": "string" - } - } - }, - "ServerNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ServerNotification", - "description": "Notification sent from the server to the client.", - "oneOf": [ - { - "description": "NEW NOTIFICATIONS", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "error" - ], - "title": "ErrorNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ErrorNotification" - } - }, - "title": "ErrorNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/started" - ], - "title": "Thread/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadStartedNotification" - } - }, - "title": "Thread/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/status/changed" - ], - "title": "Thread/status/changedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadStatusChangedNotification" - } - }, - "title": "Thread/status/changedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/archived" - ], - "title": "Thread/archivedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadArchivedNotification" - } - }, - "title": "Thread/archivedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/unarchived" - ], - "title": "Thread/unarchivedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadUnarchivedNotification" - } - }, - "title": "Thread/unarchivedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/closed" - ], - "title": "Thread/closedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadClosedNotification" - } - }, - "title": "Thread/closedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/name/updated" - ], - "title": "Thread/name/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadNameUpdatedNotification" - } - }, - "title": "Thread/name/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/tokenUsage/updated" - ], - "title": "Thread/tokenUsage/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadTokenUsageUpdatedNotification" - } - }, - "title": "Thread/tokenUsage/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "turn/started" - ], - "title": "Turn/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/TurnStartedNotification" - } - }, - "title": "Turn/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "hook/started" - ], - "title": "Hook/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/HookStartedNotification" - } - }, - "title": "Hook/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "turn/completed" - ], - "title": "Turn/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/TurnCompletedNotification" - } - }, - "title": "Turn/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "hook/completed" - ], - "title": "Hook/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/HookCompletedNotification" - } - }, - "title": "Hook/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "turn/diff/updated" - ], - "title": "Turn/diff/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/TurnDiffUpdatedNotification" - } - }, - "title": "Turn/diff/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "turn/plan/updated" - ], - "title": "Turn/plan/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/TurnPlanUpdatedNotification" - } - }, - "title": "Turn/plan/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/started" - ], - "title": "Item/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ItemStartedNotification" - } - }, - "title": "Item/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/autoApprovalReview/started" - ], - "title": "Item/autoApprovalReview/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ItemGuardianApprovalReviewStartedNotification" - } - }, - "title": "Item/autoApprovalReview/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/autoApprovalReview/completed" - ], - "title": "Item/autoApprovalReview/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ItemGuardianApprovalReviewCompletedNotification" - } - }, - "title": "Item/autoApprovalReview/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/completed" - ], - "title": "Item/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ItemCompletedNotification" - } - }, - "title": "Item/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/agentMessage/delta" - ], - "title": "Item/agentMessage/deltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/AgentMessageDeltaNotification" - } - }, - "title": "Item/agentMessage/deltaNotification" - }, - { - "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items.", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/plan/delta" - ], - "title": "Item/plan/deltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/PlanDeltaNotification" - } - }, - "title": "Item/plan/deltaNotification" - }, - { - "description": "Stream base64-encoded stdout/stderr chunks for a running `command/exec` session.", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "command/exec/outputDelta" - ], - "title": "Command/exec/outputDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/CommandExecOutputDeltaNotification" - } - }, - "title": "Command/exec/outputDeltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/commandExecution/outputDelta" - ], - "title": "Item/commandExecution/outputDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/CommandExecutionOutputDeltaNotification" - } - }, - "title": "Item/commandExecution/outputDeltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/commandExecution/terminalInteraction" - ], - "title": "Item/commandExecution/terminalInteractionNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/TerminalInteractionNotification" - } - }, - "title": "Item/commandExecution/terminalInteractionNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/fileChange/outputDelta" - ], - "title": "Item/fileChange/outputDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/FileChangeOutputDeltaNotification" - } - }, - "title": "Item/fileChange/outputDeltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/fileChange/patchUpdated" - ], - "title": "Item/fileChange/patchUpdatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/FileChangePatchUpdatedNotification" - } - }, - "title": "Item/fileChange/patchUpdatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "serverRequest/resolved" - ], - "title": "ServerRequest/resolvedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ServerRequestResolvedNotification" - } - }, - "title": "ServerRequest/resolvedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/mcpToolCall/progress" - ], - "title": "Item/mcpToolCall/progressNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/McpToolCallProgressNotification" - } - }, - "title": "Item/mcpToolCall/progressNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "mcpServer/oauthLogin/completed" - ], - "title": "McpServer/oauthLogin/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/McpServerOauthLoginCompletedNotification" - } - }, - "title": "McpServer/oauthLogin/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "mcpServer/startupStatus/updated" - ], - "title": "McpServer/startupStatus/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/McpServerStatusUpdatedNotification" - } - }, - "title": "McpServer/startupStatus/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "account/updated" - ], - "title": "Account/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/AccountUpdatedNotification" - } - }, - "title": "Account/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "account/rateLimits/updated" - ], - "title": "Account/rateLimits/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/AccountRateLimitsUpdatedNotification" - } - }, - "title": "Account/rateLimits/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "fs/changed" - ], - "title": "Fs/changedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/FsChangedNotification" - } - }, - "title": "Fs/changedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/reasoning/summaryTextDelta" - ], - "title": "Item/reasoning/summaryTextDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ReasoningSummaryTextDeltaNotification" - } - }, - "title": "Item/reasoning/summaryTextDeltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/reasoning/summaryPartAdded" - ], - "title": "Item/reasoning/summaryPartAddedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ReasoningSummaryPartAddedNotification" - } - }, - "title": "Item/reasoning/summaryPartAddedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/reasoning/textDelta" - ], - "title": "Item/reasoning/textDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ReasoningTextDeltaNotification" - } - }, - "title": "Item/reasoning/textDeltaNotification" - }, - { - "description": "Deprecated: Use `ContextCompaction` item type instead.", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/compacted" - ], - "title": "Thread/compactedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ContextCompactedNotification" - } - }, - "title": "Thread/compactedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "model/rerouted" - ], - "title": "Model/reroutedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ModelReroutedNotification" - } - }, - "title": "Model/reroutedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "warning" - ], - "title": "WarningNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/WarningNotification" - } - }, - "title": "WarningNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "guardianWarning" - ], - "title": "GuardianWarningNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/GuardianWarningNotification" - } - }, - "title": "GuardianWarningNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "deprecationNotice" - ], - "title": "DeprecationNoticeNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/DeprecationNoticeNotification" - } - }, - "title": "DeprecationNoticeNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "configWarning" - ], - "title": "ConfigWarningNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ConfigWarningNotification" - } - }, - "title": "ConfigWarningNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/epiphany/stateUpdated" - ], - "title": "Thread/epiphany/stateUpdatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadEpiphanyStateUpdatedNotification" - } - }, - "title": "Thread/epiphany/stateUpdatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/epiphany/jobsUpdated" - ], - "title": "Thread/epiphany/jobsUpdatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadEpiphanyJobsUpdatedNotification" - } - }, - "title": "Thread/epiphany/jobsUpdatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "fuzzyFileSearch/sessionUpdated" - ], - "title": "FuzzyFileSearch/sessionUpdatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/FuzzyFileSearchSessionUpdatedNotification" - } - }, - "title": "FuzzyFileSearch/sessionUpdatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "fuzzyFileSearch/sessionCompleted" - ], - "title": "FuzzyFileSearch/sessionCompletedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/FuzzyFileSearchSessionCompletedNotification" - } - }, - "title": "FuzzyFileSearch/sessionCompletedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/started" - ], - "title": "Thread/realtime/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadRealtimeStartedNotification" - } - }, - "title": "Thread/realtime/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/itemAdded" - ], - "title": "Thread/realtime/itemAddedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadRealtimeItemAddedNotification" - } - }, - "title": "Thread/realtime/itemAddedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/transcript/delta" - ], - "title": "Thread/realtime/transcript/deltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadRealtimeTranscriptDeltaNotification" - } - }, - "title": "Thread/realtime/transcript/deltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/transcript/done" - ], - "title": "Thread/realtime/transcript/doneNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadRealtimeTranscriptDoneNotification" - } - }, - "title": "Thread/realtime/transcript/doneNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/outputAudio/delta" - ], - "title": "Thread/realtime/outputAudio/deltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadRealtimeOutputAudioDeltaNotification" - } - }, - "title": "Thread/realtime/outputAudio/deltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/sdp" - ], - "title": "Thread/realtime/sdpNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadRealtimeSdpNotification" - } - }, - "title": "Thread/realtime/sdpNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/error" - ], - "title": "Thread/realtime/errorNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadRealtimeErrorNotification" - } - }, - "title": "Thread/realtime/errorNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/closed" - ], - "title": "Thread/realtime/closedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/ThreadRealtimeClosedNotification" - } - }, - "title": "Thread/realtime/closedNotification" - }, - { - "description": "Notifies the user of world-writable directories on Windows, which cannot be protected by the sandbox.", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "windows/worldWritableWarning" - ], - "title": "Windows/worldWritableWarningNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/WindowsWorldWritableWarningNotification" - } - }, - "title": "Windows/worldWritableWarningNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "windowsSandbox/setupCompleted" - ], - "title": "WindowsSandbox/setupCompletedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/WindowsSandboxSetupCompletedNotification" - } - }, - "title": "WindowsSandbox/setupCompletedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "account/login/completed" - ], - "title": "Account/login/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/v2/AccountLoginCompletedNotification" - } - }, - "title": "Account/login/completedNotification" - } - ] + }, + "type": "object" }, "v2": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, - "ApprovalsReviewer": { - "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", - "type": "string", - "enum": [ - "user", - "auto_review", - "guardian_subagent" - ] - }, - "AskForApproval": { + "Account": { "oneOf": [ { - "type": "string", - "enum": [ - "untrusted", - "on-failure", - "on-request", - "never" - ] - }, - { - "type": "object", - "required": [ - "granular" - ], - "properties": { - "granular": { - "type": "object", - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "properties": { - "mcp_elicitations": { - "type": "boolean" - }, - "request_permissions": { - "default": false, - "type": "boolean" - }, - "rules": { - "type": "boolean" - }, - "sandbox_approval": { - "type": "boolean" - } - } - } - }, - "additionalProperties": false, - "title": "GranularAskForApproval" - } - ] - }, - "DynamicToolSpec": { - "type": "object", - "required": [ - "description", - "inputSchema", - "name" - ], - "properties": { - "deferLoading": { - "type": "boolean" - }, - "description": { - "type": "string" - }, - "inputSchema": true, - "name": { - "type": "string" - }, - "namespace": { - "type": [ - "string", - "null" - ] - } - } - }, - "FileSystemAccessMode": { - "type": "string", - "enum": [ - "read", - "write", - "none" - ] - }, - "FileSystemPath": { - "oneOf": [ - { - "type": "object", - "required": [ - "path", - "type" - ], - "properties": { - "path": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - "type": { - "type": "string", - "enum": [ - "path" - ], - "title": "PathFileSystemPathType" - } - }, - "title": "PathFileSystemPath" - }, - { - "type": "object", - "required": [ - "pattern", - "type" - ], - "properties": { - "pattern": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "glob_pattern" - ], - "title": "GlobPatternFileSystemPathType" - } - }, - "title": "GlobPatternFileSystemPath" - }, - { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", - "enum": [ - "special" - ], - "title": "SpecialFileSystemPathType" - }, - "value": { - "$ref": "#/definitions/v2/FileSystemSpecialPath" - } - }, - "title": "SpecialFileSystemPath" - } - ] - }, - "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], - "properties": { - "access": { - "$ref": "#/definitions/v2/FileSystemAccessMode" - }, - "path": { - "$ref": "#/definitions/v2/FileSystemPath" - } - } - }, - "FileSystemSpecialPath": { - "oneOf": [ - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "root" - ] - } - }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "minimal" - ] - } - }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "current_working_directory" - ] - } - }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "project_roots" - ] - }, - "subpath": { - "type": [ - "string", - "null" - ] - } - }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "tmpdir" - ] - } - }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind", - "path" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "unknown" - ] - }, - "path": { - "type": "string" - }, - "subpath": { - "type": [ - "string", - "null" - ] - } - } - } - ] - }, - "PermissionProfile": { - "type": "object", - "properties": { - "fileSystem": { - "anyOf": [ - { - "$ref": "#/definitions/v2/PermissionProfileFileSystemPermissions" - }, - { - "type": "null" - } - ] - }, - "network": { - "anyOf": [ - { - "$ref": "#/definitions/v2/PermissionProfileNetworkPermissions" - }, - { - "type": "null" - } - ] - } - } - }, - "PermissionProfileFileSystemPermissions": { - "type": "object", - "required": [ - "entries" - ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/FileSystemSandboxEntry" - } - }, - "globScanMaxDepth": { - "type": [ - "integer", - "null" - ], - "format": "uint", - "minimum": 1.0 - } - } - }, - "PermissionProfileNetworkPermissions": { - "type": "object", - "properties": { - "enabled": { - "type": [ - "boolean", - "null" - ] - } - } - }, - "Personality": { - "type": "string", - "enum": [ - "none", - "friendly", - "pragmatic" - ] - }, - "SandboxMode": { - "type": "string", - "enum": [ - "read-only", - "workspace-write", - "danger-full-access" - ] - }, - "ServiceTier": { - "type": "string", - "enum": [ - "fast", - "flex" - ] - }, - "ThreadStartSource": { - "type": "string", - "enum": [ - "startup", - "clear" - ] - }, - "ThreadStartParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadStartParams", - "type": "object", - "properties": { - "approvalPolicy": { - "anyOf": [ - { - "$ref": "#/definitions/v2/AskForApproval" - }, - { - "type": "null" - } - ] - }, - "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this thread and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/v2/ApprovalsReviewer" - }, - { - "type": "null" - } - ] - }, - "baseInstructions": { - "type": [ - "string", - "null" - ] - }, - "config": { - "type": [ - "object", - "null" - ], - "additionalProperties": true - }, - "cwd": { - "type": [ - "string", - "null" - ] - }, - "developerInstructions": { - "type": [ - "string", - "null" - ] - }, - "serviceTier": { - "anyOf": [ - { - "anyOf": [ - { - "$ref": "#/definitions/v2/ServiceTier" - }, - { - "type": "null" - } - ] - }, - { - "type": "null" - } - ] - }, - "ephemeral": { - "type": [ - "boolean", - "null" - ] - }, - "sandbox": { - "anyOf": [ - { - "$ref": "#/definitions/v2/SandboxMode" - }, - { - "type": "null" - } - ] - }, - "sessionStartSource": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadStartSource" - }, - { - "type": "null" - } - ] - }, - "model": { - "type": [ - "string", - "null" - ] - }, - "modelProvider": { - "type": [ - "string", - "null" - ] - }, - "permissionProfile": { - "description": "Full permissions override for this thread. Cannot be combined with `sandbox`.", - "anyOf": [ - { - "$ref": "#/definitions/v2/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "serviceName": { - "type": [ - "string", - "null" - ] - }, - "personality": { - "anyOf": [ - { - "$ref": "#/definitions/v2/Personality" - }, - { - "type": "null" - } - ] - } - } - }, - "ContentItem": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "input_text" - ], - "title": "InputTextContentItemType" - } - }, - "title": "InputTextContentItem" - }, - { - "type": "object", - "required": [ - "image_url", - "type" - ], - "properties": { - "detail": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ImageDetail" - }, - { - "type": "null" - } - ] - }, - "image_url": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "input_image" - ], - "title": "InputImageContentItemType" - } - }, - "title": "InputImageContentItem" - }, - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "output_text" - ], - "title": "OutputTextContentItemType" - } - }, - "title": "OutputTextContentItem" - } - ] - }, - "FunctionCallOutputBody": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "array", - "items": { - "$ref": "#/definitions/v2/FunctionCallOutputContentItem" - } - } - ] - }, - "FunctionCallOutputContentItem": { - "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.", - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "input_text" - ], - "title": "InputTextFunctionCallOutputContentItemType" - } - }, - "title": "InputTextFunctionCallOutputContentItem" - }, - { - "type": "object", - "required": [ - "image_url", - "type" - ], - "properties": { - "detail": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ImageDetail" - }, - { - "type": "null" - } - ] - }, - "image_url": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "input_image" - ], - "title": "InputImageFunctionCallOutputContentItemType" - } - }, - "title": "InputImageFunctionCallOutputContentItem" - } - ] - }, - "GhostCommit": { - "description": "Details of a ghost commit created from a repository state.", - "type": "object", - "required": [ - "id", - "preexisting_untracked_dirs", - "preexisting_untracked_files" - ], - "properties": { - "id": { - "type": "string" - }, - "parent": { - "type": [ - "string", - "null" - ] - }, - "preexisting_untracked_dirs": { - "type": "array", - "items": { - "type": "string" - } - }, - "preexisting_untracked_files": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ImageDetail": { - "type": "string", - "enum": [ - "auto", - "low", - "high", - "original" - ] - }, - "LocalShellAction": { - "oneOf": [ - { - "type": "object", - "required": [ - "command", - "type" - ], - "properties": { - "command": { - "type": "array", - "items": { - "type": "string" - } - }, - "env": { - "type": [ - "object", - "null" - ], - "additionalProperties": { - "type": "string" - } - }, - "timeout_ms": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "type": { - "type": "string", - "enum": [ - "exec" - ], - "title": "ExecLocalShellActionType" - }, - "user": { - "type": [ - "string", - "null" - ] - }, - "working_directory": { - "type": [ - "string", - "null" - ] - } - }, - "title": "ExecLocalShellAction" - } - ] - }, - "LocalShellStatus": { - "type": "string", - "enum": [ - "completed", - "in_progress", - "incomplete" - ] - }, - "MessagePhase": { - "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", - "oneOf": [ - { - "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", - "enum": [ - "commentary" - ] - }, - { - "description": "The assistant's terminal answer text for the current turn.", - "type": "string", - "enum": [ - "final_answer" - ] - } - ] - }, - "ReasoningItemContent": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "reasoning_text" - ], - "title": "ReasoningTextReasoningItemContentType" - } - }, - "title": "ReasoningTextReasoningItemContent" - }, - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "text" - ], - "title": "TextReasoningItemContentType" - } - }, - "title": "TextReasoningItemContent" - } - ] - }, - "ReasoningItemReasoningSummary": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "summary_text" - ], - "title": "SummaryTextReasoningItemReasoningSummaryType" - } - }, - "title": "SummaryTextReasoningItemReasoningSummary" - } - ] - }, - "ResponseItem": { - "oneOf": [ - { - "type": "object", - "required": [ - "content", - "role", - "type" - ], - "properties": { - "content": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ContentItem" - } - }, - "end_turn": { - "type": [ - "boolean", - "null" - ] - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "phase": { - "anyOf": [ - { - "$ref": "#/definitions/v2/MessagePhase" - }, - { - "type": "null" - } - ] - }, - "role": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "message" - ], - "title": "MessageResponseItemType" - } - }, - "title": "MessageResponseItem" - }, - { - "type": "object", - "required": [ - "summary", - "type" - ], - "properties": { - "content": { - "default": null, - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/v2/ReasoningItemContent" - } - }, - "encrypted_content": { - "type": [ - "string", - "null" - ] - }, - "summary": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ReasoningItemReasoningSummary" - } - }, - "type": { - "type": "string", - "enum": [ - "reasoning" - ], - "title": "ReasoningResponseItemType" - } - }, - "title": "ReasoningResponseItem" - }, - { - "type": "object", - "required": [ - "action", - "status", - "type" - ], - "properties": { - "action": { - "$ref": "#/definitions/v2/LocalShellAction" - }, - "call_id": { - "description": "Set when using the Responses API.", - "type": [ - "string", - "null" - ] - }, - "id": { - "description": "Legacy id field retained for compatibility with older payloads.", - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "status": { - "$ref": "#/definitions/v2/LocalShellStatus" - }, - "type": { - "type": "string", - "enum": [ - "local_shell_call" - ], - "title": "LocalShellCallResponseItemType" - } - }, - "title": "LocalShellCallResponseItem" - }, - { - "type": "object", - "required": [ - "arguments", - "call_id", - "name", - "type" - ], - "properties": { - "arguments": { - "type": "string" - }, - "call_id": { - "type": "string" - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "name": { - "type": "string" - }, - "namespace": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "function_call" - ], - "title": "FunctionCallResponseItemType" - } - }, - "title": "FunctionCallResponseItem" - }, - { - "type": "object", - "required": [ - "arguments", - "execution", - "type" - ], - "properties": { - "arguments": true, - "call_id": { - "type": [ - "string", - "null" - ] - }, - "execution": { - "type": "string" - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "status": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "tool_search_call" - ], - "title": "ToolSearchCallResponseItemType" - } - }, - "title": "ToolSearchCallResponseItem" - }, - { - "type": "object", - "required": [ - "call_id", - "output", - "type" - ], - "properties": { - "call_id": { - "type": "string" - }, - "output": { - "$ref": "#/definitions/v2/FunctionCallOutputBody" - }, - "type": { - "type": "string", - "enum": [ - "function_call_output" - ], - "title": "FunctionCallOutputResponseItemType" - } - }, - "title": "FunctionCallOutputResponseItem" - }, - { - "type": "object", - "required": [ - "call_id", - "input", - "name", - "type" - ], - "properties": { - "call_id": { - "type": "string" - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "input": { - "type": "string" - }, - "name": { - "type": "string" - }, - "status": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "custom_tool_call" - ], - "title": "CustomToolCallResponseItemType" - } - }, - "title": "CustomToolCallResponseItem" - }, - { - "type": "object", - "required": [ - "call_id", - "output", - "type" - ], - "properties": { - "call_id": { - "type": "string" - }, - "name": { - "type": [ - "string", - "null" - ] - }, - "output": { - "$ref": "#/definitions/v2/FunctionCallOutputBody" - }, - "type": { - "type": "string", - "enum": [ - "custom_tool_call_output" - ], - "title": "CustomToolCallOutputResponseItemType" - } - }, - "title": "CustomToolCallOutputResponseItem" - }, - { - "type": "object", - "required": [ - "execution", - "status", - "tools", - "type" - ], - "properties": { - "call_id": { - "type": [ - "string", - "null" - ] - }, - "execution": { - "type": "string" - }, - "status": { - "type": "string" - }, - "tools": { - "type": "array", - "items": true - }, - "type": { - "type": "string", - "enum": [ - "tool_search_output" - ], - "title": "ToolSearchOutputResponseItemType" - } - }, - "title": "ToolSearchOutputResponseItem" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "action": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ResponsesApiWebSearchAction" - }, - { - "type": "null" - } - ] - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "status": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "web_search_call" - ], - "title": "WebSearchCallResponseItemType" - } - }, - "title": "WebSearchCallResponseItem" - }, - { - "type": "object", - "required": [ - "id", - "result", - "status", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "result": { - "type": "string" - }, - "revised_prompt": { - "type": [ - "string", - "null" - ] - }, - "status": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "image_generation_call" - ], - "title": "ImageGenerationCallResponseItemType" - } - }, - "title": "ImageGenerationCallResponseItem" - }, - { - "type": "object", - "required": [ - "ghost_commit", - "type" - ], - "properties": { - "ghost_commit": { - "$ref": "#/definitions/v2/GhostCommit" - }, - "type": { - "type": "string", - "enum": [ - "ghost_snapshot" - ], - "title": "GhostSnapshotResponseItemType" - } - }, - "title": "GhostSnapshotResponseItem" - }, - { - "type": "object", - "required": [ - "encrypted_content", - "type" - ], - "properties": { - "encrypted_content": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "compaction" - ], - "title": "CompactionResponseItemType" - } - }, - "title": "CompactionResponseItem" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "other" - ], - "title": "OtherResponseItemType" - } - }, - "title": "OtherResponseItem" - } - ] - }, - "ResponsesApiWebSearchAction": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "queries": { - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "query": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "search" - ], - "title": "SearchResponsesApiWebSearchActionType" - } - }, - "title": "SearchResponsesApiWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "open_page" - ], - "title": "OpenPageResponsesApiWebSearchActionType" - }, - "url": { - "type": [ - "string", - "null" - ] - } - }, - "title": "OpenPageResponsesApiWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "pattern": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "find_in_page" - ], - "title": "FindInPageResponsesApiWebSearchActionType" - }, - "url": { - "type": [ - "string", - "null" - ] - } - }, - "title": "FindInPageResponsesApiWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "other" - ], - "title": "OtherResponsesApiWebSearchActionType" - } - }, - "title": "OtherResponsesApiWebSearchAction" - } - ] - }, - "ThreadResumeParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadResumeParams", - "description": "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "approvalPolicy": { - "anyOf": [ - { - "$ref": "#/definitions/v2/AskForApproval" - }, - { - "type": "null" - } - ] - }, - "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this thread and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/v2/ApprovalsReviewer" - }, - { - "type": "null" - } - ] - }, - "baseInstructions": { - "type": [ - "string", - "null" - ] - }, - "config": { - "type": [ - "object", - "null" - ], - "additionalProperties": true - }, - "cwd": { - "type": [ - "string", - "null" - ] - }, - "developerInstructions": { - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - }, - "model": { - "description": "Configuration overrides for the resumed thread, if any.", - "type": [ - "string", - "null" - ] - }, - "modelProvider": { - "type": [ - "string", - "null" - ] - }, - "sandbox": { - "anyOf": [ - { - "$ref": "#/definitions/v2/SandboxMode" - }, - { - "type": "null" - } - ] - }, - "permissionProfile": { - "description": "Full permissions override for the resumed thread. Cannot be combined with `sandbox`.", - "anyOf": [ - { - "$ref": "#/definitions/v2/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "serviceTier": { - "anyOf": [ - { - "anyOf": [ - { - "$ref": "#/definitions/v2/ServiceTier" - }, - { - "type": "null" - } - ] - }, - { - "type": "null" - } - ] - }, - "personality": { - "anyOf": [ - { - "$ref": "#/definitions/v2/Personality" - }, - { - "type": "null" - } - ] - } - } - }, - "ThreadForkParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadForkParams", - "description": "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "approvalPolicy": { - "anyOf": [ - { - "$ref": "#/definitions/v2/AskForApproval" - }, - { - "type": "null" - } - ] - }, - "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this thread and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/v2/ApprovalsReviewer" - }, - { - "type": "null" - } - ] - }, - "baseInstructions": { - "type": [ - "string", - "null" - ] - }, - "config": { - "type": [ - "object", - "null" - ], - "additionalProperties": true - }, - "cwd": { - "type": [ - "string", - "null" - ] - }, - "developerInstructions": { - "type": [ - "string", - "null" - ] - }, - "ephemeral": { - "type": "boolean" - }, - "model": { - "description": "Configuration overrides for the forked thread, if any.", - "type": [ - "string", - "null" - ] - }, - "modelProvider": { - "type": [ - "string", - "null" - ] - }, - "serviceTier": { - "anyOf": [ - { - "anyOf": [ - { - "$ref": "#/definitions/v2/ServiceTier" - }, - { - "type": "null" - } - ] - }, - { - "type": "null" - } - ] - }, - "permissionProfile": { - "description": "Full permissions override for the forked thread. Cannot be combined with `sandbox`.", - "anyOf": [ - { - "$ref": "#/definitions/v2/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - }, - "sandbox": { - "anyOf": [ - { - "$ref": "#/definitions/v2/SandboxMode" - }, - { - "type": "null" - } - ] - } - } - }, - "ThreadArchiveParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadArchiveParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadUnsubscribeParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnsubscribeParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "AccountLoginCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "AccountLoginCompletedNotification", - "type": "object", - "required": [ - "success" - ], - "properties": { - "error": { - "type": [ - "string", - "null" - ] - }, - "loginId": { - "type": [ - "string", - "null" - ] - }, - "success": { - "type": "boolean" - } - } - }, - "WindowsSandboxSetupCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WindowsSandboxSetupCompletedNotification", - "type": "object", - "required": [ - "mode", - "success" - ], - "properties": { - "error": { - "type": [ - "string", - "null" - ] - }, - "mode": { - "$ref": "#/definitions/v2/WindowsSandboxSetupMode" - }, - "success": { - "type": "boolean" - } - } - }, - "ThreadSetNameParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadSetNameParams", - "type": "object", - "required": [ - "name", - "threadId" - ], - "properties": { - "name": { - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadMetadataGitInfoUpdateParams": { - "type": "object", - "properties": { - "branch": { - "description": "Omit to leave the stored branch unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", - "type": [ - "string", - "null" - ] - }, - "originUrl": { - "description": "Omit to leave the stored origin URL unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", - "type": [ - "string", - "null" - ] - }, - "sha": { - "description": "Omit to leave the stored commit unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadMetadataUpdateParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadMetadataUpdateParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "gitInfo": { - "description": "Patch the stored Git metadata for this thread. Omit a field to leave it unchanged, set it to `null` to clear it, or provide a string to replace the stored value.", - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadMetadataGitInfoUpdateParams" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadMemoryMode": { - "type": "string", - "enum": [ - "enabled", - "disabled" - ] - }, - "WindowsWorldWritableWarningNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WindowsWorldWritableWarningNotification", - "type": "object", - "required": [ - "extraCount", - "failedScan", - "samplePaths" - ], - "properties": { - "extraCount": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "failedScan": { - "type": "boolean" - }, - "samplePaths": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ThreadUnarchiveParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnarchiveParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadCompactStartParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadCompactStartParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadShellCommandParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadShellCommandParams", - "type": "object", - "required": [ - "command", - "threadId" - ], - "properties": { - "command": { - "description": "Shell command string evaluated by the thread's configured shell. Unlike `command/exec`, this intentionally preserves shell syntax such as pipes, redirects, and quoting. This runs unsandboxed with full access rather than inheriting the thread sandbox policy.", - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadApproveGuardianDeniedActionParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadApproveGuardianDeniedActionParams", - "type": "object", - "required": [ - "event", - "threadId" - ], - "properties": { - "event": { - "description": "Serialized `codex_protocol::protocol::GuardianAssessmentEvent`." - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRealtimeClosedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeClosedNotification", - "description": "EXPERIMENTAL - emitted when thread realtime transport closes.", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "reason": { - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRollbackParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRollbackParams", - "type": "object", - "required": [ - "numTurns", - "threadId" - ], - "properties": { - "numTurns": { - "description": "The number of turns to drop from the end of the thread. Must be >= 1.\n\nThis only modifies the thread's history and does not revert local file changes that have been made by the agent. Clients are responsible for reverting these changes.", - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "threadId": { - "type": "string" - } - } - }, - "SortDirection": { - "type": "string", - "enum": [ - "asc", - "desc" - ] - }, - "ThreadListCwdFilter": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string" - } - } - ] - }, - "ThreadSortKey": { - "type": "string", - "enum": [ - "created_at", - "updated_at" - ] - }, - "ThreadSourceKind": { - "type": "string", - "enum": [ - "cli", - "vscode", - "exec", - "appServer", - "subAgent", - "subAgentReview", - "subAgentCompact", - "subAgentThreadSpawn", - "subAgentOther", - "unknown" - ] - }, - "ThreadListParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadListParams", - "type": "object", - "properties": { - "archived": { - "description": "Optional archived filter; when set to true, only archived threads are returned. If false or null, only non-archived threads are returned.", - "type": [ - "boolean", - "null" - ] - }, - "cursor": { - "description": "Opaque pagination cursor returned by a previous call.", - "type": [ - "string", - "null" - ] - }, - "cwd": { - "description": "Optional cwd filter or filters; when set, only threads whose session cwd exactly matches one of these paths are returned.", - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadListCwdFilter" - }, - { - "type": "null" - } - ] - }, - "limit": { - "description": "Optional page size; defaults to a reasonable server-side value.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "modelProviders": { - "description": "Optional provider filter; when set, only sessions recorded under these providers are returned. When present but empty, includes all providers.", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "searchTerm": { - "description": "Optional substring filter for the extracted thread title.", - "type": [ - "string", - "null" - ] - }, - "sortDirection": { - "description": "Optional sort direction; defaults to descending (newest first).", - "anyOf": [ - { - "$ref": "#/definitions/v2/SortDirection" - }, - { - "type": "null" - } - ] - }, - "sortKey": { - "description": "Optional sort key; defaults to created_at.", - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadSortKey" - }, - { - "type": "null" - } - ] - }, - "sourceKinds": { - "description": "Optional source filter; when set, only sessions from these source kinds are returned. When omitted or empty, defaults to interactive sources.", - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/v2/ThreadSourceKind" - } - }, - "useStateDbOnly": { - "description": "If true, return from the state DB without scanning JSONL rollouts to repair thread metadata. Omitted or false preserves scan-and-repair behavior.", - "type": "boolean" - } - } - }, - "ThreadLoadedListParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadLoadedListParams", - "type": "object", - "properties": { - "cursor": { - "description": "Opaque pagination cursor returned by a previous call.", - "type": [ - "string", - "null" - ] - }, - "limit": { - "description": "Optional page size; defaults to no limit.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ThreadReadParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadReadParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "includeTurns": { - "description": "When true, include turns and their items from rollout history.", - "default": false, - "type": "boolean" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyViewLens": { - "type": "string", - "enum": [ - "scene", - "jobs", - "roles", - "planning", - "pressure", - "reorient", - "crrc", - "coordinator" - ] - }, - "ThreadRealtimeErrorNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeErrorNotification", - "description": "EXPERIMENTAL - emitted when thread realtime encounters an error.", - "type": "object", - "required": [ - "message", - "threadId" - ], - "properties": { - "message": { - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyRoleId": { - "type": "string", - "enum": [ - "implementation", - "imagination", - "research", - "modeling", - "verification", - "reorientation" - ] - }, - "ThreadRealtimeSdpNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeSdpNotification", - "description": "EXPERIMENTAL - emitted with the remote SDP for a WebRTC realtime session.", - "type": "object", - "required": [ - "sdp", - "threadId" - ], - "properties": { - "sdp": { - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRealtimeOutputAudioDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeOutputAudioDeltaNotification", - "description": "EXPERIMENTAL - streamed output audio emitted by thread realtime.", - "type": "object", - "required": [ - "audio", - "threadId" - ], - "properties": { - "audio": { - "$ref": "#/definitions/v2/ThreadRealtimeAudioChunk" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRealtimeTranscriptDoneNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeTranscriptDoneNotification", - "description": "EXPERIMENTAL - final transcript text emitted when realtime completes a transcript part.", - "type": "object", - "required": [ - "role", - "text", - "threadId" - ], - "properties": { - "role": { - "type": "string" - }, - "text": { - "description": "Final complete text for the transcript part.", - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRealtimeTranscriptDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeTranscriptDeltaNotification", - "description": "EXPERIMENTAL - flat transcript delta emitted whenever realtime transcript text changes.", - "type": "object", - "required": [ - "delta", - "role", - "threadId" - ], - "properties": { - "delta": { - "description": "Live transcript delta from the realtime event.", - "type": "string" - }, - "role": { - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRealtimeItemAddedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeItemAddedNotification", - "description": "EXPERIMENTAL - raw non-audio thread realtime item emitted by the backend.", - "type": "object", - "required": [ - "item", - "threadId" - ], - "properties": { - "item": true, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyGraphQuery": { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "depth": { - "description": "Defaults to 1 and is capped by the server.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "direction": { - "description": "Defaults to `both`.", - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanyGraphQueryDirection" - }, - { - "type": "null" - } - ] - }, - "edgeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "edgeKinds": { - "type": "array", - "items": { - "type": "string" - } - }, - "includeLinks": { - "description": "Defaults to true so neighborhood queries preserve dataflow/architecture joins.", - "type": [ - "boolean", - "null" - ] - }, - "kind": { - "$ref": "#/definitions/v2/ThreadEpiphanyGraphQueryKind" - }, - "nodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "paths": { - "type": "array", - "items": { - "type": "string" - } - }, - "symbols": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ThreadEpiphanyGraphQueryDirection": { - "type": "string", - "enum": [ - "incoming", - "outgoing", - "both" - ] - }, - "ThreadEpiphanyGraphQueryKind": { - "type": "string", - "enum": [ - "node", - "path", - "frontierNeighborhood", - "neighbors" - ] - }, - "ThreadRealtimeStartedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeStartedNotification", - "description": "EXPERIMENTAL - emitted when thread realtime startup is accepted.", - "type": "object", - "required": [ - "threadId", - "version" - ], - "properties": { - "sessionId": { - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - }, - "version": { - "$ref": "#/definitions/v2/RealtimeConversationVersion" - } - } - }, - "RealtimeConversationVersion": { - "type": "string", - "enum": [ - "v1", - "v2" - ] - }, - "ThreadEpiphanyJobsUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadEpiphanyJobsUpdatedNotification", - "type": "object", - "required": [ - "source", - "threadId" - ], - "properties": { - "jobs": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanyJob" - } - }, - "source": { - "$ref": "#/definitions/v2/ThreadEpiphanyJobsUpdatedSource" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyJobsUpdatedSource": { - "type": "string", - "enum": [ - "runtimeProgress" - ] - }, - "ThreadEpiphanyStateUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadEpiphanyStateUpdatedNotification", - "type": "object", - "required": [ - "changedFields", - "epiphanyState", - "revision", - "source", - "threadId" - ], - "properties": { - "changedFields": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanyStateUpdatedField" - } - }, - "epiphanyState": { - "$ref": "#/definitions/v2/EpiphanyThreadState" - }, - "revision": { - "type": "integer", - "format": "uint64", - "minimum": 0.0 - }, - "source": { - "$ref": "#/definitions/v2/ThreadEpiphanyStateUpdatedSource" - }, - "threadId": { - "type": "string" - } - } - }, - "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], - "properties": { - "end_line": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "note": { - "type": [ - "string", - "null" - ] - }, - "path": { - "type": "string" - }, - "start_line": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "symbol": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanyStateUpdatedSource": { - "type": "string", - "enum": [ - "update", - "promote", - "jobLaunch", - "jobInterrupt", - "reorientAccept", - "roleAccept" - ] - }, - "ConfigWarningNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigWarningNotification", - "type": "object", - "required": [ - "summary" - ], - "properties": { - "details": { - "description": "Optional extra guidance or error details.", - "type": [ - "string", - "null" - ] - }, - "path": { - "description": "Optional path to the config file that triggered the warning.", - "type": [ - "string", - "null" - ] - }, - "range": { - "description": "Optional range for the error location inside the config file.", - "anyOf": [ - { - "$ref": "#/definitions/v2/TextRange" - }, - { - "type": "null" - } - ] - }, - "summary": { - "description": "Concise summary of the warning.", - "type": "string" - } - } - }, - "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], - "properties": { - "accepted_at": { - "type": "string" - }, - "accepted_evidence_id": { - "type": [ - "string", - "null" - ] - }, - "accepted_observation_id": { - "type": [ - "string", - "null" - ] - }, - "binding_id": { - "type": "string" - }, - "id": { - "type": "string" - }, - "job_id": { - "type": "string" - }, - "result_id": { - "type": "string" - }, - "role_id": { - "type": "string" - }, - "status": { - "type": "string" - }, - "summary": { - "type": [ - "string", - "null" - ] - }, - "surface": { - "type": "string" - } - } - }, - "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], - "properties": { - "acceptance_sketch": { - "type": "array", - "items": { - "type": "string" - } - }, - "blockers": { - "type": "array", - "items": { - "type": "string" - } - }, - "confidence": { - "type": "string" - }, - "dependencies": { - "type": "array", - "items": { - "type": "string" - } - }, - "duplicate_of": { - "type": [ - "string", - "null" - ] - }, - "evidence_refs": { - "type": "array", - "items": { - "type": "string" - } - }, - "horizon": { - "type": "string" - }, - "id": { - "type": "string" - }, - "kind": { - "type": "string" - }, - "lane_hints": { - "type": "array", - "items": { - "type": "string" - } - }, - "priority": { - "$ref": "#/definitions/v2/EpiphanyPlanningPriority" - }, - "product_area": { - "type": "string" - }, - "source_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyPlanningSourceRef" - } - }, - "status": { - "type": "string" - }, - "summary": { - "type": "string" - }, - "title": { - "type": "string" - }, - "updated_at": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], - "properties": { - "diff_pressure": { - "type": "string" - }, - "graph_freshness": { - "type": [ - "string", - "null" - ] - }, - "understanding_status": { - "type": "string" - }, - "unexplained_writes": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "warning": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], - "properties": { - "code_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyCodeRef" - } - }, - "id": { - "type": "string" - }, - "kind": { - "type": "string" - }, - "status": { - "type": "string" - }, - "summary": { - "type": "string" - } - } - }, - "EpiphanyGraph": { - "type": "object", - "properties": { - "edges": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyGraphEdge" - } - }, - "nodes": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyGraphNode" - } - } - } - }, - "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], - "properties": { - "checkpoint_id": { - "type": "string" - }, - "frontier_node_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "graph_revision": { - "type": "integer", - "format": "uint64", - "minimum": 0.0 - }, - "open_gap_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "open_question_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], - "properties": { - "code_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyCodeRef" - } - }, - "id": { - "type": [ - "string", - "null" - ] - }, - "kind": { - "type": "string" - }, - "label": { - "type": [ - "string", - "null" - ] - }, - "mechanism": { - "type": [ - "string", - "null" - ] - }, - "source_id": { - "type": "string" - }, - "target_id": { - "type": "string" - } - } - }, - "EpiphanyGraphFrontier": { - "type": "object", - "properties": { - "active_edge_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "active_node_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "dirty_paths": { - "type": "array", - "items": { - "type": "string" - } - }, - "open_gap_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "open_question_ids": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], - "properties": { - "architecture_node_id": { - "type": "string" - }, - "code_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyCodeRef" - } - }, - "dataflow_node_id": { - "type": "string" - }, - "relationship": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], - "properties": { - "code_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyCodeRef" - } - }, - "id": { - "type": "string" - }, - "mechanism": { - "type": [ - "string", - "null" - ] - }, - "metaphor": { - "type": [ - "string", - "null" - ] - }, - "purpose": { - "type": "string" - }, - "status": { - "type": [ - "string", - "null" - ] - }, - "title": { - "type": "string" - } - } - }, - "EpiphanyGraphs": { - "type": "object", - "properties": { - "architecture": { - "$ref": "#/definitions/v2/EpiphanyGraph" - }, - "dataflow": { - "$ref": "#/definitions/v2/EpiphanyGraph" - }, - "links": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyGraphLink" - } - } - } - }, - "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], - "properties": { - "description": { - "type": "string" - }, - "id": { - "type": "string" - }, - "rationale": { - "type": [ - "string", - "null" - ] - }, - "status": { - "type": "string" - } - } - }, - "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], - "properties": { - "captured_at_turn_id": { - "type": [ - "string", - "null" - ] - }, - "checkpoint_id": { - "type": "string" - }, - "code_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyCodeRef" - } - }, - "disposition": { - "$ref": "#/definitions/v2/EpiphanyInvestigationDisposition" - }, - "evidence_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "focus": { - "type": "string" - }, - "kind": { - "type": "string" - }, - "next_action": { - "type": [ - "string", - "null" - ] - }, - "open_questions": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyInvestigationDisposition": { - "type": "string", - "enum": [ - "resume_ready", - "regather_required" - ] - }, - "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], - "properties": { - "authority_scope": { - "type": [ - "string", - "null" - ] - }, - "blocking_reason": { - "type": [ - "string", - "null" - ] - }, - "id": { - "type": "string" - }, - "kind": { - "$ref": "#/definitions/v2/EpiphanyJobKind" - }, - "linked_graph_node_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "linked_subgoal_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "owner_role": { - "type": "string" - }, - "scope": { - "type": "string" - } - } - }, - "EpiphanyJobKind": { - "type": "string", - "enum": [ - "indexing", - "remap", - "verification", - "specialist" - ] - }, - "EpiphanyModeKind": { - "type": "string", - "enum": [ - "plan", - "default" - ] - }, - "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], - "properties": { - "kind": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyModeKind" - }, - { - "type": "null" - } - ] - }, - "name": { - "type": "string" - } - } - }, - "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "properties": { - "acceptance_criteria": { - "type": "array", - "items": { - "type": "string" - } - }, - "dependencies": { - "type": "array", - "items": { - "type": "string" - } - }, - "evidence_required": { - "type": "array", - "items": { - "type": "string" - } - }, - "id": { - "type": "string" - }, - "lane_plan": { - "$ref": "#/definitions/v2/EpiphanyObjectiveDraftLanePlan" - }, - "review_gates": { - "type": "array", - "items": { - "type": "string" - } - }, - "risks": { - "type": "array", - "items": { - "type": "string" - } - }, - "scope": { - "$ref": "#/definitions/v2/EpiphanyObjectiveDraftScope" - }, - "source_item_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "status": { - "type": "string" - }, - "summary": { - "type": "string" - }, - "title": { - "type": "string" - } - } - }, - "EpiphanyObjectiveDraftLanePlan": { - "type": "object", - "properties": { - "body": { - "type": [ - "string", - "null" - ] - }, - "eyes": { - "type": [ - "string", - "null" - ] - }, - "hands": { - "type": [ - "string", - "null" - ] - }, - "imagination": { - "type": [ - "string", - "null" - ] - }, - "life": { - "type": [ - "string", - "null" - ] - }, - "soul": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyObjectiveDraftScope": { - "type": "object", - "properties": { - "excludes": { - "type": "array", - "items": { - "type": "string" - } - }, - "includes": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "properties": { - "code_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyCodeRef" - } - }, - "evidence_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "id": { - "type": "string" - }, - "source_kind": { - "type": "string" - }, - "status": { - "type": "string" - }, - "summary": { - "type": "string" - } - } - }, - "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], - "properties": { - "body": { - "type": [ - "string", - "null" - ] - }, - "confidence": { - "type": "string" - }, - "created_at": { - "type": [ - "string", - "null" - ] - }, - "id": { - "type": "string" - }, - "source": { - "$ref": "#/definitions/v2/EpiphanyPlanningSourceRef" - }, - "speaker": { - "type": [ - "string", - "null" - ] - }, - "status": { - "type": "string" - }, - "tags": { - "type": "array", - "items": { - "type": "string" - } - }, - "title": { - "type": "string" - }, - "updated_at": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], - "properties": { - "blocks": { - "type": "array", - "items": { - "type": "string" - } - }, - "confidence": { - "type": [ - "string", - "null" - ] - }, - "effort": { - "type": [ - "string", - "null" - ] - }, - "impact": { - "type": [ - "string", - "null" - ] - }, - "rationale": { - "type": "string" - }, - "reason": { - "type": [ - "string", - "null" - ] - }, - "unblocks": { - "type": "array", - "items": { - "type": "string" - } - }, - "urgency": { - "type": [ - "string", - "null" - ] - }, - "value": { - "type": "string" - } - } - }, - "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "assignees": { - "type": "array", - "items": { - "type": "string" - } - }, - "author": { - "type": [ - "string", - "null" - ] - }, - "closed_at": { - "type": [ - "string", - "null" - ] - }, - "created_at": { - "type": [ - "string", - "null" - ] - }, - "database_id": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "external_id": { - "type": [ - "string", - "null" - ] - }, - "imported_at": { - "type": [ - "string", - "null" - ] - }, - "is_pull_request": { - "type": [ - "boolean", - "null" - ] - }, - "issue_number": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "kind": { - "type": "string" - }, - "labels": { - "type": "array", - "items": { - "type": "string" - } - }, - "milestone": { - "type": [ - "string", - "null" - ] - }, - "node_id": { - "type": [ - "string", - "null" - ] - }, - "provider": { - "type": [ - "string", - "null" - ] - }, - "repo": { - "type": [ - "string", - "null" - ] - }, - "state": { - "type": [ - "string", - "null" - ] - }, - "updated_at": { - "type": [ - "string", - "null" - ] - }, - "uri": { - "type": [ - "string", - "null" - ] - }, - "url": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyPlanningState": { - "type": "object", - "properties": { - "backlog_items": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyBacklogItem" - } - }, - "captures": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyPlanningCapture" - } - }, - "objective_drafts": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyObjectiveDraft" - } - }, - "roadmap_streams": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyRoadmapStream" - } - }, - "workspace_root": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], - "properties": { - "blocked_by": { - "type": "array", - "items": { - "type": "string" - } - }, - "id": { - "type": "string" - }, - "item_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "near_term_focus": { - "type": [ - "string", - "null" - ] - }, - "purpose": { - "type": "string" - }, - "review_cadence": { - "type": [ - "string", - "null" - ] - }, - "status": { - "type": "string" - }, - "title": { - "type": "string" - } - } - }, - "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "properties": { - "authority_scope": { - "type": "string" - }, - "binding_id": { - "type": "string" - }, - "id": { - "type": "string" - }, - "linked_graph_node_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "linked_subgoal_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "role_id": { - "type": "string" - }, - "runtime_job_id": { - "type": "string" - }, - "runtime_result_id": { - "type": [ - "string", - "null" - ] - }, - "surface": { - "type": "string" - } - } - }, - "EpiphanyScratchPad": { - "type": "object", - "properties": { - "hypothesis": { - "type": [ - "string", - "null" - ] - }, - "next_probe": { - "type": [ - "string", - "null" - ] - }, - "notes": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], - "properties": { - "id": { - "type": "string" - }, - "status": { - "type": "string" - }, - "summary": { - "type": [ - "string", - "null" - ] - }, - "title": { - "type": "string" - } - } - }, - "ThreadEpiphanyUpdatePatch": { - "type": "object", - "properties": { - "acceptanceReceipts": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyAcceptanceReceipt" - } - }, - "activeSubgoalId": { - "type": [ - "string", - "null" - ] - }, - "churn": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyChurnState" - }, - { - "type": "null" - } - ] - }, - "evidence": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyEvidenceRecord" - } - }, - "graphCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyGraphCheckpoint" - }, - { - "type": "null" - } - ] - }, - "graphFrontier": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyGraphFrontier" - }, - { - "type": "null" - } - ] - }, - "graphs": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyGraphs" - }, - { - "type": "null" - } - ] - }, - "invariants": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/v2/EpiphanyInvariant" - } - }, - "investigationCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "jobBindings": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/v2/EpiphanyJobBinding" - } - }, - "mode": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyModeState" - }, - { - "type": "null" - } - ] - }, - "objective": { - "type": [ - "string", - "null" - ] - }, - "observations": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyObservation" - } - }, - "planning": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyPlanningState" - }, - { - "type": "null" - } - ] - }, - "runtimeLinks": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyRuntimeLink" - } - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "subgoals": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/v2/EpiphanySubgoal" - } - } - } - }, - "TextRange": { - "type": "object", - "required": [ - "end", - "start" - ], - "properties": { - "end": { - "$ref": "#/definitions/v2/TextPosition" - }, - "start": { - "$ref": "#/definitions/v2/TextPosition" - } - } - }, - "ThreadEpiphanyWorkerLaunchDocument": { - "oneOf": [ - { - "type": "object", - "required": [ - "documentKind", - "roleId", - "stateRevision", - "threadId" - ], - "properties": { - "activeGraphNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "activeSubgoalId": { - "type": [ - "string", - "null" - ] - }, - "activeSubgoals": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanySubgoal" - } - }, - "churn": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyChurnState" - }, - { - "type": "null" - } - ] - }, - "documentKind": { - "type": "string", - "enum": [ - "role" - ] - }, - "graphCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyGraphCheckpoint" - }, - { - "type": "null" - } - ] - }, - "graphFrontier": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyGraphFrontier" - }, - { - "type": "null" - } - ] - }, - "graphs": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyGraphs" - }, - { - "type": "null" - } - ] - }, - "invariants": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyInvariant" - } - }, - "investigationCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "objective": { - "type": [ - "string", - "null" - ] - }, - "planning": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyPlanningState" - }, - { - "type": "null" - } - ] - }, - "recentEvidence": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyEvidenceRecord" - } - }, - "recentObservations": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyObservation" - } - }, - "roleId": { - "type": "string" - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "stateRevision": { - "type": "integer", - "format": "uint64", - "minimum": 0.0 - }, - "threadId": { - "type": "string" - } - } - }, - { - "type": "object", - "required": [ - "checkpointDisposition", - "checkpointId", - "checkpointKind", - "checkpointNextAction", - "decisionNote", - "documentKind", - "graphStatus", - "mode", - "pressureLevel", - "retrievalStatus", - "threadId", - "watcherStatus" - ], - "properties": { - "activeFrontierNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointChangedPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointCodeRefs": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyCodeRef" - } - }, - "checkpointDirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointDisposition": { - "type": "string" - }, - "checkpointEvidenceIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointFocus": { - "type": [ - "string", - "null" - ] - }, - "checkpointId": { - "type": "string" - }, - "checkpointKind": { - "type": "string" - }, - "checkpointNextAction": { - "type": "string" - }, - "checkpointOpenQuestions": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointSummary": { - "type": [ - "string", - "null" - ] - }, - "decisionNote": { - "type": "string" - }, - "decisionReasons": { - "type": "array", - "items": { - "type": "string" - } - }, - "documentKind": { - "type": "string", - "enum": [ - "reorient" - ] - }, - "graphStatus": { - "type": "string" - }, - "graphs": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyGraphs" - }, - { - "type": "null" - } - ] - }, - "linkedGraphNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "linkedSubgoalIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "mode": { - "type": "string" - }, - "pressureLevel": { - "type": "string" - }, - "recentEvidence": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyEvidenceRecord" - } - }, - "recentObservations": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyObservation" - } - }, - "retrievalStatus": { - "type": "string" - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - }, - "watcherStatus": { - "type": "string" - } - } - } - ] - }, - "TextPosition": { - "type": "object", - "required": [ - "column", - "line" - ], - "properties": { - "column": { - "description": "1-based column number (in Unicode scalar values).", - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "line": { - "description": "1-based line number.", - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } - }, - "DeprecationNoticeNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeprecationNoticeNotification", - "type": "object", - "required": [ - "summary" - ], - "properties": { - "details": { - "description": "Optional extra guidance, such as migration steps or rationale.", - "type": [ - "string", - "null" - ] - }, - "summary": { - "description": "Concise summary of what is deprecated.", - "type": "string" - } - } - }, - "GuardianWarningNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "GuardianWarningNotification", - "type": "object", - "required": [ - "message", - "threadId" - ], - "properties": { - "message": { - "description": "Concise guardian warning message for the user.", - "type": "string" - }, - "threadId": { - "description": "Thread target for the guardian warning.", - "type": "string" - } - } - }, - "WarningNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WarningNotification", - "type": "object", - "required": [ - "message" - ], - "properties": { - "message": { - "description": "Concise warning message for the user.", - "type": "string" - }, - "threadId": { - "description": "Optional thread target when the warning applies to a specific thread.", - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadTurnsListParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadTurnsListParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "cursor": { - "description": "Opaque cursor to pass to the next call to continue after the last turn.", - "type": [ - "string", - "null" - ] - }, - "limit": { - "description": "Optional turn page size.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "sortDirection": { - "description": "Optional turn pagination direction; defaults to descending.", - "anyOf": [ - { - "$ref": "#/definitions/v2/SortDirection" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadInjectItemsParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadInjectItemsParams", - "type": "object", - "required": [ - "items", - "threadId" - ], - "properties": { - "items": { - "description": "Raw Responses API items to append to the thread's model-visible history.", - "type": "array", - "items": true - }, - "threadId": { - "type": "string" - } - } - }, - "DeviceKeyProtectionPolicy": { - "description": "Protection policy for creating or loading a controller-local device key.", - "type": "string", - "enum": [ - "hardware_only", - "allow_os_protected_nonextractable" - ] - }, - "DeviceKeyCreateParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeyCreateParams", - "description": "Create a controller-local device key with a random key id.", - "type": "object", - "required": [ - "accountUserId", - "clientId" - ], - "properties": { - "accountUserId": { - "type": "string" - }, - "clientId": { - "type": "string" - }, - "protectionPolicy": { - "description": "Defaults to `hardware_only` when omitted.", - "anyOf": [ - { - "$ref": "#/definitions/v2/DeviceKeyProtectionPolicy" - }, - { - "type": "null" - } - ] - } - } - }, - "DeviceKeyPublicParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeyPublicParams", - "description": "Fetch a controller-local device key public key by id.", - "type": "object", - "required": [ - "keyId" - ], - "properties": { - "keyId": { - "type": "string" - } - } - }, - "DeviceKeySignPayload": { - "description": "Structured payloads accepted by `device/key/sign`.", - "oneOf": [ - { - "description": "Payload bound to one remote-control controller websocket `/client` connection challenge.", - "type": "object", - "required": [ - "accountUserId", - "audience", - "clientId", - "nonce", - "scopes", - "sessionId", - "targetOrigin", - "targetPath", - "tokenExpiresAt", - "tokenSha256Base64url", - "type" - ], - "properties": { - "accountUserId": { - "type": "string" - }, - "audience": { - "$ref": "#/definitions/v2/RemoteControlClientConnectionAudience" - }, - "clientId": { - "type": "string" - }, - "nonce": { - "type": "string" - }, - "scopes": { - "description": "Must contain exactly `remote_control_controller_websocket`.", - "type": "array", - "items": { - "type": "string" - } - }, - "sessionId": { - "description": "Backend-issued websocket session id that this proof authorizes.", - "type": "string" - }, - "targetOrigin": { - "description": "Origin of the backend endpoint that issued the challenge and will verify this proof.", - "type": "string" - }, - "targetPath": { - "description": "Websocket route path that this proof authorizes.", - "type": "string" - }, - "tokenExpiresAt": { - "description": "Remote-control token expiration as Unix seconds.", - "type": "integer", - "format": "int64" - }, - "tokenSha256Base64url": { - "description": "SHA-256 of the controller-scoped remote-control token, encoded as unpadded base64url.", - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "remoteControlClientConnection" - ], - "title": "RemoteControlClientConnectionDeviceKeySignPayloadType" - } - }, - "title": "RemoteControlClientConnectionDeviceKeySignPayload" - }, - { - "description": "Payload bound to a remote-control client `/client/enroll` ownership challenge.", - "type": "object", - "required": [ - "accountUserId", - "audience", - "challengeExpiresAt", - "challengeId", - "clientId", - "deviceIdentitySha256Base64url", - "nonce", - "targetOrigin", - "targetPath", - "type" - ], - "properties": { - "accountUserId": { - "type": "string" - }, - "audience": { - "$ref": "#/definitions/v2/RemoteControlClientEnrollmentAudience" - }, - "challengeExpiresAt": { - "description": "Enrollment challenge expiration as Unix seconds.", - "type": "integer", - "format": "int64" - }, - "challengeId": { - "description": "Backend-issued enrollment challenge id that this proof authorizes.", - "type": "string" - }, - "clientId": { - "type": "string" - }, - "deviceIdentitySha256Base64url": { - "description": "SHA-256 of the requested device identity operation, encoded as unpadded base64url.", - "type": "string" - }, - "nonce": { - "type": "string" - }, - "targetOrigin": { - "description": "Origin of the backend endpoint that issued the challenge and will verify this proof.", - "type": "string" - }, - "targetPath": { - "description": "HTTP route path that this proof authorizes.", - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "remoteControlClientEnrollment" - ], - "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType" - } - }, - "title": "RemoteControlClientEnrollmentDeviceKeySignPayload" - } - ] - }, - "RemoteControlClientConnectionAudience": { - "description": "Audience for a remote-control client connection device-key proof.", - "type": "string", - "enum": [ - "remote_control_client_websocket" - ] - }, - "RemoteControlClientEnrollmentAudience": { - "description": "Audience for a remote-control client enrollment device-key proof.", - "type": "string", - "enum": [ - "remote_control_client_enrollment" - ] - }, - "DeviceKeySignParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeySignParams", - "description": "Sign an accepted structured payload with a controller-local device key.", - "type": "object", - "required": [ - "keyId", - "payload" - ], - "properties": { - "keyId": { - "type": "string" - }, - "payload": { - "$ref": "#/definitions/v2/DeviceKeySignPayload" - } - } - }, - "FsReadFileParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsReadFileParams", - "description": "Read a file from the host filesystem.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Absolute path to read.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - } - } - }, - "FsWriteFileParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsWriteFileParams", - "description": "Write a file on the host filesystem.", - "type": "object", - "required": [ - "dataBase64", - "path" - ], - "properties": { - "dataBase64": { - "description": "File contents encoded as base64.", - "type": "string" - }, - "path": { - "description": "Absolute path to write.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - } - } - }, - "FsCreateDirectoryParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsCreateDirectoryParams", - "description": "Create a directory on the host filesystem.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Absolute directory path to create.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - }, - "recursive": { - "description": "Whether parent directories should also be created. Defaults to `true`.", - "type": [ - "boolean", - "null" - ] - } - } - }, - "FsGetMetadataParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsGetMetadataParams", - "description": "Request metadata for an absolute path.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Absolute path to inspect.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - } - } - }, - "FsReadDirectoryParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsReadDirectoryParams", - "description": "List direct child names for a directory.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Absolute directory path to read.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - } - } - }, - "FsRemoveParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsRemoveParams", - "description": "Remove a file or directory tree from the host filesystem.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "force": { - "description": "Whether missing paths should be ignored. Defaults to `true`.", - "type": [ - "boolean", - "null" - ] - }, - "path": { - "description": "Absolute path to remove.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - }, - "recursive": { - "description": "Whether directory removal should recurse. Defaults to `true`.", - "type": [ - "boolean", - "null" - ] - } - } - }, - "FsCopyParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsCopyParams", - "description": "Copy a file or directory tree on the host filesystem.", - "type": "object", - "required": [ - "destinationPath", - "sourcePath" - ], - "properties": { - "destinationPath": { - "description": "Absolute destination path.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - }, - "recursive": { - "description": "Required for directory copies; ignored for file copies.", - "type": "boolean" - }, - "sourcePath": { - "description": "Absolute source path.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - } - } - }, - "FsWatchParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsWatchParams", - "description": "Start filesystem watch notifications for an absolute path.", - "type": "object", - "required": [ - "path", - "watchId" - ], - "properties": { - "path": { - "description": "Absolute file or directory path to watch.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - }, - "watchId": { - "description": "Connection-scoped watch identifier used for `fs/unwatch` and `fs/changed`.", - "type": "string" - } - } - }, - "FsUnwatchParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsUnwatchParams", - "description": "Stop filesystem watch notifications for a prior `fs/watch`.", - "type": "object", - "required": [ - "watchId" - ], - "properties": { - "watchId": { - "description": "Watch identifier previously provided to `fs/watch`.", - "type": "string" - } - } - }, - "ByteRange": { - "type": "object", - "required": [ - "end", - "start" - ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } - }, - "CollaborationMode": { - "description": "Collaboration mode for a Codex session.", - "type": "object", - "required": [ - "mode", - "settings" - ], - "properties": { - "mode": { - "$ref": "#/definitions/v2/ModeKind" - }, - "settings": { - "$ref": "#/definitions/v2/Settings" - } - } - }, - "ModeKind": { - "description": "Initial collaboration mode to use when the TUI starts.", - "type": "string", - "enum": [ - "plan", - "default" - ] - }, - "NetworkAccess": { - "type": "string", - "enum": [ - "restricted", - "enabled" - ] - }, - "ReadOnlyAccess": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "includePlatformDefaults": { - "default": true, - "type": "boolean" - }, - "readableRoots": { - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - }, - "type": { - "type": "string", - "enum": [ - "restricted" - ], - "title": "RestrictedReadOnlyAccessType" - } - }, - "title": "RestrictedReadOnlyAccess" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "fullAccess" - ], - "title": "FullAccessReadOnlyAccessType" - } - }, - "title": "FullAccessReadOnlyAccess" - } - ] - }, - "ReasoningEffort": { - "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", - "enum": [ - "none", - "minimal", - "low", - "medium", - "high", - "xhigh" - ] - }, - "ReasoningSummary": { - "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries", - "oneOf": [ - { - "type": "string", - "enum": [ - "auto", - "concise", - "detailed" - ] - }, - { - "description": "Option to disable reasoning summaries.", - "type": "string", - "enum": [ - "none" - ] - } - ] - }, - "SandboxPolicy": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "dangerFullAccess" - ], - "title": "DangerFullAccessSandboxPolicyType" - } - }, - "title": "DangerFullAccessSandboxPolicy" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "access": { - "default": { - "type": "fullAccess" - }, - "allOf": [ - { - "$ref": "#/definitions/v2/ReadOnlyAccess" - } - ] - }, - "networkAccess": { - "default": false, - "type": "boolean" - }, - "type": { - "type": "string", - "enum": [ - "readOnly" - ], - "title": "ReadOnlySandboxPolicyType" - } - }, - "title": "ReadOnlySandboxPolicy" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "networkAccess": { - "default": "restricted", - "allOf": [ - { - "$ref": "#/definitions/v2/NetworkAccess" - } - ] - }, - "type": { - "type": "string", - "enum": [ - "externalSandbox" - ], - "title": "ExternalSandboxSandboxPolicyType" - } - }, - "title": "ExternalSandboxSandboxPolicy" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "excludeSlashTmp": { - "default": false, - "type": "boolean" - }, - "excludeTmpdirEnvVar": { - "default": false, - "type": "boolean" - }, - "networkAccess": { - "default": false, - "type": "boolean" - }, - "readOnlyAccess": { - "default": { - "type": "fullAccess" - }, - "allOf": [ - { - "$ref": "#/definitions/v2/ReadOnlyAccess" - } - ] - }, - "type": { - "type": "string", - "enum": [ - "workspaceWrite" - ], - "title": "WorkspaceWriteSandboxPolicyType" - }, - "writableRoots": { - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - } - }, - "title": "WorkspaceWriteSandboxPolicy" - } - ] - }, - "Settings": { - "description": "Settings for a collaboration mode.", - "type": "object", - "required": [ - "model" - ], - "properties": { - "developer_instructions": { - "type": [ - "string", - "null" - ] - }, - "model": { - "type": "string" - }, - "reasoning_effort": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ReasoningEffort" - }, - { - "type": "null" - } - ] - } - } - }, - "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], - "properties": { - "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", - "allOf": [ - { - "$ref": "#/definitions/v2/ByteRange" - } - ] - }, - "placeholder": { - "description": "Optional human-readable placeholder for the element, displayed in the UI.", - "type": [ - "string", - "null" - ] - } - } - }, - "TurnEnvironmentParams": { - "type": "object", - "required": [ - "cwd", - "environmentId" - ], - "properties": { - "cwd": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - "environmentId": { - "type": "string" - } - } - }, - "UserInput": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/v2/TextElement" - } - }, - "type": { - "type": "string", - "enum": [ - "text" - ], - "title": "TextUserInputType" - } - }, - "title": "TextUserInput" - }, - { - "type": "object", - "required": [ - "type", - "url" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "image" - ], - "title": "ImageUserInputType" - }, - "url": { - "type": "string" - } - }, - "title": "ImageUserInput" - }, - { - "type": "object", - "required": [ - "path", - "type" - ], - "properties": { - "path": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "localImage" - ], - "title": "LocalImageUserInputType" - } - }, - "title": "LocalImageUserInput" - }, - { - "type": "object", - "required": [ - "name", - "path", - "type" - ], - "properties": { - "name": { - "type": "string" - }, - "path": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "mention" - ], - "title": "MentionUserInputType" - } - }, - "title": "MentionUserInput" - } - ] - }, - "TurnStartParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnStartParams", - "type": "object", - "required": [ - "input", - "threadId" - ], - "properties": { - "approvalPolicy": { - "description": "Override the approval policy for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/v2/AskForApproval" - }, - { - "type": "null" - } - ] - }, - "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/v2/ApprovalsReviewer" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - }, - "cwd": { - "description": "Override the working directory for this turn and subsequent turns.", - "type": [ - "string", - "null" - ] - }, - "effort": { - "description": "Override the reasoning effort for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/v2/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "summary": { - "description": "Override the reasoning summary for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/v2/ReasoningSummary" - }, - { - "type": "null" - } - ] - }, - "input": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/UserInput" - } - }, - "model": { - "description": "Override the model for this turn and subsequent turns.", - "type": [ - "string", - "null" - ] - }, - "outputSchema": { - "description": "Optional JSON Schema used to constrain the final assistant message for this turn." - }, - "permissionProfile": { - "description": "Override the full permissions profile for this turn and subsequent turns. Cannot be combined with `sandboxPolicy`.", - "anyOf": [ - { - "$ref": "#/definitions/v2/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "personality": { - "description": "Override the personality for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/v2/Personality" - }, - { - "type": "null" - } - ] - }, - "serviceTier": { - "description": "Override the service tier for this turn and subsequent turns.", - "anyOf": [ - { - "anyOf": [ - { - "$ref": "#/definitions/v2/ServiceTier" - }, - { - "type": "null" - } - ] - }, - { - "type": "null" - } - ] - }, - "sandboxPolicy": { - "description": "Override the sandbox policy for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/v2/SandboxPolicy" - }, - { - "type": "null" - } - ] - } - } - }, - "TurnSteerParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnSteerParams", - "type": "object", - "required": [ - "expectedTurnId", - "input", - "threadId" - ], - "properties": { - "expectedTurnId": { - "description": "Required active turn id precondition. The request fails when it does not match the currently active turn.", - "type": "string" - }, - "input": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/UserInput" - } - }, - "threadId": { - "type": "string" - } - } - }, - "TurnInterruptParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnInterruptParams", - "type": "object", - "required": [ - "threadId", - "turnId" - ], - "properties": { - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "RealtimeOutputModality": { - "type": "string", - "enum": [ - "text", - "audio" - ] - }, - "RealtimeVoice": { - "type": "string", - "enum": [ - "alloy", - "arbor", - "ash", - "ballad", - "breeze", - "cedar", - "coral", - "cove", - "echo", - "ember", - "juniper", - "maple", - "marin", - "sage", - "shimmer", - "sol", - "spruce", - "vale", - "verse" - ] - }, - "ThreadRealtimeStartTransport": { - "description": "EXPERIMENTAL - transport used by thread realtime.", - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "websocket" - ], - "title": "WebsocketThreadRealtimeStartTransportType" - } - }, - "title": "WebsocketThreadRealtimeStartTransport" - }, - { - "type": "object", - "required": [ - "sdp", - "type" - ], - "properties": { - "sdp": { - "description": "SDP offer generated by a WebRTC RTCPeerConnection after configuring audio and the realtime events data channel.", - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "webrtc" - ], - "title": "WebrtcThreadRealtimeStartTransportType" - } - }, - "title": "WebrtcThreadRealtimeStartTransport" - } - ] - }, - "ModelReroutedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ModelReroutedNotification", - "type": "object", - "required": [ - "fromModel", - "reason", - "threadId", - "toModel", - "turnId" - ], - "properties": { - "fromModel": { - "type": "string" - }, - "reason": { - "$ref": "#/definitions/v2/ModelRerouteReason" - }, - "threadId": { - "type": "string" - }, - "toModel": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ThreadRealtimeAudioChunk": { - "description": "EXPERIMENTAL - thread realtime audio chunk.", - "type": "object", - "required": [ - "data", - "numChannels", - "sampleRate" - ], - "properties": { - "data": { - "type": "string" - }, - "itemId": { - "type": [ - "string", - "null" - ] - }, - "numChannels": { - "type": "integer", - "format": "uint16", - "minimum": 0.0 - }, - "sampleRate": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "samplesPerChannel": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ModelRerouteReason": { - "type": "string", - "enum": [ - "highRiskCyberActivity" - ] - }, - "ContextCompactedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ContextCompactedNotification", - "description": "Deprecated: Use `ContextCompaction` item type instead.", - "type": "object", - "required": [ - "threadId", - "turnId" - ], - "properties": { - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ReasoningTextDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReasoningTextDeltaNotification", - "type": "object", - "required": [ - "contentIndex", - "delta", - "itemId", - "threadId", - "turnId" - ], - "properties": { - "contentIndex": { - "type": "integer", - "format": "int64" - }, - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ReasoningSummaryPartAddedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReasoningSummaryPartAddedNotification", - "type": "object", - "required": [ - "itemId", - "summaryIndex", - "threadId", - "turnId" - ], - "properties": { - "itemId": { - "type": "string" - }, - "summaryIndex": { - "type": "integer", - "format": "int64" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ReviewDelivery": { - "type": "string", - "enum": [ - "inline", - "detached" - ] - }, - "ReviewTarget": { - "oneOf": [ - { - "description": "Review the working tree: staged, unstaged, and untracked files.", - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "uncommittedChanges" - ], - "title": "UncommittedChangesReviewTargetType" - } - }, - "title": "UncommittedChangesReviewTarget" - }, - { - "description": "Review changes between the current branch and the given base branch.", - "type": "object", - "required": [ - "branch", - "type" - ], - "properties": { - "branch": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "baseBranch" - ], - "title": "BaseBranchReviewTargetType" - } - }, - "title": "BaseBranchReviewTarget" - }, - { - "description": "Review the changes introduced by a specific commit.", - "type": "object", - "required": [ - "sha", - "type" - ], - "properties": { - "sha": { - "type": "string" - }, - "title": { - "description": "Optional human-readable label (e.g., commit subject) for UIs.", - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "commit" - ], - "title": "CommitReviewTargetType" - } - }, - "title": "CommitReviewTarget" - }, - { - "description": "Arbitrary instructions, equivalent to the old free-form prompt.", - "type": "object", - "required": [ - "instructions", - "type" - ], - "properties": { - "instructions": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "custom" - ], - "title": "CustomReviewTargetType" - } - }, - "title": "CustomReviewTarget" - } - ] - }, - "ReviewStartParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReviewStartParams", - "type": "object", - "required": [ - "target", - "threadId" - ], - "properties": { - "delivery": { - "description": "Where to run the review: inline (default) on the current thread or detached on a new thread (returned in `reviewThreadId`).", - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/v2/ReviewDelivery" - }, - { - "type": "null" - } - ] - }, - "target": { - "$ref": "#/definitions/v2/ReviewTarget" - }, - "threadId": { - "type": "string" - } - } - }, - "ModelListParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ModelListParams", - "type": "object", - "properties": { - "cursor": { - "description": "Opaque pagination cursor returned by a previous call.", - "type": [ - "string", - "null" - ] - }, - "includeHidden": { - "description": "When true, include models that are hidden from the default picker list.", - "type": [ - "boolean", - "null" - ] - }, - "limit": { - "description": "Optional page size; defaults to a reasonable server-side value.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ExperimentalFeatureListParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExperimentalFeatureListParams", - "type": "object", - "properties": { - "cursor": { - "description": "Opaque pagination cursor returned by a previous call.", - "type": [ - "string", - "null" - ] - }, - "limit": { - "description": "Optional page size; defaults to a reasonable server-side value.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ExperimentalFeatureEnablementSetParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExperimentalFeatureEnablementSetParams", - "type": "object", - "required": [ - "enablement" - ], - "properties": { - "enablement": { - "description": "Process-wide runtime feature enablement keyed by canonical feature name.\n\nOnly named features are updated. Omitted features are left unchanged. Send an empty map for a no-op.", - "type": "object", - "additionalProperties": { - "type": "boolean" - } - } - } - }, - "ReasoningSummaryTextDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReasoningSummaryTextDeltaNotification", - "type": "object", - "required": [ - "delta", - "itemId", - "summaryIndex", - "threadId", - "turnId" - ], - "properties": { - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "summaryIndex": { - "type": "integer", - "format": "int64" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "FsChangedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsChangedNotification", - "description": "Filesystem watch notification emitted for `fs/watch` subscribers.", - "type": "object", - "required": [ - "changedPaths", - "watchId" - ], - "properties": { - "changedPaths": { - "description": "File or directory paths associated with this event.", - "type": "array", - "items": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - }, - "watchId": { - "description": "Watch identifier previously provided to `fs/watch`.", - "type": "string" - } - } - }, - "McpServerOauthLoginParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerOauthLoginParams", - "type": "object", - "required": [ - "name" - ], - "properties": { - "name": { - "type": "string" - }, - "scopes": { - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "timeoutSecs": { - "type": [ - "integer", - "null" - ], - "format": "int64" - } - } - }, - "McpServerStatusDetail": { - "type": "string", - "enum": [ - "full", - "toolsAndAuthOnly" - ] - }, - "ListMcpServerStatusParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ListMcpServerStatusParams", - "type": "object", - "properties": { - "cursor": { - "description": "Opaque pagination cursor returned by a previous call.", - "type": [ - "string", - "null" - ] - }, - "detail": { - "description": "Controls how much MCP inventory data to fetch for each server. Defaults to `Full` when omitted.", - "anyOf": [ - { - "$ref": "#/definitions/v2/McpServerStatusDetail" - }, - { - "type": "null" - } - ] - }, - "limit": { - "description": "Optional page size; defaults to a server-defined value.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - } - } - }, - "McpResourceReadParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpResourceReadParams", - "type": "object", - "required": [ - "server", - "uri" - ], - "properties": { - "server": { - "type": "string" - }, - "threadId": { - "type": [ - "string", - "null" - ] - }, - "uri": { - "type": "string" - } - } - }, - "McpServerToolCallParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerToolCallParams", - "type": "object", - "required": [ - "server", - "threadId", - "tool" - ], - "properties": { - "_meta": true, - "arguments": true, - "server": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "tool": { - "type": "string" - } - } - }, - "WindowsSandboxSetupMode": { - "type": "string", - "enum": [ - "elevated", - "unelevated" - ] - }, - "WindowsSandboxSetupStartParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WindowsSandboxSetupStartParams", - "type": "object", - "required": [ - "mode" - ], - "properties": { - "cwd": { - "anyOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - { - "type": "null" - } - ] - }, - "mode": { - "$ref": "#/definitions/v2/WindowsSandboxSetupMode" - } - } - }, - "LoginAccountParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "LoginAccountParams", - "oneOf": [ - { - "type": "object", - "required": [ - "apiKey", - "type" - ], - "properties": { - "apiKey": { - "type": "string" - }, - "type": { - "type": "string", "enum": [ "apiKey" ], - "title": "ApiKeyv2::LoginAccountParamsType" + "title": "ApiKeyAccountType", + "type": "string" } }, - "title": "ApiKeyv2::LoginAccountParams" - }, - { - "type": "object", "required": [ "type" ], + "title": "ApiKeyAccount", + "type": "object" + }, + { "properties": { + "email": { + "type": "string" + }, + "planType": { + "$ref": "#/definitions/v2/PlanType" + }, "type": { - "type": "string", "enum": [ "chatgpt" ], - "title": "Chatgptv2::LoginAccountParamsType" + "title": "ChatgptAccountType", + "type": "string" } }, - "title": "Chatgptv2::LoginAccountParams" - }, - { - "type": "object", "required": [ + "email", + "planType", "type" ], - "properties": { - "type": { - "type": "string", - "enum": [ - "chatgptDeviceCode" - ], - "title": "ChatgptDeviceCodev2::LoginAccountParamsType" - } - }, - "title": "ChatgptDeviceCodev2::LoginAccountParams" - }, - { - "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE. The access token must contain the same scopes that Codex-managed ChatGPT auth tokens have.", - "type": "object", - "required": [ - "accessToken", - "chatgptAccountId", - "type" - ], - "properties": { - "accessToken": { - "description": "Access token (JWT) supplied by the client. This token is used for backend API requests and email extraction.", - "type": "string" - }, - "chatgptAccountId": { - "description": "Workspace/account identifier supplied by the client.", - "type": "string" - }, - "chatgptPlanType": { - "description": "Optional plan type supplied by the client.\n\nWhen `null`, Codex attempts to derive the plan type from access-token claims. If unavailable, the plan defaults to `unknown`.", - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "chatgptAuthTokens" - ], - "title": "ChatgptAuthTokensv2::LoginAccountParamsType" - } - }, - "title": "ChatgptAuthTokensv2::LoginAccountParams" + "title": "ChatgptAccount", + "type": "object" } ] }, - "CancelLoginAccountParams": { + "AccountLoginCompletedNotification": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CancelLoginAccountParams", - "type": "object", - "required": [ - "loginId" - ], "properties": { - "loginId": { - "type": "string" - } - } - }, - "AddCreditsNudgeCreditType": { - "type": "string", - "enum": [ - "credits", - "usage_limit" - ] - }, - "SendAddCreditsNudgeEmailParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "SendAddCreditsNudgeEmailParams", - "type": "object", - "required": [ - "creditType" - ], - "properties": { - "creditType": { - "$ref": "#/definitions/v2/AddCreditsNudgeCreditType" - } - } - }, - "FeedbackUploadParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FeedbackUploadParams", - "type": "object", - "required": [ - "classification", - "includeLogs" - ], - "properties": { - "classification": { - "type": "string" - }, - "extraLogFiles": { - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "includeLogs": { - "type": "boolean" - }, - "reason": { - "type": [ - "string", - "null" - ] - }, - "tags": { - "type": [ - "object", - "null" - ], - "additionalProperties": { - "type": "string" - } - }, - "threadId": { - "type": [ - "string", - "null" - ] - } - } - }, - "CommandExecTerminalSize": { - "description": "PTY size in character cells for `command/exec` PTY sessions.", - "type": "object", - "required": [ - "cols", - "rows" - ], - "properties": { - "cols": { - "description": "Terminal width in character cells.", - "type": "integer", - "format": "uint16", - "minimum": 0.0 - }, - "rows": { - "description": "Terminal height in character cells.", - "type": "integer", - "format": "uint16", - "minimum": 0.0 - } - } - }, - "CommandExecParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecParams", - "description": "Run a standalone command (argv vector) in the server sandbox without creating a thread or turn.\n\nThe final `command/exec` response is deferred until the process exits and is sent only after all `command/exec/outputDelta` notifications for that connection have been emitted.", - "type": "object", - "required": [ - "command" - ], - "properties": { - "command": { - "description": "Command argv vector. Empty arrays are rejected.", - "type": "array", - "items": { - "type": "string" - } - }, - "cwd": { - "description": "Optional working directory. Defaults to the server cwd.", - "type": [ - "string", - "null" - ] - }, - "disableOutputCap": { - "description": "Disable stdout/stderr capture truncation for this request.\n\nCannot be combined with `outputBytesCap`.", - "type": "boolean" - }, - "disableTimeout": { - "description": "Disable the timeout entirely for this request.\n\nCannot be combined with `timeoutMs`.", - "type": "boolean" - }, - "env": { - "description": "Optional environment overrides merged into the server-computed environment.\n\nMatching names override inherited values. Set a key to `null` to unset an inherited variable.", - "type": [ - "object", - "null" - ], - "additionalProperties": { - "type": [ - "string", - "null" - ] - } - }, - "outputBytesCap": { - "description": "Optional per-stream stdout/stderr capture cap in bytes.\n\nWhen omitted, the server default applies. Cannot be combined with `disableOutputCap`.", - "type": [ - "integer", - "null" - ], - "format": "uint", - "minimum": 0.0 - }, - "processId": { - "description": "Optional client-supplied, connection-scoped process id.\n\nRequired for `tty`, `streamStdin`, `streamStdoutStderr`, and follow-up `command/exec/write`, `command/exec/resize`, and `command/exec/terminate` calls. When omitted, buffered execution gets an internal id that is not exposed to the client.", - "type": [ - "string", - "null" - ] - }, - "sandboxPolicy": { - "description": "Optional sandbox policy for this command.\n\nUses the same shape as thread/turn execution sandbox configuration and defaults to the user's configured policy when omitted.", - "anyOf": [ - { - "$ref": "#/definitions/v2/SandboxPolicy" - }, - { - "type": "null" - } - ] - }, - "size": { - "description": "Optional initial PTY size in character cells. Only valid when `tty` is true.", - "anyOf": [ - { - "$ref": "#/definitions/v2/CommandExecTerminalSize" - }, - { - "type": "null" - } - ] - }, - "streamStdin": { - "description": "Allow follow-up `command/exec/write` requests to write stdin bytes.\n\nRequires a client-supplied `processId`.", - "type": "boolean" - }, - "streamStdoutStderr": { - "description": "Stream stdout/stderr via `command/exec/outputDelta` notifications.\n\nStreamed bytes are not duplicated into the final response and require a client-supplied `processId`.", - "type": "boolean" - }, - "timeoutMs": { - "description": "Optional timeout in milliseconds.\n\nWhen omitted, the server default applies. Cannot be combined with `disableTimeout`.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "tty": { - "description": "Enable PTY mode.\n\nThis implies `streamStdin` and `streamStdoutStderr`.", - "type": "boolean" - } - } - }, - "CommandExecWriteParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecWriteParams", - "description": "Write stdin bytes to a running `command/exec` session, close stdin, or both.", - "type": "object", - "required": [ - "processId" - ], - "properties": { - "closeStdin": { - "description": "Close stdin after writing `deltaBase64`, if present.", - "type": "boolean" - }, - "deltaBase64": { - "description": "Optional base64-encoded stdin bytes to write.", - "type": [ - "string", - "null" - ] - }, - "processId": { - "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", - "type": "string" - } - } - }, - "CommandExecTerminateParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecTerminateParams", - "description": "Terminate a running `command/exec` session.", - "type": "object", - "required": [ - "processId" - ], - "properties": { - "processId": { - "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", - "type": "string" - } - } - }, - "CommandExecResizeParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecResizeParams", - "description": "Resize a running PTY-backed `command/exec` session.", - "type": "object", - "required": [ - "processId", - "size" - ], - "properties": { - "processId": { - "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", - "type": "string" - }, - "size": { - "description": "New PTY size in character cells.", - "allOf": [ - { - "$ref": "#/definitions/v2/CommandExecTerminalSize" - } - ] - } - } - }, - "ConfigReadParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigReadParams", - "type": "object", - "properties": { - "cwd": { - "description": "Optional working directory to resolve project config layers. If specified, return the effective config as seen from that directory (i.e., including any project layers between `cwd` and the project/repo root).", - "type": [ - "string", - "null" - ] - }, - "includeLayers": { - "default": false, - "type": "boolean" - } - } - }, - "MergeStrategy": { - "type": "string", - "enum": [ - "replace", - "upsert" - ] - }, - "ConfigValueWriteParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigValueWriteParams", - "type": "object", - "required": [ - "keyPath", - "mergeStrategy", - "value" - ], - "properties": { - "expectedVersion": { - "type": [ - "string", - "null" - ] - }, - "filePath": { - "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.", - "type": [ - "string", - "null" - ] - }, - "keyPath": { - "type": "string" - }, - "mergeStrategy": { - "$ref": "#/definitions/v2/MergeStrategy" - }, - "value": true - } - }, - "ConfigEdit": { - "type": "object", - "required": [ - "keyPath", - "mergeStrategy", - "value" - ], - "properties": { - "keyPath": { - "type": "string" - }, - "mergeStrategy": { - "$ref": "#/definitions/v2/MergeStrategy" - }, - "value": true - } - }, - "ConfigBatchWriteParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigBatchWriteParams", - "type": "object", - "required": [ - "edits" - ], - "properties": { - "edits": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ConfigEdit" - } - }, - "expectedVersion": { - "type": [ - "string", - "null" - ] - }, - "filePath": { - "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.", - "type": [ - "string", - "null" - ] - }, - "reloadUserConfig": { - "description": "When true, hot-reload the updated user config into all loaded threads after writing.", - "type": "boolean" - } - } - }, - "GetAccountParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "GetAccountParams", - "type": "object", - "properties": { - "refreshToken": { - "description": "When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.", - "default": false, - "type": "boolean" - } - } - }, - "AgentPath": { - "type": "string" - }, - "CodexErrorInfo": { - "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", - "oneOf": [ - { - "type": "string", - "enum": [ - "contextWindowExceeded", - "usageLimitExceeded", - "serverOverloaded", - "internalServerError", - "unauthorized", - "badRequest", - "threadRollbackFailed", - "sandboxError", - "other" - ] - }, - { - "type": "object", - "required": [ - "httpConnectionFailed" - ], - "properties": { - "httpConnectionFailed": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", - "required": [ - "responseStreamConnectionFailed" - ], - "properties": { - "responseStreamConnectionFailed": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", - "required": [ - "responseStreamDisconnected" - ], - "properties": { - "responseStreamDisconnected": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", - "required": [ - "responseTooManyFailedAttempts" - ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" - }, - { - "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], - "properties": { - "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], - "properties": { - "turnKind": { - "$ref": "#/definitions/v2/NonSteerableTurnKind" - } - } - } - }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" - } - ] - }, - "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], - "properties": { - "message": { - "type": [ - "string", - "null" - ] - }, - "status": { - "$ref": "#/definitions/v2/CollabAgentStatus" - } - } - }, - "CollabAgentStatus": { - "type": "string", - "enum": [ - "pendingInit", - "running", - "interrupted", - "completed", - "errored", - "shutdown", - "notFound" - ] - }, - "CollabAgentTool": { - "type": "string", - "enum": [ - "spawnAgent", - "sendInput", - "resumeAgent", - "wait", - "closeAgent" - ] - }, - "CollabAgentToolCallStatus": { - "type": "string", - "enum": [ - "inProgress", - "completed", - "failed" - ] - }, - "CommandAction": { - "oneOf": [ - { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], - "properties": { - "command": { - "type": "string" - }, - "name": { - "type": "string" - }, - "path": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - "type": { - "type": "string", - "enum": [ - "read" - ], - "title": "ReadCommandActionType" - } - }, - "title": "ReadCommandAction" - }, - { - "type": "object", - "required": [ - "command", - "type" - ], - "properties": { - "command": { - "type": "string" - }, - "path": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "listFiles" - ], - "title": "ListFilesCommandActionType" - } - }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", - "required": [ - "command", - "type" - ], - "properties": { - "command": { - "type": "string" - }, - "path": { - "type": [ - "string", - "null" - ] - }, - "query": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "search" - ], - "title": "SearchCommandActionType" - } - }, - "title": "SearchCommandAction" - }, - { - "type": "object", - "required": [ - "command", - "type" - ], - "properties": { - "command": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "unknown" - ], - "title": "UnknownCommandActionType" - } - }, - "title": "UnknownCommandAction" - } - ] - }, - "CommandExecutionSource": { - "type": "string", - "enum": [ - "agent", - "userShell", - "unifiedExecStartup", - "unifiedExecInteraction" - ] - }, - "CommandExecutionStatus": { - "type": "string", - "enum": [ - "inProgress", - "completed", - "failed", - "declined" - ] - }, - "DynamicToolCallOutputContentItem": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "inputText" - ], - "title": "InputTextDynamicToolCallOutputContentItemType" - } - }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", - "required": [ - "imageUrl", - "type" - ], - "properties": { - "imageUrl": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "inputImage" - ], - "title": "InputImageDynamicToolCallOutputContentItemType" - } - }, - "title": "InputImageDynamicToolCallOutputContentItem" - } - ] - }, - "DynamicToolCallStatus": { - "type": "string", - "enum": [ - "inProgress", - "completed", - "failed" - ] - }, - "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], - "properties": { - "exact_available": { - "type": "boolean" - }, - "indexed_chunk_count": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "indexed_file_count": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "path_prefix": { - "type": "string" - }, - "semantic_available": { - "type": "boolean" - }, - "shard_id": { - "type": "string" - }, - "status": { - "default": "unavailable", - "allOf": [ - { - "$ref": "#/definitions/v2/EpiphanyRetrievalStatus" - } - ] - } - } - }, - "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], - "properties": { - "dirty_paths": { - "type": "array", - "items": { - "type": "string" - } - }, - "index_revision": { - "type": [ - "string", - "null" - ] - }, - "indexed_chunk_count": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "indexed_file_count": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "last_indexed_at_unix_seconds": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "semantic_available": { - "type": "boolean" - }, - "shards": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyRetrievalShardSummary" - } - }, - "status": { - "default": "unavailable", - "allOf": [ - { - "$ref": "#/definitions/v2/EpiphanyRetrievalStatus" - } - ] - }, - "workspace_root": { - "type": "string" - } - } - }, - "EpiphanyRetrievalStatus": { - "type": "string", - "enum": [ - "unavailable", - "ready", - "stale", - "indexing" - ] - }, - "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], - "properties": { - "acceptance_receipts": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyAcceptanceReceipt" - } - }, - "active_subgoal_id": { - "type": [ - "string", - "null" - ] - }, - "churn": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyChurnState" - }, - { - "type": "null" - } - ] - }, - "graph_checkpoint": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyGraphCheckpoint" - }, - { - "type": "null" - } - ] - }, - "graph_frontier": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyGraphFrontier" - }, - { - "type": "null" - } - ] - }, - "graphs": { - "$ref": "#/definitions/v2/EpiphanyGraphs" - }, - "invariants": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyInvariant" - } - }, - "investigation_checkpoint": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "job_bindings": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyJobBinding" - } - }, - "last_updated_turn_id": { - "type": [ - "string", - "null" - ] - }, - "mode": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyModeState" - }, - { - "type": "null" - } - ] - }, - "objective": { - "type": [ - "string", - "null" - ] - }, - "observations": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyObservation" - } - }, - "planning": { - "$ref": "#/definitions/v2/EpiphanyPlanningState" - }, - "recent_evidence": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyEvidenceRecord" - } - }, - "retrieval": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyRetrievalState" - }, - { - "type": "null" - } - ] - }, - "revision": { - "type": "integer", - "format": "uint64", - "minimum": 0.0 - }, - "runtime_links": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyRuntimeLink" - } - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "subgoals": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanySubgoal" - } - } - } - }, - "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], - "properties": { - "diff": { - "type": "string" - }, - "kind": { - "$ref": "#/definitions/v2/PatchChangeKind" - }, - "path": { - "type": "string" - } - } - }, - "GitInfo": { - "type": "object", - "properties": { - "branch": { - "type": [ - "string", - "null" - ] - }, - "originUrl": { - "type": [ - "string", - "null" - ] - }, - "sha": { - "type": [ - "string", - "null" - ] - } - } - }, - "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], - "properties": { - "hookRunId": { - "type": "string" - }, - "text": { - "type": "string" - } - } - }, - "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], - "properties": { - "message": { - "type": "string" - } - } - }, - "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], - "properties": { - "_meta": true, - "content": { - "type": "array", - "items": true - }, - "structuredContent": true - } - }, - "McpToolCallStatus": { - "type": "string", - "enum": [ - "inProgress", - "completed", - "failed" - ] - }, - "MemoryCitation": { - "type": "object", - "required": [ - "entries", - "threadIds" - ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], - "properties": { - "lineEnd": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "lineStart": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "note": { - "type": "string" - }, - "path": { - "type": "string" - } - } - }, - "NonSteerableTurnKind": { - "type": "string", - "enum": [ - "review", - "compact" - ] - }, - "PatchApplyStatus": { - "type": "string", - "enum": [ - "inProgress", - "completed", - "failed", - "declined" - ] - }, - "PatchChangeKind": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "add" - ], - "title": "AddPatchChangeKindType" - } - }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "delete" - ], - "title": "DeletePatchChangeKindType" - } - }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "move_path": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "update" - ], - "title": "UpdatePatchChangeKindType" - } - }, - "title": "UpdatePatchChangeKind" - } - ] - }, - "SessionSource": { - "oneOf": [ - { - "type": "string", - "enum": [ - "cli", - "vscode", - "exec", - "appServer", - "unknown" - ] - }, - { - "type": "object", - "required": [ - "custom" - ], - "properties": { - "custom": { - "type": "string" - } - }, - "additionalProperties": false, - "title": "CustomSessionSource" - }, - { - "type": "object", - "required": [ - "subAgent" - ], - "properties": { - "subAgent": { - "$ref": "#/definitions/v2/SubAgentSource" - } - }, - "additionalProperties": false, - "title": "SubAgentSessionSource" - } - ] - }, - "SubAgentSource": { - "oneOf": [ - { - "type": "string", - "enum": [ - "review", - "compact", - "memory_consolidation" - ] - }, - { - "type": "object", - "required": [ - "thread_spawn" - ], - "properties": { - "thread_spawn": { - "type": "object", - "required": [ - "depth", - "parent_thread_id" - ], - "properties": { - "agent_nickname": { - "default": null, - "type": [ - "string", - "null" - ] - }, - "agent_path": { - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/v2/AgentPath" - }, - { - "type": "null" - } - ] - }, - "agent_role": { - "default": null, - "type": [ - "string", - "null" - ] - }, - "depth": { - "type": "integer", - "format": "int32" - }, - "parent_thread_id": { - "$ref": "#/definitions/v2/ThreadId" - } - } - } - }, - "additionalProperties": false, - "title": "ThreadSpawnSubAgentSource" - }, - { - "type": "object", - "required": [ - "other" - ], - "properties": { - "other": { - "type": "string" - } - }, - "additionalProperties": false, - "title": "OtherSubAgentSource" - } - ] - }, - "Thread": { - "type": "object", - "required": [ - "cliVersion", - "createdAt", - "cwd", - "ephemeral", - "id", - "modelProvider", - "preview", - "source", - "status", - "turns", - "updatedAt" - ], - "properties": { - "agentNickname": { - "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", - "type": [ - "string", - "null" - ] - }, - "agentRole": { - "description": "Optional role (agent_role) assigned to an AgentControl-spawned sub-agent.", - "type": [ - "string", - "null" - ] - }, - "cliVersion": { - "description": "Version of the CLI that created the thread.", - "type": "string" - }, - "createdAt": { - "description": "Unix timestamp (in seconds) when the thread was created.", - "type": "integer", - "format": "int64" - }, - "cwd": { - "description": "Working directory captured for the thread.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - }, - "ephemeral": { - "description": "Whether the thread is ephemeral and should not be materialized on disk.", - "type": "boolean" - }, - "epiphanyState": { - "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads.", - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyThreadState" - }, - { - "type": "null" - } - ] - }, - "forkedFromId": { - "description": "Source thread id when this thread was created by forking another thread.", - "type": [ - "string", - "null" - ] - }, - "gitInfo": { - "description": "Optional Git metadata captured when the thread was created.", - "anyOf": [ - { - "$ref": "#/definitions/v2/GitInfo" - }, - { - "type": "null" - } - ] - }, - "id": { - "type": "string" - }, - "modelProvider": { - "description": "Model provider used for this thread (for example, 'openai').", - "type": "string" - }, - "name": { - "description": "Optional user-facing thread title.", - "type": [ - "string", - "null" - ] - }, - "path": { - "description": "[UNSTABLE] Path to the thread on disk.", - "type": [ - "string", - "null" - ] - }, - "preview": { - "description": "Usually the first user message in the thread, if available.", - "type": "string" - }, - "source": { - "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).", - "allOf": [ - { - "$ref": "#/definitions/v2/SessionSource" - } - ] - }, - "status": { - "description": "Current runtime status for the thread.", - "allOf": [ - { - "$ref": "#/definitions/v2/ThreadStatus" - } - ] - }, - "turns": { - "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", - "type": "array", - "items": { - "$ref": "#/definitions/v2/Turn" - } - }, - "updatedAt": { - "description": "Unix timestamp (in seconds) when the thread was last updated.", - "type": "integer", - "format": "int64" - } - } - }, - "ThreadActiveFlag": { - "type": "string", - "enum": [ - "waitingOnApproval", - "waitingOnUserInput" - ] - }, - "ThreadId": { - "type": "string" - }, - "ThreadItem": { - "oneOf": [ - { - "type": "object", - "required": [ - "content", - "id", - "type" - ], - "properties": { - "content": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/UserInput" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType" - } - }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", - "required": [ - "fragments", - "id", - "type" - ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "text", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "memoryCitation": { - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/v2/MemoryCitation" - }, - { - "type": "null" - } - ] - }, - "phase": { - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/v2/MessagePhase" - }, - { - "type": "null" - } - ] - }, - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "agentMessage" - ], - "title": "AgentMessageThreadItemType" - } - }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", - "required": [ - "id", - "text", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "plan" - ], - "title": "PlanThreadItemType" - } - }, - "title": "PlanThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "type" - ], - "properties": { - "content": { - "default": [], - "type": "array", - "items": { - "type": "string" - } - }, - "id": { - "type": "string" - }, - "summary": { - "default": [], - "type": "array", - "items": { - "type": "string" - } - }, - "type": { - "type": "string", - "enum": [ - "reasoning" - ], - "title": "ReasoningThreadItemType" - } - }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", - "required": [ - "command", - "commandActions", - "cwd", - "id", - "status", - "type" - ], - "properties": { - "aggregatedOutput": { - "description": "The command's output, aggregated from stdout and stderr.", - "type": [ - "string", - "null" - ] - }, - "command": { - "description": "The command to be executed.", - "type": "string" - }, - "commandActions": { - "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", - "items": { - "$ref": "#/definitions/v2/CommandAction" - } - }, - "cwd": { - "description": "The command's working directory.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - }, - "durationMs": { - "description": "The duration of the command execution in milliseconds.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "exitCode": { - "description": "The command's exit code.", - "type": [ - "integer", - "null" - ], - "format": "int32" - }, - "id": { - "type": "string" - }, - "processId": { - "description": "Identifier for the underlying PTY process (when available).", - "type": [ - "string", - "null" - ] - }, - "source": { - "default": "agent", - "allOf": [ - { - "$ref": "#/definitions/v2/CommandExecutionSource" - } - ] - }, - "status": { - "$ref": "#/definitions/v2/CommandExecutionStatus" - }, - "type": { - "type": "string", - "enum": [ - "commandExecution" - ], - "title": "CommandExecutionThreadItemType" - } - }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", - "required": [ - "changes", - "id", - "status", - "type" - ], - "properties": { - "changes": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/FileUpdateChange" - } - }, - "id": { - "type": "string" - }, - "status": { - "$ref": "#/definitions/v2/PatchApplyStatus" - }, - "type": { - "type": "string", - "enum": [ - "fileChange" - ], - "title": "FileChangeThreadItemType" - } - }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", - "required": [ - "arguments", - "id", - "server", - "status", - "tool", - "type" - ], - "properties": { - "arguments": true, - "durationMs": { - "description": "The duration of the MCP tool call in milliseconds.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "error": { - "anyOf": [ - { - "$ref": "#/definitions/v2/McpToolCallError" - }, - { - "type": "null" - } - ] - }, - "id": { - "type": "string" - }, - "mcpAppResourceUri": { - "type": [ - "string", - "null" - ] - }, - "result": { - "anyOf": [ - { - "$ref": "#/definitions/v2/McpToolCallResult" - }, - { - "type": "null" - } - ] - }, - "server": { - "type": "string" - }, - "status": { - "$ref": "#/definitions/v2/McpToolCallStatus" - }, - "tool": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "mcpToolCall" - ], - "title": "McpToolCallThreadItemType" - } - }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", - "required": [ - "arguments", - "id", - "status", - "tool", - "type" - ], - "properties": { - "arguments": true, - "contentItems": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/v2/DynamicToolCallOutputContentItem" - } - }, - "durationMs": { - "description": "The duration of the dynamic tool call in milliseconds.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "id": { - "type": "string" - }, - "namespace": { - "type": [ - "string", - "null" - ] - }, - "status": { - "$ref": "#/definitions/v2/DynamicToolCallStatus" - }, - "success": { - "type": [ - "boolean", - "null" - ] - }, - "tool": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "dynamicToolCall" - ], - "title": "DynamicToolCallThreadItemType" - } - }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "properties": { - "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/v2/CollabAgentState" - } - }, - "id": { - "description": "Unique identifier for this collab tool call.", - "type": "string" - }, - "model": { - "description": "Model requested for the spawned agent, when applicable.", - "type": [ - "string", - "null" - ] - }, - "prompt": { - "description": "Prompt text sent as part of the collab tool call, when available.", - "type": [ - "string", - "null" - ] - }, - "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", - "anyOf": [ - { - "$ref": "#/definitions/v2/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "receiverThreadIds": { - "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", - "items": { - "type": "string" - } - }, - "senderThreadId": { - "description": "Thread ID of the agent issuing the collab request.", - "type": "string" - }, - "status": { - "description": "Current status of the collab tool call.", - "allOf": [ - { - "$ref": "#/definitions/v2/CollabAgentToolCallStatus" - } - ] - }, - "tool": { - "description": "Name of the collab tool that was invoked.", - "allOf": [ - { - "$ref": "#/definitions/v2/CollabAgentTool" - } - ] - }, - "type": { - "type": "string", - "enum": [ - "collabAgentToolCall" - ], - "title": "CollabAgentToolCallThreadItemType" - } - }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "query", - "type" - ], - "properties": { - "action": { - "anyOf": [ - { - "$ref": "#/definitions/v2/WebSearchAction" - }, - { - "type": "null" - } - ] - }, - "id": { - "type": "string" - }, - "query": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "webSearch" - ], - "title": "WebSearchThreadItemType" - } - }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "path", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "path": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - "type": { - "type": "string", - "enum": [ - "imageView" - ], - "title": "ImageViewThreadItemType" - } - }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "result", - "status", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "result": { - "type": "string" - }, - "revisedPrompt": { - "type": [ - "string", - "null" - ] - }, - "savedPath": { - "anyOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - { - "type": "null" - } - ] - }, - "status": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "imageGeneration" - ], - "title": "ImageGenerationThreadItemType" - } - }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "review", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "review": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "enteredReviewMode" - ], - "title": "EnteredReviewModeThreadItemType" - } - }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "review", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "review": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "exitedReviewMode" - ], - "title": "ExitedReviewModeThreadItemType" - } - }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "contextCompaction" - ], - "title": "ContextCompactionThreadItemType" - } - }, - "title": "ContextCompactionThreadItem" - } - ] - }, - "ThreadStatus": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "notLoaded" - ], - "title": "NotLoadedThreadStatusType" - } - }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "idle" - ], - "title": "IdleThreadStatusType" - } - }, - "title": "IdleThreadStatus" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "systemError" - ], - "title": "SystemErrorThreadStatusType" - } - }, - "title": "SystemErrorThreadStatus" - }, - { - "type": "object", - "required": [ - "activeFlags", - "type" - ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" - } - ] - }, - "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], - "properties": { - "completedAt": { - "description": "Unix timestamp (in seconds) when the turn completed.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "durationMs": { - "description": "Duration between turn start and completion in milliseconds, if known.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, "error": { - "description": "Only populated when the Turn's status is failed.", - "anyOf": [ - { - "$ref": "#/definitions/v2/TurnError" - }, - { - "type": "null" - } - ] - }, - "id": { - "type": "string" - }, - "items": { - "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadItem" - } - }, - "startedAt": { - "description": "Unix timestamp (in seconds) when the turn started.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "status": { - "$ref": "#/definitions/v2/TurnStatus" - } - } - }, - "TurnError": { - "type": "object", - "required": [ - "message" - ], - "properties": { - "additionalDetails": { - "default": null, "type": [ "string", "null" ] }, - "codexErrorInfo": { - "anyOf": [ - { - "$ref": "#/definitions/v2/CodexErrorInfo" - }, - { - "type": "null" - } + "loginId": { + "type": [ + "string", + "null" ] }, - "message": { - "type": "string" + "success": { + "type": "boolean" } - } - }, - "TurnStatus": { - "type": "string", - "enum": [ - "completed", - "interrupted", - "failed", - "inProgress" - ] - }, - "WebSearchAction": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "queries": { - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "query": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "search" - ], - "title": "SearchWebSearchActionType" - } - }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "openPage" - ], - "title": "OpenPageWebSearchActionType" - }, - "url": { - "type": [ - "string", - "null" - ] - } - }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "pattern": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "findInPage" - ], - "title": "FindInPageWebSearchActionType" - }, - "url": { - "type": [ - "string", - "null" - ] - } - }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "other" - ], - "title": "OtherWebSearchActionType" - } - }, - "title": "OtherWebSearchAction" - } - ] - }, - "ThreadStartResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadStartResponse", - "type": "object", + }, "required": [ - "approvalPolicy", - "approvalsReviewer", - "cwd", - "model", - "modelProvider", - "sandbox", - "thread" + "success" ], - "properties": { - "approvalPolicy": { - "$ref": "#/definitions/v2/AskForApproval" - }, - "approvalsReviewer": { - "description": "Reviewer currently used for approval requests on this thread.", - "allOf": [ - { - "$ref": "#/definitions/v2/ApprovalsReviewer" - } - ] - }, - "cwd": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - "instructionSources": { - "description": "Instruction source files currently loaded for this thread.", - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - }, - "model": { - "type": "string" - }, - "modelProvider": { - "type": "string" - }, - "permissionProfile": { - "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`.", - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/v2/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "reasoningEffort": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "sandbox": { - "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view.", - "allOf": [ - { - "$ref": "#/definitions/v2/SandboxPolicy" - } - ] - }, - "serviceTier": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ServiceTier" - }, - { - "type": "null" - } - ] - }, - "thread": { - "$ref": "#/definitions/v2/Thread" - } - } - }, - "ThreadResumeResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadResumeResponse", - "type": "object", - "required": [ - "approvalPolicy", - "approvalsReviewer", - "cwd", - "model", - "modelProvider", - "sandbox", - "thread" - ], - "properties": { - "approvalPolicy": { - "$ref": "#/definitions/v2/AskForApproval" - }, - "approvalsReviewer": { - "description": "Reviewer currently used for approval requests on this thread.", - "allOf": [ - { - "$ref": "#/definitions/v2/ApprovalsReviewer" - } - ] - }, - "cwd": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - "instructionSources": { - "description": "Instruction source files currently loaded for this thread.", - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - }, - "model": { - "type": "string" - }, - "modelProvider": { - "type": "string" - }, - "permissionProfile": { - "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`.", - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/v2/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "reasoningEffort": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "sandbox": { - "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view.", - "allOf": [ - { - "$ref": "#/definitions/v2/SandboxPolicy" - } - ] - }, - "serviceTier": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ServiceTier" - }, - { - "type": "null" - } - ] - }, - "thread": { - "$ref": "#/definitions/v2/Thread" - } - } - }, - "ThreadForkResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadForkResponse", - "type": "object", - "required": [ - "approvalPolicy", - "approvalsReviewer", - "cwd", - "model", - "modelProvider", - "sandbox", - "thread" - ], - "properties": { - "approvalPolicy": { - "$ref": "#/definitions/v2/AskForApproval" - }, - "approvalsReviewer": { - "description": "Reviewer currently used for approval requests on this thread.", - "allOf": [ - { - "$ref": "#/definitions/v2/ApprovalsReviewer" - } - ] - }, - "cwd": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - "instructionSources": { - "description": "Instruction source files currently loaded for this thread.", - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - }, - "model": { - "type": "string" - }, - "modelProvider": { - "type": "string" - }, - "permissionProfile": { - "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`.", - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/v2/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "reasoningEffort": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "sandbox": { - "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view.", - "allOf": [ - { - "$ref": "#/definitions/v2/SandboxPolicy" - } - ] - }, - "serviceTier": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ServiceTier" - }, - { - "type": "null" - } - ] - }, - "thread": { - "$ref": "#/definitions/v2/Thread" - } - } - }, - "ThreadArchiveResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadArchiveResponse", + "title": "AccountLoginCompletedNotification", "type": "object" }, - "ThreadUnsubscribeStatus": { - "type": "string", - "enum": [ - "notLoaded", - "notSubscribed", - "unsubscribed" - ] - }, - "ThreadUnsubscribeResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnsubscribeResponse", - "type": "object", - "required": [ - "status" - ], - "properties": { - "status": { - "$ref": "#/definitions/v2/ThreadUnsubscribeStatus" - } - } - }, "AccountRateLimitsUpdatedNotification": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "AccountRateLimitsUpdatedNotification", - "type": "object", - "required": [ - "rateLimits" - ], "properties": { "rateLimits": { "$ref": "#/definitions/v2/RateLimitSnapshot" } - } + }, + "required": [ + "rateLimits" + ], + "title": "AccountRateLimitsUpdatedNotification", + "type": "object" }, "AccountUpdatedNotification": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "AccountUpdatedNotification", - "type": "object", "properties": { "authMode": { "anyOf": [ @@ -13370,3450 +4956,463 @@ } ] } - } - }, - "ThreadSetNameResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadSetNameResponse", + }, + "title": "AccountUpdatedNotification", "type": "object" }, - "ThreadMetadataUpdateResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadMetadataUpdateResponse", - "type": "object", - "required": [ - "thread" + "AddCreditsNudgeCreditType": { + "enum": [ + "credits", + "usage_limit" ], + "type": "string" + }, + "AddCreditsNudgeEmailStatus": { + "enum": [ + "sent", + "cooldown_active" + ], + "type": "string" + }, + "AdditionalFileSystemPermissions": { "properties": { - "thread": { - "$ref": "#/definitions/v2/Thread" + "entries": { + "items": { + "$ref": "#/definitions/v2/FileSystemSandboxEntry" + }, + "type": [ + "array", + "null" + ] + }, + "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, + "type": [ + "integer", + "null" + ] + }, + "read": { + "items": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "type": [ + "array", + "null" + ] + }, + "write": { + "items": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "type": [ + "array", + "null" + ] } - } + }, + "type": "object" + }, + "AdditionalNetworkPermissions": { + "properties": { + "enabled": { + "type": [ + "boolean", + "null" + ] + } + }, + "type": "object" + }, + "AgentMessageDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "AgentMessageDeltaNotification", + "type": "object" + }, + "AgentPath": { + "type": "string" + }, + "AnalyticsConfig": { + "additionalProperties": true, + "properties": { + "enabled": { + "type": [ + "boolean", + "null" + ] + } + }, + "type": "object" + }, + "ApprovalsReviewer": { + "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", + "enum": [ + "user", + "auto_review", + "guardian_subagent" + ], + "type": "string" + }, + "AskForApproval": { + "oneOf": [ + { + "enum": [ + "untrusted", + "on-failure", + "on-request", + "never" + ], + "type": "string" + }, + { + "additionalProperties": false, + "properties": { + "granular": { + "properties": { + "mcp_elicitations": { + "type": "boolean" + }, + "request_permissions": { + "default": false, + "type": "boolean" + }, + "rules": { + "type": "boolean" + }, + "sandbox_approval": { + "type": "boolean" + } + }, + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], + "type": "object" + } + }, + "required": [ + "granular" + ], + "title": "GranularAskForApproval", + "type": "object" + } + ] }, "AuthMode": { "description": "Authentication mode for OpenAI-backed providers.", "oneOf": [ { "description": "OpenAI API key provided by the caller and stored by Codex.", - "type": "string", "enum": [ "apikey" - ] + ], + "type": "string" }, { "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).", - "type": "string", "enum": [ "chatgpt" - ] + ], + "type": "string" }, { "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE.\n\nChatGPT auth tokens are supplied by an external host app and are only stored in memory. Token refresh must be handled by the external host app.", - "type": "string", "enum": [ "chatgptAuthTokens" - ] + ], + "type": "string" }, { "description": "Programmatic Codex auth backed by a registered Agent Identity.", - "type": "string", "enum": [ "agentIdentity" - ] - } - ] - }, - "McpServerStatusUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerStatusUpdatedNotification", - "type": "object", - "required": [ - "name", - "status" - ], - "properties": { - "error": { - "type": [ - "string", - "null" - ] - }, - "name": { - "type": "string" - }, - "status": { - "$ref": "#/definitions/v2/McpServerStartupState" - } - } - }, - "ThreadUnarchiveResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnarchiveResponse", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "$ref": "#/definitions/v2/Thread" - } - } - }, - "ThreadCompactStartResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadCompactStartResponse", - "type": "object" - }, - "ThreadShellCommandResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadShellCommandResponse", - "type": "object" - }, - "ThreadApproveGuardianDeniedActionResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadApproveGuardianDeniedActionResponse", - "type": "object" - }, - "McpServerStartupState": { - "type": "string", - "enum": [ - "starting", - "ready", - "failed", - "cancelled" - ] - }, - "ThreadRollbackResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRollbackResponse", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "description": "The updated thread after applying the rollback, with `turns` populated.\n\nThe ThreadItems stored in each Turn are lossy since we explicitly do not persist all agent interactions, such as command executions. This is the same behavior as `thread/resume`.", - "allOf": [ - { - "$ref": "#/definitions/v2/Thread" - } - ] - } - } - }, - "ThreadListResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadListResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "backwardsCursor": { - "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one thread. Use it with the opposite `sortDirection`; for timestamp sorts it anchors at the start of the page timestamp so same-second updates are not skipped.", - "type": [ - "string", - "null" - ] - }, - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/Thread" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadLoadedListResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadLoadedListResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "data": { - "description": "Thread ids for sessions currently loaded in memory.", - "type": "array", - "items": { - "type": "string" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadReadResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadReadResponse", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "$ref": "#/definitions/v2/Thread" - } - } - }, - "ThreadEpiphanyContextSource": { - "type": "string", - "enum": [ - "stored", - "live" - ] - }, - "ThreadEpiphanyContextStateStatus": { - "type": "string", - "enum": [ - "missing", - "ready" - ] - }, - "ThreadEpiphanyCoordinatorAction": { - "type": "string", - "enum": [ - "prepareCheckpoint", - "compactRehydrateReorient", - "launchReorientWorker", - "waitForReorientWorker", - "reviewReorientResult", - "regatherManually", - "launchResearch", - "reviewResearchResult", - "launchModeling", - "reviewModelingResult", - "launchVerification", - "reviewVerificationResult", - "continueImplementation" - ] - }, - "ThreadEpiphanyCoordinatorSignals": { - "type": "object", - "required": [ - "crrcAction", - "modelingResultStatus", - "pressureLevel", - "researchResultStatus", - "reorientAction", - "reorientResultStatus", - "shouldPrepareCompaction", - "verificationResultStatus" - ], - "properties": { - "crrcAction": { - "$ref": "#/definitions/v2/ThreadEpiphanyCrrcAction" - }, - "modelingResultStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyRoleResultStatus" - }, - "pressureLevel": { - "$ref": "#/definitions/v2/ThreadEpiphanyPressureLevel" - }, - "researchResultStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyRoleResultStatus" - }, - "reorientAction": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientAction" - }, - "reorientResultStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientResultStatus" - }, - "shouldPrepareCompaction": { - "type": "boolean" - }, - "verificationResultStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyRoleResultStatus" - } - } - }, - "ThreadEpiphanyCrrcAction": { - "type": "string", - "enum": [ - "continue", - "prepareCheckpoint", - "launchReorientWorker", - "waitForReorientWorker", - "reviewReorientResult", - "acceptReorientResult", - "regatherManually" - ] - }, - "ThreadEpiphanyCrrcRecommendation": { - "type": "object", - "required": [ - "action", - "reason" - ], - "properties": { - "action": { - "$ref": "#/definitions/v2/ThreadEpiphanyCrrcAction" - }, - "reason": { - "type": "string" - }, - "recommendedSceneAction": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanySceneAction" - }, - { - "type": "null" - } - ] - } - } - }, - "ThreadEpiphanyGraphFreshnessStatus": { - "type": "string", - "enum": [ - "missing", - "ready", - "stale" - ] - }, - "ThreadEpiphanyInvalidationStatus": { - "type": "string", - "enum": [ - "unavailable", - "clean", - "changed" - ] - }, - "ThreadEpiphanyJob": { - "type": "object", - "required": [ - "id", - "kind", - "ownerRole", - "scope", - "status" - ], - "properties": { - "activeThreadIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "authorityScope": { - "type": [ - "string", - "null" - ] - }, - "backendJobId": { - "type": [ - "string", - "null" - ] - }, - "blockingReason": { - "type": [ - "string", - "null" - ] - }, - "id": { - "type": "string" - }, - "itemsProcessed": { - "type": [ - "integer", - "null" ], - "format": "uint32", - "minimum": 0.0 - }, - "itemsTotal": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "kind": { - "$ref": "#/definitions/v2/ThreadEpiphanyJobKind" - }, - "lastCheckpointAtUnixSeconds": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "launcherJobId": { - "type": [ - "string", - "null" - ] - }, - "linkedGraphNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "linkedSubgoalIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "ownerRole": { "type": "string" - }, - "progressNote": { - "type": [ - "string", - "null" - ] - }, - "scope": { - "type": "string" - }, - "status": { - "$ref": "#/definitions/v2/ThreadEpiphanyJobStatus" - } - } - }, - "ThreadEpiphanyJobKind": { - "type": "string", - "enum": [ - "indexing", - "remap", - "verification", - "specialist" - ] - }, - "ThreadEpiphanyJobStatus": { - "type": "string", - "enum": [ - "idle", - "needed", - "pending", - "running", - "completed", - "failed", - "cancelled", - "blocked", - "unavailable" - ] - }, - "ThreadEpiphanyPlanningSummary": { - "type": "object", - "required": [ - "backlogItemCount", - "captureCount", - "draftObjectiveCount", - "githubIssueCaptureCount", - "note", - "objectiveDraftCount", - "pendingCaptureCount", - "readyBacklogItemCount", - "roadmapStreamCount" - ], - "properties": { - "activeObjective": { - "type": [ - "string", - "null" - ] - }, - "backlogItemCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "captureCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "draftObjectiveCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "githubIssueCaptureCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "note": { - "type": "string" - }, - "objectiveDraftCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "pendingCaptureCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "readyBacklogItemCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "roadmapStreamCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ThreadEpiphanyPressure": { - "type": "object", - "required": [ - "basis", - "level", - "note", - "shouldPrepareCompaction", - "status" - ], - "properties": { - "basis": { - "$ref": "#/definitions/v2/ThreadEpiphanyPressureBasis" - }, - "level": { - "$ref": "#/definitions/v2/ThreadEpiphanyPressureLevel" - }, - "modelAutoCompactTokenLimit": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "modelContextWindow": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "note": { - "type": "string" - }, - "ratioPerMille": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "remainingTokens": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "shouldPrepareCompaction": { - "type": "boolean" - }, - "status": { - "$ref": "#/definitions/v2/ThreadEpiphanyPressureStatus" - }, - "usedTokens": { - "type": [ - "integer", - "null" - ], - "format": "int64" - } - } - }, - "ThreadEpiphanyPressureBasis": { - "type": "string", - "enum": [ - "unknown", - "autoCompactLimit", - "modelContextWindow" - ] - }, - "ThreadEpiphanyPressureLevel": { - "type": "string", - "enum": [ - "unknown", - "low", - "elevated", - "high", - "critical" - ] - }, - "ThreadEpiphanyPressureStatus": { - "type": "string", - "enum": [ - "unknown", - "ready" - ] - }, - "ThreadEpiphanyReorientAction": { - "type": "string", - "enum": [ - "resume", - "regather" - ] - }, - "ThreadEpiphanyReorientCheckpointStatus": { - "type": "string", - "enum": [ - "missing", - "resumeReady", - "regatherRequired" - ] - }, - "ThreadEpiphanyReorientDecision": { - "type": "object", - "required": [ - "action", - "checkpointStatus", - "graphStatus", - "nextAction", - "note", - "pressureLevel", - "retrievalStatus", - "watcherStatus" - ], - "properties": { - "action": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientAction" - }, - "activeFrontierNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointChangedPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointDirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointId": { - "type": [ - "string", - "null" - ] - }, - "checkpointStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientCheckpointStatus" - }, - "graphStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyGraphFreshnessStatus" - }, - "nextAction": { - "type": "string" - }, - "note": { - "type": "string" - }, - "pressureLevel": { - "$ref": "#/definitions/v2/ThreadEpiphanyPressureLevel" - }, - "reasons": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientReason" - } - }, - "retrievalStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyRetrievalFreshnessStatus" - }, - "watcherStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyInvalidationStatus" - } - } - }, - "ThreadEpiphanyReorientFinding": { - "type": "object", - "properties": { - "artifactRefs": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointStillValid": { - "type": [ - "boolean", - "null" - ] - }, - "evidenceIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "filesInspected": { - "type": "array", - "items": { - "type": "string" - } - }, - "frontierNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "itemError": { - "type": [ - "string", - "null" - ] - }, - "jobError": { - "type": [ - "string", - "null" - ] - }, - "mode": { - "type": [ - "string", - "null" - ] - }, - "nextSafeMove": { - "type": [ - "string", - "null" - ] - }, - "runtimeJobId": { - "type": [ - "string", - "null" - ] - }, - "runtimeResultId": { - "type": [ - "string", - "null" - ] - }, - "summary": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanyReorientReason": { - "type": "string", - "enum": [ - "missingState", - "missingCheckpoint", - "checkpointRequestedRegather", - "checkpointPathsDirty", - "checkpointPathsChanged", - "frontierChanged", - "unanchoredCheckpointWhileStateStale", - "checkpointReady" - ] - }, - "ThreadEpiphanyReorientResultStatus": { - "type": "string", - "enum": [ - "missingState", - "missingBinding", - "backendUnavailable", - "backendMissing", - "pending", - "running", - "completed", - "failed", - "cancelled" - ] - }, - "ThreadEpiphanyReorientSource": { - "type": "string", - "enum": [ - "stored", - "live" - ] - }, - "ThreadEpiphanyReorientStateStatus": { - "type": "string", - "enum": [ - "missing", - "ready" - ] - }, - "ThreadEpiphanyRetrievalFreshnessStatus": { - "type": "string", - "enum": [ - "missing", - "ready", - "stale", - "indexing", - "unavailable" - ] - }, - "ThreadEpiphanyRoleLane": { - "type": "object", - "required": [ - "id", - "note", - "ownerRole", - "status", - "title" - ], - "properties": { - "authorityScopes": { - "type": "array", - "items": { - "type": "string" - } - }, - "id": { - "$ref": "#/definitions/v2/ThreadEpiphanyRoleId" - }, - "jobs": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanyJob" - } - }, - "note": { - "type": "string" - }, - "ownerRole": { - "type": "string" - }, - "recommendedAction": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanySceneAction" - }, - { - "type": "null" - } - ] - }, - "status": { - "$ref": "#/definitions/v2/ThreadEpiphanyRoleStatus" - }, - "title": { - "type": "string" - } - } - }, - "ThreadEpiphanyRoleResultStatus": { - "type": "string", - "enum": [ - "missingState", - "missingBinding", - "backendUnavailable", - "backendMissing", - "pending", - "running", - "completed", - "failed", - "cancelled" - ] - }, - "ThreadEpiphanyRoleStatus": { - "type": "string", - "enum": [ - "ready", - "needed", - "blocked", - "running", - "completed", - "waiting", - "review", - "unavailable" - ] - }, - "ThreadEpiphanyRolesSource": { - "type": "string", - "enum": [ - "stored", - "live" - ] - }, - "ThreadEpiphanyScene": { - "type": "object", - "required": [ - "evidence", - "graph", - "observations", - "source", - "stateStatus" - ], - "properties": { - "activeSubgoal": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanySceneSubgoal" - }, - { - "type": "null" - } - ] - }, - "availableActions": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanySceneAction" - } - }, - "churn": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanySceneChurn" - }, - { - "type": "null" - } - ] - }, - "evidence": { - "$ref": "#/definitions/v2/ThreadEpiphanySceneRecords" - }, - "graph": { - "$ref": "#/definitions/v2/ThreadEpiphanySceneGraph" - }, - "invariantStatusCounts": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanySceneStatusCount" - } - }, - "investigationCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanySceneInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "objective": { - "type": [ - "string", - "null" - ] - }, - "observations": { - "$ref": "#/definitions/v2/ThreadEpiphanySceneRecords" - }, - "retrieval": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanySceneRetrieval" - }, - { - "type": "null" - } - ] - }, - "revision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "source": { - "$ref": "#/definitions/v2/ThreadEpiphanySceneSource" - }, - "stateStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanySceneStateStatus" - }, - "subgoals": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanySceneSubgoal" - } - } - } - }, - "ThreadEpiphanySceneAction": { - "type": "string", - "enum": [ - "index", - "retrieve", - "distill", - "context", - "planning", - "graphQuery", - "jobs", - "roles", - "coordinator", - "roleLaunch", - "roleResult", - "roleAccept", - "jobLaunch", - "jobInterrupt", - "freshness", - "pressure", - "reorient", - "crrc", - "reorientLaunch", - "reorientResult", - "reorientAccept", - "propose", - "promote", - "update" - ] - }, - "ThreadEpiphanySceneChurn": { - "type": "object", - "required": [ - "diffPressure", - "understandingStatus" - ], - "properties": { - "diffPressure": { - "type": "string" - }, - "graphFreshness": { - "type": [ - "string", - "null" - ] - }, - "understandingStatus": { - "type": "string" - }, - "unexplainedWrites": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "warning": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanySceneGraph": { - "type": "object", - "required": [ - "architectureEdgeCount", - "architectureNodeCount", - "dataflowEdgeCount", - "dataflowNodeCount", - "linkCount", - "openGapCount", - "openQuestionCount" - ], - "properties": { - "activeEdgeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "activeNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "architectureEdgeCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "architectureNodeCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "checkpointId": { - "type": [ - "string", - "null" - ] - }, - "checkpointSummary": { - "type": [ - "string", - "null" - ] - }, - "dataflowEdgeCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "dataflowNodeCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "dirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "linkCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "openGapCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "openQuestionCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ThreadEpiphanySceneInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpointId", - "codeRefCount", - "disposition", - "evidenceCount", - "focus", - "kind", - "openQuestionCount" - ], - "properties": { - "capturedAtTurnId": { - "type": [ - "string", - "null" - ] - }, - "checkpointId": { - "type": "string" - }, - "codeRefCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "disposition": { - "$ref": "#/definitions/v2/EpiphanyInvestigationDisposition" - }, - "evidenceCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "focus": { - "type": "string" - }, - "kind": { - "type": "string" - }, - "nextAction": { - "type": [ - "string", - "null" - ] - }, - "openQuestionCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "summary": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanySceneRecord": { - "type": "object", - "required": [ - "codeRefCount", - "id", - "kind", - "status", - "summary" - ], - "properties": { - "codeRefCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "id": { - "type": "string" - }, - "kind": { - "type": "string" - }, - "status": { - "type": "string" - }, - "summary": { - "type": "string" - } - } - }, - "ThreadEpiphanySceneRecords": { - "type": "object", - "required": [ - "totalCount" - ], - "properties": { - "latest": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanySceneRecord" - } - }, - "totalCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ThreadEpiphanySceneRetrieval": { - "type": "object", - "required": [ - "dirtyPathCount", - "semanticAvailable", - "shardCount", - "status", - "workspaceRoot" - ], - "properties": { - "dirtyPathCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "indexRevision": { - "type": [ - "string", - "null" - ] - }, - "indexedChunkCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "indexedFileCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "semanticAvailable": { - "type": "boolean" - }, - "shardCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "status": { - "$ref": "#/definitions/v2/EpiphanyRetrievalStatus" - }, - "workspaceRoot": { - "type": "string" - } - } - }, - "ThreadEpiphanySceneSource": { - "type": "string", - "enum": [ - "stored", - "live" - ] - }, - "ThreadEpiphanySceneStateStatus": { - "type": "string", - "enum": [ - "missing", - "ready" - ] - }, - "ThreadEpiphanySceneStatusCount": { - "type": "object", - "required": [ - "count", - "status" - ], - "properties": { - "count": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "status": { - "type": "string" - } - } - }, - "ThreadEpiphanySceneSubgoal": { - "type": "object", - "required": [ - "active", - "id", - "status", - "title" - ], - "properties": { - "active": { - "type": "boolean" - }, - "id": { - "type": "string" - }, - "status": { - "type": "string" - }, - "summary": { - "type": [ - "string", - "null" - ] - }, - "title": { - "type": "string" - } - } - }, - "ThreadEpiphanyViewCoordinator": { - "type": "object", - "required": [ - "action", - "canAutoRun", - "note", - "reason", - "requiresReview", - "roles", - "source", - "sourceSignals", - "stateStatus", - "threadId" - ], - "properties": { - "action": { - "$ref": "#/definitions/v2/ThreadEpiphanyCoordinatorAction" - }, - "canAutoRun": { - "type": "boolean" - }, - "note": { - "type": "string" - }, - "reason": { - "type": "string" - }, - "recommendedSceneAction": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanySceneAction" - }, - { - "type": "null" - } - ] - }, - "requiresReview": { - "type": "boolean" - }, - "roles": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanyRoleLane" - } - }, - "source": { - "$ref": "#/definitions/v2/ThreadEpiphanyRolesSource" - }, - "sourceSignals": { - "$ref": "#/definitions/v2/ThreadEpiphanyCoordinatorSignals" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "stateStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientStateStatus" - }, - "targetRole": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanyRoleId" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyViewCrrc": { - "type": "object", - "required": [ - "decision", - "note", - "pressure", - "recommendation", - "reorientBindingId", - "reorientResultStatus", - "source", - "stateStatus", - "threadId" - ], - "properties": { - "availableActions": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanySceneAction" - } - }, - "decision": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientDecision" - }, - "note": { - "type": "string" - }, - "pressure": { - "$ref": "#/definitions/v2/ThreadEpiphanyPressure" - }, - "recommendation": { - "$ref": "#/definitions/v2/ThreadEpiphanyCrrcRecommendation" - }, - "reorientBindingId": { - "type": "string" - }, - "reorientFinding": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientFinding" - }, - { - "type": "null" - } - ] - }, - "reorientJob": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanyJob" - }, - { - "type": "null" - } - ] - }, - "reorientResultStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientResultStatus" - }, - "source": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientSource" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "stateStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientStateStatus" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyViewPlanning": { - "type": "object", - "required": [ - "planning", - "source", - "stateStatus", - "summary", - "threadId" - ], - "properties": { - "planning": { - "$ref": "#/definitions/v2/EpiphanyPlanningState" - }, - "source": { - "$ref": "#/definitions/v2/ThreadEpiphanyContextSource" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "stateStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyContextStateStatus" - }, - "summary": { - "$ref": "#/definitions/v2/ThreadEpiphanyPlanningSummary" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyViewReorient": { - "type": "object", - "required": [ - "decision", - "source", - "stateStatus", - "threadId" - ], - "properties": { - "decision": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientDecision" - }, - "source": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientSource" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "stateStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientStateStatus" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyViewRoles": { - "type": "object", - "required": [ - "note", - "roles", - "source", - "stateStatus", - "threadId" - ], - "properties": { - "note": { - "type": "string" - }, - "roles": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanyRoleLane" - } - }, - "source": { - "$ref": "#/definitions/v2/ThreadEpiphanyRolesSource" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "stateStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyReorientStateStatus" - }, - "threadId": { - "type": "string" - } - } - }, - "McpServerOauthLoginCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerOauthLoginCompletedNotification", - "type": "object", - "required": [ - "name", - "success" - ], - "properties": { - "error": { - "type": [ - "string", - "null" - ] - }, - "name": { - "type": "string" - }, - "success": { - "type": "boolean" - } - } - }, - "ThreadEpiphanyStateUpdatedField": { - "type": "string", - "enum": [ - "objective", - "activeSubgoalId", - "subgoals", - "invariants", - "graphs", - "graphFrontier", - "graphCheckpoint", - "scratch", - "investigationCheckpoint", - "jobBindings", - "acceptanceReceipts", - "runtimeLinks", - "observations", - "evidence", - "churn", - "mode", - "planning" - ] - }, - "McpToolCallProgressNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpToolCallProgressNotification", - "type": "object", - "required": [ - "itemId", - "message", - "threadId", - "turnId" - ], - "properties": { - "itemId": { - "type": "string" - }, - "message": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ThreadEpiphanyRoleFinding": { - "type": "object", - "required": [ - "roleId" - ], - "properties": { - "artifactRefs": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointSummary": { - "type": [ - "string", - "null" - ] - }, - "evidenceGaps": { - "type": "array", - "items": { - "type": "string" - } - }, - "evidenceIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "filesInspected": { - "type": "array", - "items": { - "type": "string" - } - }, - "frontierNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "itemError": { - "type": [ - "string", - "null" - ] - }, - "jobError": { - "type": [ - "string", - "null" - ] - }, - "nextSafeMove": { - "type": [ - "string", - "null" - ] - }, - "openQuestions": { - "type": "array", - "items": { - "type": "string" - } - }, - "risks": { - "type": "array", - "items": { - "type": "string" - } - }, - "roleId": { - "$ref": "#/definitions/v2/ThreadEpiphanyRoleId" - }, - "runtimeJobId": { - "type": [ - "string", - "null" - ] - }, - "runtimeResultId": { - "type": [ - "string", - "null" - ] - }, - "scratchSummary": { - "type": [ - "string", - "null" - ] - }, - "selfPatch": true, - "selfPersistence": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanyRoleSelfPersistenceReview" - }, - { - "type": "null" - } - ] - }, - "statePatch": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ThreadEpiphanyUpdatePatch" - }, - { - "type": "null" - } - ] - }, - "summary": { - "type": [ - "string", - "null" - ] - }, - "verdict": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanyRoleSelfPersistenceReview": { - "type": "object", - "required": [ - "status" - ], - "properties": { - "reasons": { - "type": "array", - "items": { - "type": "string" - } - }, - "status": { - "$ref": "#/definitions/v2/ThreadEpiphanyRoleSelfPersistenceStatus" - }, - "targetAgentId": { - "type": [ - "string", - "null" - ] - }, - "targetPath": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanyRoleSelfPersistenceStatus": { - "type": "string", - "enum": [ - "missing", - "accepted", - "rejected" - ] - }, - "ServerRequestResolvedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ServerRequestResolvedNotification", - "type": "object", - "required": [ - "requestId", - "threadId" - ], - "properties": { - "requestId": { - "$ref": "#/definitions/v2/RequestId" - }, - "threadId": { - "type": "string" - } - } - }, - "RequestId": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "integer", - "format": "int64" } ] }, - "ThreadEpiphanyFreshnessSource": { - "type": "string", - "enum": [ - "stored", - "live" - ] - }, - "ThreadEpiphanyGraphFreshness": { - "type": "object", - "required": [ - "dirtyPathCount", - "note", - "openGapCount", - "openQuestionCount", - "status" - ], - "properties": { - "checkpointId": { - "type": [ - "string", - "null" - ] - }, - "dirtyPathCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "dirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "graphFreshness": { - "type": [ - "string", - "null" - ] - }, - "note": { - "type": "string" - }, - "openGapCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "openQuestionCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "status": { - "$ref": "#/definitions/v2/ThreadEpiphanyGraphFreshnessStatus" - } - } - }, - "ThreadEpiphanyInvalidationInput": { - "type": "object", - "required": [ - "changedPathCount", - "note", - "status" - ], - "properties": { - "activeFrontierNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "changedPathCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "changedPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "graphNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "note": { - "type": "string" - }, - "observedAtUnixSeconds": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "status": { - "$ref": "#/definitions/v2/ThreadEpiphanyInvalidationStatus" - }, - "watchedRoot": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanyRetrievalFreshness": { - "type": "object", - "required": [ - "note", - "status" - ], - "properties": { - "dirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "indexedChunkCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "indexedFileCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "lastIndexedAtUnixSeconds": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "note": { - "type": "string" - }, - "semanticAvailable": { - "type": [ - "boolean", - "null" - ] - }, - "status": { - "$ref": "#/definitions/v2/ThreadEpiphanyRetrievalFreshnessStatus" - } - } - }, - "FileChangePatchUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FileChangePatchUpdatedNotification", - "type": "object", - "required": [ - "changes", - "itemId", - "threadId", - "turnId" - ], - "properties": { - "changes": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/FileUpdateChange" - } - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ThreadEpiphanyContext": { - "type": "object", - "required": [ - "graph" - ], - "properties": { - "checkpoint": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyGraphCheckpoint" - }, - { - "type": "null" - } - ] - }, - "evidence": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyEvidenceRecord" - } - }, - "frontier": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyGraphFrontier" - }, - { - "type": "null" - } - ] - }, - "graph": { - "$ref": "#/definitions/v2/ThreadEpiphanyGraphContext" - }, - "investigationCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "observations": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyObservation" - } - } - } - }, - "ThreadEpiphanyContextMissing": { - "type": "object", - "properties": { - "evidenceIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "graphEdgeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "graphNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "observationIds": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ThreadEpiphanyGraphContext": { - "type": "object", - "properties": { - "architectureEdges": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyGraphEdge" - } - }, - "architectureNodes": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyGraphNode" - } - }, - "dataflowEdges": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyGraphEdge" - } - }, - "dataflowNodes": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyGraphNode" - } - }, - "links": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/EpiphanyGraphLink" - } - } - } - }, - "FileChangeOutputDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FileChangeOutputDeltaNotification", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], - "properties": { - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ThreadEpiphanyGraphQueryMatched": { - "type": "object", - "properties": { - "edgeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "edgeKinds": { - "type": "array", - "items": { - "type": "string" - } - }, - "nodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "paths": { - "type": "array", - "items": { - "type": "string" - } - }, - "symbols": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ThreadEpiphanyGraphQueryMissing": { - "type": "object", - "properties": { - "edgeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "nodeIds": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "TerminalInteractionNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TerminalInteractionNotification", - "type": "object", - "required": [ - "itemId", - "processId", - "stdin", - "threadId", - "turnId" - ], - "properties": { - "itemId": { - "type": "string" - }, - "processId": { - "type": "string" - }, - "stdin": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "CommandExecutionOutputDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecutionOutputDeltaNotification", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], - "properties": { - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "CommandExecOutputDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecOutputDeltaNotification", - "description": "Base64-encoded output chunk emitted for a streaming `command/exec` request.\n\nThese notifications are connection-scoped. If the originating connection closes, the server terminates the process.", - "type": "object", - "required": [ - "capReached", - "deltaBase64", - "processId", - "stream" - ], - "properties": { - "capReached": { - "description": "`true` on the final streamed chunk for a stream when `outputBytesCap` truncated later output on that stream.", - "type": "boolean" - }, - "deltaBase64": { - "description": "Base64-encoded output bytes.", - "type": "string" - }, - "processId": { - "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", - "type": "string" - }, - "stream": { - "description": "Output stream for this chunk.", - "allOf": [ - { - "$ref": "#/definitions/v2/CommandExecOutputStream" - } - ] - } - } - }, - "CommandExecOutputStream": { - "description": "Stream label for `command/exec/outputDelta` notifications.", - "oneOf": [ - { - "description": "stdout stream. PTY mode multiplexes terminal output here.", - "type": "string", - "enum": [ - "stdout" - ] - }, - { - "description": "stderr stream.", - "type": "string", - "enum": [ - "stderr" - ] - } - ] - }, - "ThreadEpiphanyRetrieveIndexSummary": { - "type": "object", - "required": [ - "dirtyPaths", - "semanticAvailable", - "shards", - "status", - "workspaceRoot" - ], - "properties": { - "dirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "indexRevision": { - "type": [ - "string", - "null" - ] - }, - "indexedChunkCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "indexedFileCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "lastIndexedAtUnixSeconds": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "semanticAvailable": { - "type": "boolean" - }, - "shards": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanyRetrieveShardSummary" - } - }, - "status": { - "$ref": "#/definitions/v2/EpiphanyRetrievalStatus" - }, - "workspaceRoot": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - } - }, - "ThreadEpiphanyRetrieveShardSummary": { - "type": "object", - "required": [ - "exactAvailable", - "pathPrefix", - "semanticAvailable", - "shardId", - "status" - ], - "properties": { - "exactAvailable": { - "type": "boolean" - }, - "indexedChunkCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "indexedFileCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "pathPrefix": { - "type": "string" - }, - "semanticAvailable": { - "type": "boolean" - }, - "shardId": { - "type": "string" - }, - "status": { - "$ref": "#/definitions/v2/EpiphanyRetrievalStatus" - } - } - }, - "PlanDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "PlanDeltaNotification", - "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items. Clients should not assume concatenated deltas match the completed plan item content.", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], - "properties": { - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "AgentMessageDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "AgentMessageDeltaNotification", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], - "properties": { - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "RawResponseItemCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "RawResponseItemCompletedNotification", - "type": "object", - "required": [ - "item", - "threadId", - "turnId" - ], - "properties": { - "item": { - "$ref": "#/definitions/v2/ResponseItem" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ItemCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ItemCompletedNotification", - "type": "object", - "required": [ - "item", - "threadId", - "turnId" - ], - "properties": { - "item": { - "$ref": "#/definitions/v2/ThreadItem" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ItemGuardianApprovalReviewCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ItemGuardianApprovalReviewCompletedNotification", - "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", - "type": "object", - "required": [ - "action", - "decisionSource", - "review", - "reviewId", - "threadId", - "turnId" - ], - "properties": { - "action": { - "$ref": "#/definitions/v2/GuardianApprovalReviewAction" - }, - "decisionSource": { - "$ref": "#/definitions/v2/AutoReviewDecisionSource" - }, - "review": { - "$ref": "#/definitions/v2/GuardianApprovalReview" - }, - "reviewId": { - "description": "Stable identifier for this review.", - "type": "string" - }, - "targetItemId": { - "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, "AutoReviewDecisionSource": { "description": "[UNSTABLE] Source that produced a terminal approval auto-review decision.", - "type": "string", "enum": [ "agent" - ] - }, - "ItemGuardianApprovalReviewStartedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ItemGuardianApprovalReviewStartedNotification", - "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", - "type": "object", - "required": [ - "action", - "review", - "reviewId", - "threadId", - "turnId" ], - "properties": { - "action": { - "$ref": "#/definitions/v2/GuardianApprovalReviewAction" - }, - "review": { - "$ref": "#/definitions/v2/GuardianApprovalReview" - }, - "reviewId": { - "description": "Stable identifier for this review.", - "type": "string" - }, - "targetItemId": { - "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } + "type": "string" }, - "ThreadEpiphanyRetrieveResult": { - "type": "object", - "required": [ - "kind", - "path", - "score" - ], + "ByteRange": { "properties": { - "excerpt": { - "type": [ - "string", - "null" - ] + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" }, - "kind": { - "$ref": "#/definitions/v2/ThreadEpiphanyRetrieveResultKind" - }, - "lineEnd": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "lineStart": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "path": { - "type": "string" - }, - "score": { - "type": "number", - "format": "float" - } - } - }, - "ThreadEpiphanyRetrieveResultKind": { - "type": "string", - "enum": [ - "exactFile", - "exactDirectory", - "semanticChunk" - ] - }, - "RequestPermissionProfile": { - "type": "object", - "properties": { - "fileSystem": { - "anyOf": [ - { - "$ref": "#/definitions/v2/AdditionalFileSystemPermissions" - }, - { - "type": "null" - } - ] - }, - "network": { - "anyOf": [ - { - "$ref": "#/definitions/v2/AdditionalNetworkPermissions" - }, - { - "type": "null" - } - ] + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" } }, - "additionalProperties": false - }, - "ThreadTurnsListResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadTurnsListResponse", - "type": "object", "required": [ - "data" + "end", + "start" ], - "properties": { - "backwardsCursor": { - "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one turn. Use it with the opposite `sortDirection` to include the anchor turn again and catch updates to that turn.", - "type": [ - "string", - "null" - ] - }, - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/Turn" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last turn. if None, there are no more turns to return.", - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadInjectItemsResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadInjectItemsResponse", "type": "object" }, - "DeviceKeyAlgorithm": { - "description": "Device-key algorithm reported at enrollment and signing boundaries.", - "type": "string", - "enum": [ - "ecdsa_p256_sha256" - ] - }, - "DeviceKeyProtectionClass": { - "description": "Platform protection class for a controller-local device key.", - "type": "string", - "enum": [ - "hardware_secure_enclave", - "hardware_tpm", - "os_protected_nonextractable" - ] - }, - "DeviceKeyCreateResponse": { + "CancelLoginAccountParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeyCreateResponse", - "description": "Device-key metadata and public key returned by create/public APIs.", - "type": "object", - "required": [ - "algorithm", - "keyId", - "protectionClass", - "publicKeySpkiDerBase64" - ], "properties": { - "algorithm": { - "$ref": "#/definitions/v2/DeviceKeyAlgorithm" - }, - "keyId": { - "type": "string" - }, - "protectionClass": { - "$ref": "#/definitions/v2/DeviceKeyProtectionClass" - }, - "publicKeySpkiDerBase64": { - "description": "SubjectPublicKeyInfo DER encoded as base64.", + "loginId": { "type": "string" } - } - }, - "DeviceKeyPublicResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeyPublicResponse", - "description": "Device-key public metadata returned by `device/key/public`.", - "type": "object", + }, "required": [ - "algorithm", - "keyId", - "protectionClass", - "publicKeySpkiDerBase64" + "loginId" ], - "properties": { - "algorithm": { - "$ref": "#/definitions/v2/DeviceKeyAlgorithm" - }, - "keyId": { - "type": "string" - }, - "protectionClass": { - "$ref": "#/definitions/v2/DeviceKeyProtectionClass" - }, - "publicKeySpkiDerBase64": { - "description": "SubjectPublicKeyInfo DER encoded as base64.", - "type": "string" - } - } - }, - "DeviceKeySignResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeySignResponse", - "description": "ASN.1 DER signature returned by `device/key/sign`.", - "type": "object", - "required": [ - "algorithm", - "signatureDerBase64", - "signedPayloadBase64" - ], - "properties": { - "algorithm": { - "$ref": "#/definitions/v2/DeviceKeyAlgorithm" - }, - "signatureDerBase64": { - "description": "ECDSA signature DER encoded as base64.", - "type": "string" - }, - "signedPayloadBase64": { - "description": "Exact bytes signed by the device key, encoded as base64. Verifiers must verify this byte string directly and must not reserialize `payload`.", - "type": "string" - } - } - }, - "FsReadFileResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsReadFileResponse", - "description": "Base64-encoded file contents returned by `fs/readFile`.", - "type": "object", - "required": [ - "dataBase64" - ], - "properties": { - "dataBase64": { - "description": "File contents encoded as base64.", - "type": "string" - } - } - }, - "FsWriteFileResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsWriteFileResponse", - "description": "Successful response for `fs/writeFile`.", + "title": "CancelLoginAccountParams", "type": "object" }, - "FsCreateDirectoryResponse": { + "CancelLoginAccountResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsCreateDirectoryResponse", - "description": "Successful response for `fs/createDirectory`.", + "properties": { + "status": { + "$ref": "#/definitions/v2/CancelLoginAccountStatus" + } + }, + "required": [ + "status" + ], + "title": "CancelLoginAccountResponse", "type": "object" }, - "FsGetMetadataResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsGetMetadataResponse", - "description": "Metadata returned by `fs/getMetadata`.", - "type": "object", - "required": [ - "createdAtMs", - "isDirectory", - "isFile", - "isSymlink", - "modifiedAtMs" - ], - "properties": { - "createdAtMs": { - "description": "File creation time in Unix milliseconds when available, otherwise `0`.", - "type": "integer", - "format": "int64" - }, - "isDirectory": { - "description": "Whether the path resolves to a directory.", - "type": "boolean" - }, - "isFile": { - "description": "Whether the path resolves to a regular file.", - "type": "boolean" - }, - "isSymlink": { - "description": "Whether the path itself is a symbolic link.", - "type": "boolean" - }, - "modifiedAtMs": { - "description": "File modification time in Unix milliseconds when available, otherwise `0`.", - "type": "integer", - "format": "int64" - } - } - }, - "FsReadDirectoryEntry": { - "description": "A directory entry returned by `fs/readDirectory`.", - "type": "object", - "required": [ - "fileName", - "isDirectory", - "isFile" - ], - "properties": { - "fileName": { - "description": "Direct child entry name only, not an absolute or relative path.", - "type": "string" - }, - "isDirectory": { - "description": "Whether this entry resolves to a directory.", - "type": "boolean" - }, - "isFile": { - "description": "Whether this entry resolves to a regular file.", - "type": "boolean" - } - } - }, - "FsReadDirectoryResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsReadDirectoryResponse", - "description": "Directory entries returned by `fs/readDirectory`.", - "type": "object", - "required": [ - "entries" - ], - "properties": { - "entries": { - "description": "Direct child entries in the requested directory.", - "type": "array", - "items": { - "$ref": "#/definitions/v2/FsReadDirectoryEntry" - } - } - } - }, - "FsRemoveResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsRemoveResponse", - "description": "Successful response for `fs/remove`.", - "type": "object" - }, - "FsCopyResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsCopyResponse", - "description": "Successful response for `fs/copy`.", - "type": "object" - }, - "FsWatchResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsWatchResponse", - "description": "Successful response for `fs/watch`.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Canonicalized path associated with the watch.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - } - } - }, - "FsUnwatchResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsUnwatchResponse", - "description": "Successful response for `fs/unwatch`.", - "type": "object" - }, - "TurnStartResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnStartResponse", - "type": "object", - "required": [ - "turn" - ], - "properties": { - "turn": { - "$ref": "#/definitions/v2/Turn" - } - } - }, - "TurnSteerResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnSteerResponse", - "type": "object", - "required": [ - "turnId" - ], - "properties": { - "turnId": { - "type": "string" - } - } - }, - "TurnInterruptResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnInterruptResponse", - "type": "object" - }, - "NetworkApprovalProtocol": { - "type": "string", + "CancelLoginAccountStatus": { "enum": [ - "http", - "https", - "socks5Tcp", - "socks5Udp" - ] - }, - "GuardianUserAuthorization": { - "description": "[UNSTABLE] Authorization level assigned by approval auto-review.", - "type": "string", - "enum": [ - "unknown", - "low", - "medium", - "high" - ] - }, - "GuardianRiskLevel": { - "description": "[UNSTABLE] Risk level assigned by approval auto-review.", - "type": "string", - "enum": [ - "low", - "medium", - "high", - "critical" - ] - }, - "GuardianCommandSource": { - "type": "string", - "enum": [ - "shell", - "unifiedExec" - ] - }, - "RealtimeVoicesList": { - "type": "object", - "required": [ - "defaultV1", - "defaultV2", - "v1", - "v2" + "canceled", + "notFound" ], - "properties": { - "defaultV1": { - "$ref": "#/definitions/v2/RealtimeVoice" - }, - "defaultV2": { - "$ref": "#/definitions/v2/RealtimeVoice" - }, - "v1": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/RealtimeVoice" - } - }, - "v2": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/RealtimeVoice" - } - } - } + "type": "string" }, - "GuardianApprovalReviewStatus": { - "description": "[UNSTABLE] Lifecycle state for an approval auto-review.", - "type": "string", - "enum": [ - "inProgress", - "approved", - "denied", - "timedOut", - "aborted" - ] - }, - "ReviewStartResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReviewStartResponse", - "type": "object", - "required": [ - "reviewThreadId", - "turn" - ], - "properties": { - "reviewThreadId": { - "description": "Identifies the thread where the review runs.\n\nFor inline reviews, this is the original thread id. For detached reviews, this is the id of the new review thread.", - "type": "string" - }, - "turn": { - "$ref": "#/definitions/v2/Turn" - } - } - }, - "InputModality": { - "description": "Canonical user-input modality tags advertised by a model.", + "CodexErrorInfo": { + "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "description": "Plain text turns and tool payloads.", - "type": "string", "enum": [ - "text" - ] + "contextWindowExceeded", + "usageLimitExceeded", + "serverOverloaded", + "internalServerError", + "unauthorized", + "badRequest", + "threadRollbackFailed", + "sandboxError", + "other" + ], + "type": "string" }, { - "description": "Image attachments included in user turns.", - "type": "string", - "enum": [ - "image" - ] + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, + "required": [ + "httpConnectionFailed" + ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", + "properties": { + "responseStreamConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, + "required": [ + "responseStreamConnectionFailed" + ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", + "properties": { + "responseStreamDisconnected": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, + "required": [ + "responseStreamDisconnected" + ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", + "properties": { + "responseTooManyFailedAttempts": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, + "required": [ + "responseTooManyFailedAttempts" + ], + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", + "properties": { + "activeTurnNotSteerable": { + "properties": { + "turnKind": { + "$ref": "#/definitions/v2/NonSteerableTurnKind" + } + }, + "required": [ + "turnKind" + ], + "type": "object" + } + }, + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, - "Model": { - "type": "object", - "required": [ - "defaultReasoningEffort", - "description", - "displayName", - "hidden", - "id", - "isDefault", - "model", - "supportedReasoningEfforts" - ], - "properties": { - "additionalSpeedTiers": { - "default": [], - "type": "array", - "items": { - "type": "string" - } - }, - "availabilityNux": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ModelAvailabilityNux" - }, - { - "type": "null" - } - ] - }, - "defaultReasoningEffort": { - "$ref": "#/definitions/v2/ReasoningEffort" - }, - "description": { - "type": "string" - }, - "displayName": { - "type": "string" - }, - "hidden": { - "type": "boolean" - }, - "id": { - "type": "string" - }, - "inputModalities": { - "default": [ - "text", - "image" - ], - "type": "array", - "items": { - "$ref": "#/definitions/v2/InputModality" - } - }, - "isDefault": { - "type": "boolean" - }, - "model": { - "type": "string" - }, - "supportedReasoningEfforts": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ReasoningEffortOption" - } - }, - "supportsPersonality": { - "default": false, - "type": "boolean" - }, - "upgrade": { - "type": [ - "string", - "null" - ] - }, - "upgradeInfo": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ModelUpgradeInfo" - }, - { - "type": "null" - } - ] - } - } - }, - "ModelAvailabilityNux": { - "type": "object", - "required": [ - "message" - ], + "CollabAgentState": { "properties": { "message": { - "type": "string" + "type": [ + "string", + "null" + ] + }, + "status": { + "$ref": "#/definitions/v2/CollabAgentStatus" } - } - }, - "ModelUpgradeInfo": { - "type": "object", + }, "required": [ - "model" + "status" ], - "properties": { - "migrationMarkdown": { - "type": [ - "string", - "null" - ] - }, - "model": { - "type": "string" - }, - "modelLink": { - "type": [ - "string", - "null" - ] - }, - "upgradeCopy": { - "type": [ - "string", - "null" - ] - } - } + "type": "object" }, - "ReasoningEffortOption": { - "type": "object", + "CollabAgentStatus": { + "enum": [ + "pendingInit", + "running", + "interrupted", + "completed", + "errored", + "shutdown", + "notFound" + ], + "type": "string" + }, + "CollabAgentTool": { + "enum": [ + "spawnAgent", + "sendInput", + "resumeAgent", + "wait", + "closeAgent" + ], + "type": "string" + }, + "CollabAgentToolCallStatus": { + "enum": [ + "inProgress", + "completed", + "failed" + ], + "type": "string" + }, + "CollaborationMode": { + "description": "Collaboration mode for a Codex session.", + "properties": { + "mode": { + "$ref": "#/definitions/v2/ModeKind" + }, + "settings": { + "$ref": "#/definitions/v2/Settings" + } + }, "required": [ - "description", - "reasoningEffort" + "mode", + "settings" ], - "properties": { - "description": { - "type": "string" - }, - "reasoningEffort": { - "$ref": "#/definitions/v2/ReasoningEffort" - } - } - }, - "ModelListResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ModelListResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/Model" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - } - }, - "ExperimentalFeature": { - "type": "object", - "required": [ - "defaultEnabled", - "enabled", - "name", - "stage" - ], - "properties": { - "announcement": { - "description": "Announcement copy shown to users when the feature is introduced. Null when this feature is not in beta.", - "type": [ - "string", - "null" - ] - }, - "defaultEnabled": { - "description": "Whether this feature is enabled by default.", - "type": "boolean" - }, - "description": { - "description": "Short summary describing what the feature does. Null when this feature is not in beta.", - "type": [ - "string", - "null" - ] - }, - "displayName": { - "description": "User-facing display name shown in the experimental features UI. Null when this feature is not in beta.", - "type": [ - "string", - "null" - ] - }, - "enabled": { - "description": "Whether this feature is currently enabled in the loaded config.", - "type": "boolean" - }, - "name": { - "description": "Stable key used in config.toml and CLI flag toggles.", - "type": "string" - }, - "stage": { - "description": "Lifecycle stage of this feature flag.", - "allOf": [ - { - "$ref": "#/definitions/v2/ExperimentalFeatureStage" - } - ] - } - } - }, - "ExperimentalFeatureStage": { - "oneOf": [ - { - "description": "Feature is available for user testing and feedback.", - "type": "string", - "enum": [ - "beta" - ] - }, - { - "description": "Feature is still being built and not ready for broad use.", - "type": "string", - "enum": [ - "underDevelopment" - ] - }, - { - "description": "Feature is production-ready.", - "type": "string", - "enum": [ - "stable" - ] - }, - { - "description": "Feature is deprecated and should be avoided.", - "type": "string", - "enum": [ - "deprecated" - ] - }, - { - "description": "Feature flag is retained only for backwards compatibility.", - "type": "string", - "enum": [ - "removed" - ] - } - ] - }, - "ExperimentalFeatureListResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExperimentalFeatureListResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ExperimentalFeature" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - } - }, - "ExperimentalFeatureEnablementSetResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExperimentalFeatureEnablementSetResponse", - "type": "object", - "required": [ - "enablement" - ], - "properties": { - "enablement": { - "description": "Feature enablement entries updated by this request.", - "type": "object", - "additionalProperties": { - "type": "boolean" - } - } - } + "type": "object" }, "CollaborationModeMask": { "description": "EXPERIMENTAL - collaboration mode preset metadata for clients.", - "type": "object", - "required": [ - "name" - ], "properties": { "mode": { "anyOf": [ @@ -16851,886 +5450,317 @@ } ] } - } + }, + "required": [ + "name" + ], + "type": "object" }, - "GuardianApprovalReviewAction": { + "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "cwd", - "source", - "type" - ], "properties": { "command": { "type": "string" }, - "cwd": { + "name": { + "type": "string" + }, + "path": { "$ref": "#/definitions/v2/AbsolutePathBuf" }, - "source": { - "$ref": "#/definitions/v2/GuardianCommandSource" - }, "type": { - "type": "string", "enum": [ - "command" + "read" ], - "title": "CommandGuardianApprovalReviewActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "CommandGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "argv", - "cwd", - "program", - "source", + "command", + "name", + "path", "type" ], - "properties": { - "argv": { - "type": "array", - "items": { - "type": "string" - } - }, - "cwd": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - "program": { - "type": "string" - }, - "source": { - "$ref": "#/definitions/v2/GuardianCommandSource" - }, - "type": { - "type": "string", - "enum": [ - "execve" - ], - "title": "ExecveGuardianApprovalReviewActionType" - } - }, - "title": "ExecveGuardianApprovalReviewAction" + "title": "ReadCommandAction", + "type": "object" }, { - "type": "object", - "required": [ - "cwd", - "files", - "type" - ], "properties": { - "cwd": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - "files": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - }, - "type": { - "type": "string", - "enum": [ - "applyPatch" - ], - "title": "ApplyPatchGuardianApprovalReviewActionType" - } - }, - "title": "ApplyPatchGuardianApprovalReviewAction" - }, - { - "type": "object", - "required": [ - "host", - "port", - "protocol", - "target", - "type" - ], - "properties": { - "host": { + "command": { "type": "string" }, - "port": { - "type": "integer", - "format": "uint16", - "minimum": 0.0 - }, - "protocol": { - "$ref": "#/definitions/v2/NetworkApprovalProtocol" - }, - "target": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "networkAccess" - ], - "title": "NetworkAccessGuardianApprovalReviewActionType" - } - }, - "title": "NetworkAccessGuardianApprovalReviewAction" - }, - { - "type": "object", - "required": [ - "server", - "toolName", - "type" - ], - "properties": { - "connectorId": { - "type": [ - "string", - "null" - ] - }, - "connectorName": { - "type": [ - "string", - "null" - ] - }, - "server": { - "type": "string" - }, - "toolName": { - "type": "string" - }, - "toolTitle": { + "path": { "type": [ "string", "null" ] }, "type": { - "type": "string", "enum": [ - "mcpToolCall" + "listFiles" ], - "title": "McpToolCallGuardianApprovalReviewActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "McpToolCallGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "permissions", + "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { - "permissions": { - "$ref": "#/definitions/v2/RequestPermissionProfile" + "command": { + "type": "string" }, - "reason": { + "path": { + "type": [ + "string", + "null" + ] + }, + "query": { "type": [ "string", "null" ] }, "type": { - "type": "string", "enum": [ - "requestPermissions" + "search" ], - "title": "RequestPermissionsGuardianApprovalReviewActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "RequestPermissionsGuardianApprovalReviewAction" + "required": [ + "command", + "type" + ], + "title": "SearchCommandAction", + "type": "object" + }, + { + "properties": { + "command": { + "type": "string" + }, + "type": { + "enum": [ + "unknown" + ], + "title": "UnknownCommandActionType", + "type": "string" + } + }, + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, - "GuardianApprovalReview": { - "description": "[UNSTABLE] Temporary approval auto-review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.", - "type": "object", - "required": [ - "status" - ], - "properties": { - "rationale": { - "type": [ - "string", - "null" - ] - }, - "riskLevel": { - "anyOf": [ - { - "$ref": "#/definitions/v2/GuardianRiskLevel" - }, - { - "type": "null" - } - ] - }, - "status": { - "$ref": "#/definitions/v2/GuardianApprovalReviewStatus" - }, - "userAuthorization": { - "anyOf": [ - { - "$ref": "#/definitions/v2/GuardianUserAuthorization" - }, - { - "type": "null" - } - ] - } - } - }, - "McpServerOauthLoginResponse": { + "CommandExecOutputDeltaNotification": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerOauthLoginResponse", - "type": "object", - "required": [ - "authorizationUrl" - ], + "description": "Base64-encoded output chunk emitted for a streaming `command/exec` request.\n\nThese notifications are connection-scoped. If the originating connection closes, the server terminates the process.", "properties": { - "authorizationUrl": { - "type": "string" - } - } - }, - "McpServerRefreshResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerRefreshResponse", - "type": "object" - }, - "McpAuthStatus": { - "type": "string", - "enum": [ - "unsupported", - "notLoggedIn", - "bearerToken", - "oAuth" - ] - }, - "McpServerStatus": { - "type": "object", - "required": [ - "authStatus", - "name", - "resourceTemplates", - "resources", - "tools" - ], - "properties": { - "authStatus": { - "$ref": "#/definitions/v2/McpAuthStatus" - }, - "name": { - "type": "string" - }, - "resourceTemplates": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ResourceTemplate" - } - }, - "resources": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/Resource" - } - }, - "tools": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/v2/Tool" - } - } - } - }, - "Resource": { - "description": "A known resource that the server is capable of reading.", - "type": "object", - "required": [ - "name", - "uri" - ], - "properties": { - "_meta": true, - "annotations": true, - "description": { - "type": [ - "string", - "null" - ] - }, - "icons": { - "type": [ - "array", - "null" - ], - "items": true - }, - "mimeType": { - "type": [ - "string", - "null" - ] - }, - "name": { - "type": "string" - }, - "size": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "title": { - "type": [ - "string", - "null" - ] - }, - "uri": { - "type": "string" - } - } - }, - "ResourceTemplate": { - "description": "A template description for resources available on the server.", - "type": "object", - "required": [ - "name", - "uriTemplate" - ], - "properties": { - "annotations": true, - "description": { - "type": [ - "string", - "null" - ] - }, - "mimeType": { - "type": [ - "string", - "null" - ] - }, - "name": { - "type": "string" - }, - "title": { - "type": [ - "string", - "null" - ] - }, - "uriTemplate": { - "type": "string" - } - } - }, - "Tool": { - "description": "Definition for a tool the client can call.", - "type": "object", - "required": [ - "inputSchema", - "name" - ], - "properties": { - "_meta": true, - "annotations": true, - "description": { - "type": [ - "string", - "null" - ] - }, - "icons": { - "type": [ - "array", - "null" - ], - "items": true - }, - "inputSchema": true, - "name": { - "type": "string" - }, - "outputSchema": true, - "title": { - "type": [ - "string", - "null" - ] - } - } - }, - "ListMcpServerStatusResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ListMcpServerStatusResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/McpServerStatus" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - } - }, - "ResourceContent": { - "description": "Contents returned when reading a resource from an MCP server.", - "anyOf": [ - { - "type": "object", - "required": [ - "text", - "uri" - ], - "properties": { - "_meta": true, - "mimeType": { - "type": [ - "string", - "null" - ] - }, - "text": { - "type": "string" - }, - "uri": { - "description": "The URI of this resource.", - "type": "string" - } - } - }, - { - "type": "object", - "required": [ - "blob", - "uri" - ], - "properties": { - "_meta": true, - "blob": { - "type": "string" - }, - "mimeType": { - "type": [ - "string", - "null" - ] - }, - "uri": { - "description": "The URI of this resource.", - "type": "string" - } - } - } - ] - }, - "McpResourceReadResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpResourceReadResponse", - "type": "object", - "required": [ - "contents" - ], - "properties": { - "contents": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/ResourceContent" - } - } - } - }, - "McpServerToolCallResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerToolCallResponse", - "type": "object", - "required": [ - "content" - ], - "properties": { - "_meta": true, - "content": { - "type": "array", - "items": true - }, - "isError": { - "type": [ - "boolean", - "null" - ] - }, - "structuredContent": true - } - }, - "WindowsSandboxSetupStartResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WindowsSandboxSetupStartResponse", - "type": "object", - "required": [ - "started" - ], - "properties": { - "started": { - "type": "boolean" - } - } - }, - "LoginAccountResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "LoginAccountResponse", - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "apiKey" - ], - "title": "ApiKeyv2::LoginAccountResponseType" - } - }, - "title": "ApiKeyv2::LoginAccountResponse" - }, - { - "type": "object", - "required": [ - "authUrl", - "loginId", - "type" - ], - "properties": { - "authUrl": { - "description": "URL the client should open in a browser to initiate the OAuth flow.", - "type": "string" - }, - "loginId": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "chatgpt" - ], - "title": "Chatgptv2::LoginAccountResponseType" - } - }, - "title": "Chatgptv2::LoginAccountResponse" - }, - { - "type": "object", - "required": [ - "loginId", - "type", - "userCode", - "verificationUrl" - ], - "properties": { - "loginId": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "chatgptDeviceCode" - ], - "title": "ChatgptDeviceCodev2::LoginAccountResponseType" - }, - "userCode": { - "description": "One-time code the user must enter after signing in.", - "type": "string" - }, - "verificationUrl": { - "description": "URL the client should open in a browser to complete device code authorization.", - "type": "string" - } - }, - "title": "ChatgptDeviceCodev2::LoginAccountResponse" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "chatgptAuthTokens" - ], - "title": "ChatgptAuthTokensv2::LoginAccountResponseType" - } - }, - "title": "ChatgptAuthTokensv2::LoginAccountResponse" - } - ] - }, - "CancelLoginAccountStatus": { - "type": "string", - "enum": [ - "canceled", - "notFound" - ] - }, - "CancelLoginAccountResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CancelLoginAccountResponse", - "type": "object", - "required": [ - "status" - ], - "properties": { - "status": { - "$ref": "#/definitions/v2/CancelLoginAccountStatus" - } - } - }, - "LogoutAccountResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "LogoutAccountResponse", - "type": "object" - }, - "CreditsSnapshot": { - "type": "object", - "required": [ - "hasCredits", - "unlimited" - ], - "properties": { - "balance": { - "type": [ - "string", - "null" - ] - }, - "hasCredits": { + "capReached": { + "description": "`true` on the final streamed chunk for a stream when `outputBytesCap` truncated later output on that stream.", "type": "boolean" }, - "unlimited": { - "type": "boolean" - } - } - }, - "PlanType": { - "type": "string", - "enum": [ - "free", - "go", - "plus", - "pro", - "prolite", - "team", - "self_serve_business_usage_based", - "business", - "enterprise_cbp_usage_based", - "enterprise", - "edu", - "unknown" - ] - }, - "RateLimitReachedType": { - "type": "string", - "enum": [ - "rate_limit_reached", - "workspace_owner_credits_depleted", - "workspace_member_credits_depleted", - "workspace_owner_usage_limit_reached", - "workspace_member_usage_limit_reached" - ] - }, - "RateLimitSnapshot": { - "type": "object", - "properties": { - "credits": { - "anyOf": [ - { - "$ref": "#/definitions/v2/CreditsSnapshot" - }, - { - "type": "null" - } - ] + "deltaBase64": { + "description": "Base64-encoded output bytes.", + "type": "string" }, - "limitId": { - "type": [ - "string", - "null" - ] + "processId": { + "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", + "type": "string" }, - "limitName": { - "type": [ - "string", - "null" - ] - }, - "planType": { - "anyOf": [ - { - "$ref": "#/definitions/v2/PlanType" - }, - { - "type": "null" - } - ] - }, - "primary": { - "anyOf": [ - { - "$ref": "#/definitions/v2/RateLimitWindow" - }, - { - "type": "null" - } - ] - }, - "rateLimitReachedType": { - "anyOf": [ - { - "$ref": "#/definitions/v2/RateLimitReachedType" - }, - { - "type": "null" - } - ] - }, - "secondary": { - "anyOf": [ - { - "$ref": "#/definitions/v2/RateLimitWindow" - }, - { - "type": "null" - } - ] - } - } - }, - "RateLimitWindow": { - "type": "object", - "required": [ - "usedPercent" - ], - "properties": { - "resetsAt": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "usedPercent": { - "type": "integer", - "format": "int32" - }, - "windowDurationMins": { - "type": [ - "integer", - "null" - ], - "format": "int64" - } - } - }, - "GetAccountRateLimitsResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "GetAccountRateLimitsResponse", - "type": "object", - "required": [ - "rateLimits" - ], - "properties": { - "rateLimits": { - "description": "Backward-compatible single-bucket view; mirrors the historical payload.", + "stream": { "allOf": [ { - "$ref": "#/definitions/v2/RateLimitSnapshot" + "$ref": "#/definitions/v2/CommandExecOutputStream" } + ], + "description": "Output stream for this chunk." + } + }, + "required": [ + "capReached", + "deltaBase64", + "processId", + "stream" + ], + "title": "CommandExecOutputDeltaNotification", + "type": "object" + }, + "CommandExecOutputStream": { + "description": "Stream label for `command/exec/outputDelta` notifications.", + "oneOf": [ + { + "description": "stdout stream. PTY mode multiplexes terminal output here.", + "enum": [ + "stdout" + ], + "type": "string" + }, + { + "description": "stderr stream.", + "enum": [ + "stderr" + ], + "type": "string" + } + ] + }, + "CommandExecParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Run a standalone command (argv vector) in the server sandbox without creating a thread or turn.\n\nThe final `command/exec` response is deferred until the process exits and is sent only after all `command/exec/outputDelta` notifications for that connection have been emitted.", + "properties": { + "command": { + "description": "Command argv vector. Empty arrays are rejected.", + "items": { + "type": "string" + }, + "type": "array" + }, + "cwd": { + "description": "Optional working directory. Defaults to the server cwd.", + "type": [ + "string", + "null" ] }, - "rateLimitsByLimitId": { - "description": "Multi-bucket view keyed by metered `limit_id` (for example, `codex`).", + "disableOutputCap": { + "description": "Disable stdout/stderr capture truncation for this request.\n\nCannot be combined with `outputBytesCap`.", + "type": "boolean" + }, + "disableTimeout": { + "description": "Disable the timeout entirely for this request.\n\nCannot be combined with `timeoutMs`.", + "type": "boolean" + }, + "env": { + "additionalProperties": { + "type": [ + "string", + "null" + ] + }, + "description": "Optional environment overrides merged into the server-computed environment.\n\nMatching names override inherited values. Set a key to `null` to unset an inherited variable.", "type": [ "object", "null" + ] + }, + "outputBytesCap": { + "description": "Optional per-stream stdout/stderr capture cap in bytes.\n\nWhen omitted, the server default applies. Cannot be combined with `disableOutputCap`.", + "format": "uint", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "processId": { + "description": "Optional client-supplied, connection-scoped process id.\n\nRequired for `tty`, `streamStdin`, `streamStdoutStderr`, and follow-up `command/exec/write`, `command/exec/resize`, and `command/exec/terminate` calls. When omitted, buffered execution gets an internal id that is not exposed to the client.", + "type": [ + "string", + "null" + ] + }, + "sandboxPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/v2/SandboxPolicy" + }, + { + "type": "null" + } ], - "additionalProperties": { - "$ref": "#/definitions/v2/RateLimitSnapshot" - } + "description": "Optional sandbox policy for this command.\n\nUses the same shape as thread/turn execution sandbox configuration and defaults to the user's configured policy when omitted." + }, + "size": { + "anyOf": [ + { + "$ref": "#/definitions/v2/CommandExecTerminalSize" + }, + { + "type": "null" + } + ], + "description": "Optional initial PTY size in character cells. Only valid when `tty` is true." + }, + "streamStdin": { + "description": "Allow follow-up `command/exec/write` requests to write stdin bytes.\n\nRequires a client-supplied `processId`.", + "type": "boolean" + }, + "streamStdoutStderr": { + "description": "Stream stdout/stderr via `command/exec/outputDelta` notifications.\n\nStreamed bytes are not duplicated into the final response and require a client-supplied `processId`.", + "type": "boolean" + }, + "timeoutMs": { + "description": "Optional timeout in milliseconds.\n\nWhen omitted, the server default applies. Cannot be combined with `disableTimeout`.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "tty": { + "description": "Enable PTY mode.\n\nThis implies `streamStdin` and `streamStdoutStderr`.", + "type": "boolean" } - } - }, - "AddCreditsNudgeEmailStatus": { - "type": "string", - "enum": [ - "sent", - "cooldown_active" - ] - }, - "SendAddCreditsNudgeEmailResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "SendAddCreditsNudgeEmailResponse", - "type": "object", + }, "required": [ - "status" + "command" ], - "properties": { - "status": { - "$ref": "#/definitions/v2/AddCreditsNudgeEmailStatus" - } - } + "title": "CommandExecParams", + "type": "object" }, - "FeedbackUploadResponse": { + "CommandExecResizeParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FeedbackUploadResponse", - "type": "object", - "required": [ - "threadId" - ], + "description": "Resize a running PTY-backed `command/exec` session.", "properties": { - "threadId": { + "processId": { + "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", "type": "string" + }, + "size": { + "allOf": [ + { + "$ref": "#/definitions/v2/CommandExecTerminalSize" + } + ], + "description": "New PTY size in character cells." } - } + }, + "required": [ + "processId", + "size" + ], + "title": "CommandExecResizeParams", + "type": "object" + }, + "CommandExecResizeResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Empty success response for `command/exec/resize`.", + "title": "CommandExecResizeResponse", + "type": "object" }, "CommandExecResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecResponse", "description": "Final buffered result for `command/exec`.", - "type": "object", - "required": [ - "exitCode", - "stderr", - "stdout" - ], "properties": { "exitCode": { "description": "Process exit code.", - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "stderr": { "description": "Buffered stderr capture.\n\nEmpty when stderr was streamed via `command/exec/outputDelta`.", @@ -17740,40 +5770,135 @@ "description": "Buffered stdout capture.\n\nEmpty when stdout was streamed via `command/exec/outputDelta`.", "type": "string" } - } + }, + "required": [ + "exitCode", + "stderr", + "stdout" + ], + "title": "CommandExecResponse", + "type": "object" }, - "CommandExecWriteResponse": { + "CommandExecTerminalSize": { + "description": "PTY size in character cells for `command/exec` PTY sessions.", + "properties": { + "cols": { + "description": "Terminal width in character cells.", + "format": "uint16", + "minimum": 0.0, + "type": "integer" + }, + "rows": { + "description": "Terminal height in character cells.", + "format": "uint16", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "cols", + "rows" + ], + "type": "object" + }, + "CommandExecTerminateParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecWriteResponse", - "description": "Empty success response for `command/exec/write`.", + "description": "Terminate a running `command/exec` session.", + "properties": { + "processId": { + "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", + "type": "string" + } + }, + "required": [ + "processId" + ], + "title": "CommandExecTerminateParams", "type": "object" }, "CommandExecTerminateResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecTerminateResponse", "description": "Empty success response for `command/exec/terminate`.", + "title": "CommandExecTerminateResponse", "type": "object" }, - "CommandExecResizeResponse": { + "CommandExecWriteParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecResizeResponse", - "description": "Empty success response for `command/exec/resize`.", - "type": "object" - }, - "AnalyticsConfig": { - "type": "object", + "description": "Write stdin bytes to a running `command/exec` session, close stdin, or both.", "properties": { - "enabled": { + "closeStdin": { + "description": "Close stdin after writing `deltaBase64`, if present.", + "type": "boolean" + }, + "deltaBase64": { + "description": "Optional base64-encoded stdin bytes to write.", "type": [ - "boolean", + "string", "null" ] + }, + "processId": { + "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", + "type": "string" } }, - "additionalProperties": true + "required": [ + "processId" + ], + "title": "CommandExecWriteParams", + "type": "object" + }, + "CommandExecWriteResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Empty success response for `command/exec/write`.", + "title": "CommandExecWriteResponse", + "type": "object" + }, + "CommandExecutionOutputDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "CommandExecutionOutputDeltaNotification", + "type": "object" + }, + "CommandExecutionSource": { + "enum": [ + "agent", + "userShell", + "unifiedExecStartup", + "unifiedExecInteraction" + ], + "type": "string" + }, + "CommandExecutionStatus": { + "enum": [ + "inProgress", + "completed", + "failed", + "declined" + ], + "type": "string" }, "Config": { - "type": "object", + "additionalProperties": true, "properties": { "analytics": { "anyOf": [ @@ -17796,7 +5921,6 @@ ] }, "approvals_reviewer": { - "description": "[UNSTABLE] Optional default for where approval requests are routed for review.", "anyOf": [ { "$ref": "#/definitions/v2/ApprovalsReviewer" @@ -17804,7 +5928,8 @@ { "type": "null" } - ] + ], + "description": "[UNSTABLE] Optional default for where approval requests are routed for review." }, "compact_prompt": { "type": [ @@ -17847,18 +5972,18 @@ ] }, "model_auto_compact_token_limit": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "model_context_window": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "model_provider": { "type": [ @@ -17903,11 +6028,11 @@ ] }, "profiles": { - "default": {}, - "type": "object", "additionalProperties": { "$ref": "#/definitions/v2/ProfileV2" - } + }, + "default": {}, + "type": "object" }, "review_model": { "type": [ @@ -17966,15 +6091,59 @@ ] } }, - "additionalProperties": true + "type": "object" + }, + "ConfigBatchWriteParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "edits": { + "items": { + "$ref": "#/definitions/v2/ConfigEdit" + }, + "type": "array" + }, + "expectedVersion": { + "type": [ + "string", + "null" + ] + }, + "filePath": { + "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.", + "type": [ + "string", + "null" + ] + }, + "reloadUserConfig": { + "description": "When true, hot-reload the updated user config into all loaded threads after writing.", + "type": "boolean" + } + }, + "required": [ + "edits" + ], + "title": "ConfigBatchWriteParams", + "type": "object" + }, + "ConfigEdit": { + "properties": { + "keyPath": { + "type": "string" + }, + "mergeStrategy": { + "$ref": "#/definitions/v2/MergeStrategy" + }, + "value": true + }, + "required": [ + "keyPath", + "mergeStrategy", + "value" + ], + "type": "object" }, "ConfigLayer": { - "type": "object", - "required": [ - "config", - "name", - "version" - ], "properties": { "config": true, "disabledReason": { @@ -17989,14 +6158,15 @@ "version": { "type": "string" } - } - }, - "ConfigLayerMetadata": { - "type": "object", + }, "required": [ + "config", "name", "version" ], + "type": "object" + }, + "ConfigLayerMetadata": { "properties": { "name": { "$ref": "#/definitions/v2/ConfigLayerSource" @@ -18004,18 +6174,17 @@ "version": { "type": "string" } - } + }, + "required": [ + "name", + "version" + ], + "type": "object" }, "ConfigLayerSource": { "oneOf": [ { "description": "Managed preferences layer delivered by MDM (macOS only).", - "type": "object", - "required": [ - "domain", - "key", - "type" - ], "properties": { "domain": { "type": "string" @@ -18024,153 +6193,5392 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mdm" ], - "title": "MdmConfigLayerSourceType" + "title": "MdmConfigLayerSourceType", + "type": "string" } }, - "title": "MdmConfigLayerSource" + "required": [ + "domain", + "key", + "type" + ], + "title": "MdmConfigLayerSource", + "type": "object" }, { "description": "Managed config layer from a file (usually `managed_config.toml`).", - "type": "object", - "required": [ - "file", - "type" - ], "properties": { "file": { - "description": "This is the path to the system config.toml file, though it is not guaranteed to exist.", "allOf": [ { "$ref": "#/definitions/v2/AbsolutePathBuf" } - ] + ], + "description": "This is the path to the system config.toml file, though it is not guaranteed to exist." }, "type": { - "type": "string", "enum": [ "system" ], - "title": "SystemConfigLayerSourceType" + "title": "SystemConfigLayerSourceType", + "type": "string" } }, - "title": "SystemConfigLayerSource" - }, - { - "description": "User config layer from $CODEX_HOME/config.toml. This layer is special in that it is expected to be: - writable by the user - generally outside the workspace directory", - "type": "object", "required": [ "file", "type" ], + "title": "SystemConfigLayerSource", + "type": "object" + }, + { + "description": "User config layer from $CODEX_HOME/config.toml. This layer is special in that it is expected to be: - writable by the user - generally outside the workspace directory", "properties": { "file": { - "description": "This is the path to the user's config.toml file, though it is not guaranteed to exist.", "allOf": [ { "$ref": "#/definitions/v2/AbsolutePathBuf" } - ] + ], + "description": "This is the path to the user's config.toml file, though it is not guaranteed to exist." }, "type": { - "type": "string", "enum": [ "user" ], - "title": "UserConfigLayerSourceType" + "title": "UserConfigLayerSourceType", + "type": "string" } }, - "title": "UserConfigLayerSource" + "required": [ + "file", + "type" + ], + "title": "UserConfigLayerSource", + "type": "object" }, { "description": "Path to a .codex/ folder within a project. There could be multiple of these between `cwd` and the project/repo root.", - "type": "object", - "required": [ - "dotCodexFolder", - "type" - ], "properties": { "dotCodexFolder": { "$ref": "#/definitions/v2/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "project" ], - "title": "ProjectConfigLayerSourceType" + "title": "ProjectConfigLayerSourceType", + "type": "string" } }, - "title": "ProjectConfigLayerSource" + "required": [ + "dotCodexFolder", + "type" + ], + "title": "ProjectConfigLayerSource", + "type": "object" }, { "description": "Session-layer overrides supplied via `-c`/`--config`.", - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "sessionFlags" ], - "title": "SessionFlagsConfigLayerSourceType" + "title": "SessionFlagsConfigLayerSourceType", + "type": "string" } }, - "title": "SessionFlagsConfigLayerSource" + "required": [ + "type" + ], + "title": "SessionFlagsConfigLayerSource", + "type": "object" }, { "description": "`managed_config.toml` was designed to be a config that was loaded as the last layer on top of everything else. This scheme did not quite work out as intended, but we keep this variant as a \"best effort\" while we phase out `managed_config.toml` in favor of `requirements.toml`.", - "type": "object", - "required": [ - "file", - "type" - ], "properties": { "file": { "$ref": "#/definitions/v2/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "legacyManagedConfigTomlFromFile" ], - "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType" + "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType", + "type": "string" } }, - "title": "LegacyManagedConfigTomlFromFileConfigLayerSource" - }, - { - "type": "object", "required": [ + "file", "type" ], + "title": "LegacyManagedConfigTomlFromFileConfigLayerSource", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "legacyManagedConfigTomlFromMdm" ], - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType" + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType", + "type": "string" } }, - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource" + "required": [ + "type" + ], + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource", + "type": "object" } ] }, + "ConfigReadParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cwd": { + "description": "Optional working directory to resolve project config layers. If specified, return the effective config as seen from that directory (i.e., including any project layers between `cwd` and the project/repo root).", + "type": [ + "string", + "null" + ] + }, + "includeLayers": { + "default": false, + "type": "boolean" + } + }, + "title": "ConfigReadParams", + "type": "object" + }, + "ConfigReadResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "config": { + "$ref": "#/definitions/v2/Config" + }, + "layers": { + "items": { + "$ref": "#/definitions/v2/ConfigLayer" + }, + "type": [ + "array", + "null" + ] + }, + "origins": { + "additionalProperties": { + "$ref": "#/definitions/v2/ConfigLayerMetadata" + }, + "type": "object" + } + }, + "required": [ + "config", + "origins" + ], + "title": "ConfigReadResponse", + "type": "object" + }, + "ConfigRequirements": { + "properties": { + "allowedApprovalPolicies": { + "items": { + "$ref": "#/definitions/v2/AskForApproval" + }, + "type": [ + "array", + "null" + ] + }, + "allowedSandboxModes": { + "items": { + "$ref": "#/definitions/v2/SandboxMode" + }, + "type": [ + "array", + "null" + ] + }, + "allowedWebSearchModes": { + "items": { + "$ref": "#/definitions/v2/WebSearchMode" + }, + "type": [ + "array", + "null" + ] + }, + "enforceResidency": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ResidencyRequirement" + }, + { + "type": "null" + } + ] + }, + "featureRequirements": { + "additionalProperties": { + "type": "boolean" + }, + "type": [ + "object", + "null" + ] + } + }, + "type": "object" + }, + "ConfigRequirementsReadResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "requirements": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ConfigRequirements" + }, + { + "type": "null" + } + ], + "description": "Null if no requirements are configured (e.g. no requirements.toml/MDM entries)." + } + }, + "title": "ConfigRequirementsReadResponse", + "type": "object" + }, + "ConfigValueWriteParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "expectedVersion": { + "type": [ + "string", + "null" + ] + }, + "filePath": { + "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.", + "type": [ + "string", + "null" + ] + }, + "keyPath": { + "type": "string" + }, + "mergeStrategy": { + "$ref": "#/definitions/v2/MergeStrategy" + }, + "value": true + }, + "required": [ + "keyPath", + "mergeStrategy", + "value" + ], + "title": "ConfigValueWriteParams", + "type": "object" + }, + "ConfigWarningNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "details": { + "description": "Optional extra guidance or error details.", + "type": [ + "string", + "null" + ] + }, + "path": { + "description": "Optional path to the config file that triggered the warning.", + "type": [ + "string", + "null" + ] + }, + "range": { + "anyOf": [ + { + "$ref": "#/definitions/v2/TextRange" + }, + { + "type": "null" + } + ], + "description": "Optional range for the error location inside the config file." + }, + "summary": { + "description": "Concise summary of the warning.", + "type": "string" + } + }, + "required": [ + "summary" + ], + "title": "ConfigWarningNotification", + "type": "object" + }, + "ConfigWriteResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "filePath": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Canonical path to the config file that was written." + }, + "overriddenMetadata": { + "anyOf": [ + { + "$ref": "#/definitions/v2/OverriddenMetadata" + }, + { + "type": "null" + } + ] + }, + "status": { + "$ref": "#/definitions/v2/WriteStatus" + }, + "version": { + "type": "string" + } + }, + "required": [ + "filePath", + "status", + "version" + ], + "title": "ConfigWriteResponse", + "type": "object" + }, + "ContentItem": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "input_text" + ], + "title": "InputTextContentItemType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "InputTextContentItem", + "type": "object" + }, + { + "properties": { + "detail": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ImageDetail" + }, + { + "type": "null" + } + ] + }, + "image_url": { + "type": "string" + }, + "type": { + "enum": [ + "input_image" + ], + "title": "InputImageContentItemType", + "type": "string" + } + }, + "required": [ + "image_url", + "type" + ], + "title": "InputImageContentItem", + "type": "object" + }, + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "output_text" + ], + "title": "OutputTextContentItemType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "OutputTextContentItem", + "type": "object" + } + ] + }, + "ContextCompactedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Deprecated: Use `ContextCompaction` item type instead.", + "properties": { + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "threadId", + "turnId" + ], + "title": "ContextCompactedNotification", + "type": "object" + }, + "CreditsSnapshot": { + "properties": { + "balance": { + "type": [ + "string", + "null" + ] + }, + "hasCredits": { + "type": "boolean" + }, + "unlimited": { + "type": "boolean" + } + }, + "required": [ + "hasCredits", + "unlimited" + ], + "type": "object" + }, + "DeprecationNoticeNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "details": { + "description": "Optional extra guidance, such as migration steps or rationale.", + "type": [ + "string", + "null" + ] + }, + "summary": { + "description": "Concise summary of what is deprecated.", + "type": "string" + } + }, + "required": [ + "summary" + ], + "title": "DeprecationNoticeNotification", + "type": "object" + }, + "DeviceKeyAlgorithm": { + "description": "Device-key algorithm reported at enrollment and signing boundaries.", + "enum": [ + "ecdsa_p256_sha256" + ], + "type": "string" + }, + "DeviceKeyCreateParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Create a controller-local device key with a random key id.", + "properties": { + "accountUserId": { + "type": "string" + }, + "clientId": { + "type": "string" + }, + "protectionPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/v2/DeviceKeyProtectionPolicy" + }, + { + "type": "null" + } + ], + "description": "Defaults to `hardware_only` when omitted." + } + }, + "required": [ + "accountUserId", + "clientId" + ], + "title": "DeviceKeyCreateParams", + "type": "object" + }, + "DeviceKeyCreateResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Device-key metadata and public key returned by create/public APIs.", + "properties": { + "algorithm": { + "$ref": "#/definitions/v2/DeviceKeyAlgorithm" + }, + "keyId": { + "type": "string" + }, + "protectionClass": { + "$ref": "#/definitions/v2/DeviceKeyProtectionClass" + }, + "publicKeySpkiDerBase64": { + "description": "SubjectPublicKeyInfo DER encoded as base64.", + "type": "string" + } + }, + "required": [ + "algorithm", + "keyId", + "protectionClass", + "publicKeySpkiDerBase64" + ], + "title": "DeviceKeyCreateResponse", + "type": "object" + }, + "DeviceKeyProtectionClass": { + "description": "Platform protection class for a controller-local device key.", + "enum": [ + "hardware_secure_enclave", + "hardware_tpm", + "os_protected_nonextractable" + ], + "type": "string" + }, + "DeviceKeyProtectionPolicy": { + "description": "Protection policy for creating or loading a controller-local device key.", + "enum": [ + "hardware_only", + "allow_os_protected_nonextractable" + ], + "type": "string" + }, + "DeviceKeyPublicParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Fetch a controller-local device key public key by id.", + "properties": { + "keyId": { + "type": "string" + } + }, + "required": [ + "keyId" + ], + "title": "DeviceKeyPublicParams", + "type": "object" + }, + "DeviceKeyPublicResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Device-key public metadata returned by `device/key/public`.", + "properties": { + "algorithm": { + "$ref": "#/definitions/v2/DeviceKeyAlgorithm" + }, + "keyId": { + "type": "string" + }, + "protectionClass": { + "$ref": "#/definitions/v2/DeviceKeyProtectionClass" + }, + "publicKeySpkiDerBase64": { + "description": "SubjectPublicKeyInfo DER encoded as base64.", + "type": "string" + } + }, + "required": [ + "algorithm", + "keyId", + "protectionClass", + "publicKeySpkiDerBase64" + ], + "title": "DeviceKeyPublicResponse", + "type": "object" + }, + "DeviceKeySignParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Sign an accepted structured payload with a controller-local device key.", + "properties": { + "keyId": { + "type": "string" + }, + "payload": { + "$ref": "#/definitions/v2/DeviceKeySignPayload" + } + }, + "required": [ + "keyId", + "payload" + ], + "title": "DeviceKeySignParams", + "type": "object" + }, + "DeviceKeySignPayload": { + "description": "Structured payloads accepted by `device/key/sign`.", + "oneOf": [ + { + "description": "Payload bound to one remote-control controller websocket `/client` connection challenge.", + "properties": { + "accountUserId": { + "type": "string" + }, + "audience": { + "$ref": "#/definitions/v2/RemoteControlClientConnectionAudience" + }, + "clientId": { + "type": "string" + }, + "nonce": { + "type": "string" + }, + "scopes": { + "description": "Must contain exactly `remote_control_controller_websocket`.", + "items": { + "type": "string" + }, + "type": "array" + }, + "sessionId": { + "description": "Backend-issued websocket session id that this proof authorizes.", + "type": "string" + }, + "targetOrigin": { + "description": "Origin of the backend endpoint that issued the challenge and will verify this proof.", + "type": "string" + }, + "targetPath": { + "description": "Websocket route path that this proof authorizes.", + "type": "string" + }, + "tokenExpiresAt": { + "description": "Remote-control token expiration as Unix seconds.", + "format": "int64", + "type": "integer" + }, + "tokenSha256Base64url": { + "description": "SHA-256 of the controller-scoped remote-control token, encoded as unpadded base64url.", + "type": "string" + }, + "type": { + "enum": [ + "remoteControlClientConnection" + ], + "title": "RemoteControlClientConnectionDeviceKeySignPayloadType", + "type": "string" + } + }, + "required": [ + "accountUserId", + "audience", + "clientId", + "nonce", + "scopes", + "sessionId", + "targetOrigin", + "targetPath", + "tokenExpiresAt", + "tokenSha256Base64url", + "type" + ], + "title": "RemoteControlClientConnectionDeviceKeySignPayload", + "type": "object" + }, + { + "description": "Payload bound to a remote-control client `/client/enroll` ownership challenge.", + "properties": { + "accountUserId": { + "type": "string" + }, + "audience": { + "$ref": "#/definitions/v2/RemoteControlClientEnrollmentAudience" + }, + "challengeExpiresAt": { + "description": "Enrollment challenge expiration as Unix seconds.", + "format": "int64", + "type": "integer" + }, + "challengeId": { + "description": "Backend-issued enrollment challenge id that this proof authorizes.", + "type": "string" + }, + "clientId": { + "type": "string" + }, + "deviceIdentitySha256Base64url": { + "description": "SHA-256 of the requested device identity operation, encoded as unpadded base64url.", + "type": "string" + }, + "nonce": { + "type": "string" + }, + "targetOrigin": { + "description": "Origin of the backend endpoint that issued the challenge and will verify this proof.", + "type": "string" + }, + "targetPath": { + "description": "HTTP route path that this proof authorizes.", + "type": "string" + }, + "type": { + "enum": [ + "remoteControlClientEnrollment" + ], + "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType", + "type": "string" + } + }, + "required": [ + "accountUserId", + "audience", + "challengeExpiresAt", + "challengeId", + "clientId", + "deviceIdentitySha256Base64url", + "nonce", + "targetOrigin", + "targetPath", + "type" + ], + "title": "RemoteControlClientEnrollmentDeviceKeySignPayload", + "type": "object" + } + ] + }, + "DeviceKeySignResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "ASN.1 DER signature returned by `device/key/sign`.", + "properties": { + "algorithm": { + "$ref": "#/definitions/v2/DeviceKeyAlgorithm" + }, + "signatureDerBase64": { + "description": "ECDSA signature DER encoded as base64.", + "type": "string" + }, + "signedPayloadBase64": { + "description": "Exact bytes signed by the device key, encoded as base64. Verifiers must verify this byte string directly and must not reserialize `payload`.", + "type": "string" + } + }, + "required": [ + "algorithm", + "signatureDerBase64", + "signedPayloadBase64" + ], + "title": "DeviceKeySignResponse", + "type": "object" + }, + "DynamicToolCallOutputContentItem": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "inputText" + ], + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { + "properties": { + "imageUrl": { + "type": "string" + }, + "type": { + "enum": [ + "inputImage" + ], + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" + } + }, + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" + } + ] + }, + "DynamicToolCallStatus": { + "enum": [ + "inProgress", + "completed", + "failed" + ], + "type": "string" + }, + "DynamicToolSpec": { + "properties": { + "deferLoading": { + "type": "boolean" + }, + "description": { + "type": "string" + }, + "inputSchema": true, + "name": { + "type": "string" + }, + "namespace": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "description", + "inputSchema", + "name" + ], + "type": "object" + }, + "EpiphanyAcceptanceReceipt": { + "properties": { + "accepted_at": { + "type": "string" + }, + "accepted_evidence_id": { + "type": [ + "string", + "null" + ] + }, + "accepted_observation_id": { + "type": [ + "string", + "null" + ] + }, + "binding_id": { + "type": "string" + }, + "id": { + "type": "string" + }, + "job_id": { + "type": "string" + }, + "result_id": { + "type": "string" + }, + "role_id": { + "type": "string" + }, + "status": { + "type": "string" + }, + "summary": { + "type": [ + "string", + "null" + ] + }, + "surface": { + "type": "string" + } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" + }, + "EpiphanyBacklogItem": { + "properties": { + "acceptance_sketch": { + "items": { + "type": "string" + }, + "type": "array" + }, + "blockers": { + "items": { + "type": "string" + }, + "type": "array" + }, + "confidence": { + "type": "string" + }, + "dependencies": { + "items": { + "type": "string" + }, + "type": "array" + }, + "duplicate_of": { + "type": [ + "string", + "null" + ] + }, + "evidence_refs": { + "items": { + "type": "string" + }, + "type": "array" + }, + "horizon": { + "type": "string" + }, + "id": { + "type": "string" + }, + "kind": { + "type": "string" + }, + "lane_hints": { + "items": { + "type": "string" + }, + "type": "array" + }, + "priority": { + "$ref": "#/definitions/v2/EpiphanyPlanningPriority" + }, + "product_area": { + "type": "string" + }, + "source_refs": { + "items": { + "$ref": "#/definitions/v2/EpiphanyPlanningSourceRef" + }, + "type": "array" + }, + "status": { + "type": "string" + }, + "summary": { + "type": "string" + }, + "title": { + "type": "string" + }, + "updated_at": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" + }, + "EpiphanyChurnState": { + "properties": { + "diff_pressure": { + "type": "string" + }, + "graph_freshness": { + "type": [ + "string", + "null" + ] + }, + "understanding_status": { + "type": "string" + }, + "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "warning": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" + }, + "EpiphanyCodeRef": { + "properties": { + "end_line": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "note": { + "type": [ + "string", + "null" + ] + }, + "path": { + "type": "string" + }, + "start_line": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "symbol": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "path" + ], + "type": "object" + }, + "EpiphanyEvidenceRecord": { + "properties": { + "code_refs": { + "items": { + "$ref": "#/definitions/v2/EpiphanyCodeRef" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "kind": { + "type": "string" + }, + "status": { + "type": "string" + }, + "summary": { + "type": "string" + } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" + }, + "EpiphanyGraph": { + "properties": { + "edges": { + "items": { + "$ref": "#/definitions/v2/EpiphanyGraphEdge" + }, + "type": "array" + }, + "nodes": { + "items": { + "$ref": "#/definitions/v2/EpiphanyGraphNode" + }, + "type": "array" + } + }, + "type": "object" + }, + "EpiphanyGraphCheckpoint": { + "properties": { + "checkpoint_id": { + "type": "string" + }, + "frontier_node_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "graph_revision": { + "format": "uint64", + "minimum": 0.0, + "type": "integer" + }, + "open_gap_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "open_question_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "summary": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" + }, + "EpiphanyGraphEdge": { + "properties": { + "code_refs": { + "items": { + "$ref": "#/definitions/v2/EpiphanyCodeRef" + }, + "type": "array" + }, + "id": { + "type": [ + "string", + "null" + ] + }, + "kind": { + "type": "string" + }, + "label": { + "type": [ + "string", + "null" + ] + }, + "mechanism": { + "type": [ + "string", + "null" + ] + }, + "source_id": { + "type": "string" + }, + "target_id": { + "type": "string" + } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" + }, + "EpiphanyGraphFrontier": { + "properties": { + "active_edge_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "active_node_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "dirty_paths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "open_gap_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "open_question_ids": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "EpiphanyGraphLink": { + "properties": { + "architecture_node_id": { + "type": "string" + }, + "code_refs": { + "items": { + "$ref": "#/definitions/v2/EpiphanyCodeRef" + }, + "type": "array" + }, + "dataflow_node_id": { + "type": "string" + }, + "relationship": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" + }, + "EpiphanyGraphNode": { + "properties": { + "code_refs": { + "items": { + "$ref": "#/definitions/v2/EpiphanyCodeRef" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "mechanism": { + "type": [ + "string", + "null" + ] + }, + "metaphor": { + "type": [ + "string", + "null" + ] + }, + "purpose": { + "type": "string" + }, + "status": { + "type": [ + "string", + "null" + ] + }, + "title": { + "type": "string" + } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" + }, + "EpiphanyGraphs": { + "properties": { + "architecture": { + "$ref": "#/definitions/v2/EpiphanyGraph" + }, + "dataflow": { + "$ref": "#/definitions/v2/EpiphanyGraph" + }, + "links": { + "items": { + "$ref": "#/definitions/v2/EpiphanyGraphLink" + }, + "type": "array" + } + }, + "type": "object" + }, + "EpiphanyInvariant": { + "properties": { + "description": { + "type": "string" + }, + "id": { + "type": "string" + }, + "rationale": { + "type": [ + "string", + "null" + ] + }, + "status": { + "type": "string" + } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" + }, + "EpiphanyInvestigationCheckpoint": { + "properties": { + "captured_at_turn_id": { + "type": [ + "string", + "null" + ] + }, + "checkpoint_id": { + "type": "string" + }, + "code_refs": { + "items": { + "$ref": "#/definitions/v2/EpiphanyCodeRef" + }, + "type": "array" + }, + "disposition": { + "$ref": "#/definitions/v2/EpiphanyInvestigationDisposition" + }, + "evidence_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "focus": { + "type": "string" + }, + "kind": { + "type": "string" + }, + "next_action": { + "type": [ + "string", + "null" + ] + }, + "open_questions": { + "items": { + "type": "string" + }, + "type": "array" + }, + "summary": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" + }, + "EpiphanyInvestigationDisposition": { + "enum": [ + "resume_ready", + "regather_required" + ], + "type": "string" + }, + "EpiphanyJobBinding": { + "properties": { + "authority_scope": { + "type": [ + "string", + "null" + ] + }, + "blocking_reason": { + "type": [ + "string", + "null" + ] + }, + "id": { + "type": "string" + }, + "kind": { + "$ref": "#/definitions/v2/EpiphanyJobKind" + }, + "linked_graph_node_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "linked_subgoal_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "owner_role": { + "type": "string" + }, + "scope": { + "type": "string" + } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" + }, + "EpiphanyJobKind": { + "enum": [ + "indexing", + "remap", + "verification", + "specialist" + ], + "type": "string" + }, + "EpiphanyModeKind": { + "enum": [ + "plan", + "default" + ], + "type": "string" + }, + "EpiphanyModeState": { + "properties": { + "kind": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyModeKind" + }, + { + "type": "null" + } + ] + }, + "name": { + "type": "string" + } + }, + "required": [ + "name" + ], + "type": "object" + }, + "EpiphanyObjectiveDraft": { + "properties": { + "acceptance_criteria": { + "items": { + "type": "string" + }, + "type": "array" + }, + "dependencies": { + "items": { + "type": "string" + }, + "type": "array" + }, + "evidence_required": { + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "lane_plan": { + "$ref": "#/definitions/v2/EpiphanyObjectiveDraftLanePlan" + }, + "review_gates": { + "items": { + "type": "string" + }, + "type": "array" + }, + "risks": { + "items": { + "type": "string" + }, + "type": "array" + }, + "scope": { + "$ref": "#/definitions/v2/EpiphanyObjectiveDraftScope" + }, + "source_item_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "status": { + "type": "string" + }, + "summary": { + "type": "string" + }, + "title": { + "type": "string" + } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" + }, + "EpiphanyObjectiveDraftLanePlan": { + "properties": { + "body": { + "type": [ + "string", + "null" + ] + }, + "eyes": { + "type": [ + "string", + "null" + ] + }, + "hands": { + "type": [ + "string", + "null" + ] + }, + "imagination": { + "type": [ + "string", + "null" + ] + }, + "life": { + "type": [ + "string", + "null" + ] + }, + "soul": { + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "EpiphanyObjectiveDraftScope": { + "properties": { + "excludes": { + "items": { + "type": "string" + }, + "type": "array" + }, + "includes": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "EpiphanyObservation": { + "properties": { + "code_refs": { + "items": { + "$ref": "#/definitions/v2/EpiphanyCodeRef" + }, + "type": "array" + }, + "evidence_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "source_kind": { + "type": "string" + }, + "status": { + "type": "string" + }, + "summary": { + "type": "string" + } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" + }, + "EpiphanyPlanningCapture": { + "properties": { + "body": { + "type": [ + "string", + "null" + ] + }, + "confidence": { + "type": "string" + }, + "created_at": { + "type": [ + "string", + "null" + ] + }, + "id": { + "type": "string" + }, + "source": { + "$ref": "#/definitions/v2/EpiphanyPlanningSourceRef" + }, + "speaker": { + "type": [ + "string", + "null" + ] + }, + "status": { + "type": "string" + }, + "tags": { + "items": { + "type": "string" + }, + "type": "array" + }, + "title": { + "type": "string" + }, + "updated_at": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" + }, + "EpiphanyPlanningPriority": { + "properties": { + "blocks": { + "items": { + "type": "string" + }, + "type": "array" + }, + "confidence": { + "type": [ + "string", + "null" + ] + }, + "effort": { + "type": [ + "string", + "null" + ] + }, + "impact": { + "type": [ + "string", + "null" + ] + }, + "rationale": { + "type": "string" + }, + "reason": { + "type": [ + "string", + "null" + ] + }, + "unblocks": { + "items": { + "type": "string" + }, + "type": "array" + }, + "urgency": { + "type": [ + "string", + "null" + ] + }, + "value": { + "type": "string" + } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" + }, + "EpiphanyPlanningSourceRef": { + "properties": { + "assignees": { + "items": { + "type": "string" + }, + "type": "array" + }, + "author": { + "type": [ + "string", + "null" + ] + }, + "closed_at": { + "type": [ + "string", + "null" + ] + }, + "created_at": { + "type": [ + "string", + "null" + ] + }, + "database_id": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "external_id": { + "type": [ + "string", + "null" + ] + }, + "imported_at": { + "type": [ + "string", + "null" + ] + }, + "is_pull_request": { + "type": [ + "boolean", + "null" + ] + }, + "issue_number": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "kind": { + "type": "string" + }, + "labels": { + "items": { + "type": "string" + }, + "type": "array" + }, + "milestone": { + "type": [ + "string", + "null" + ] + }, + "node_id": { + "type": [ + "string", + "null" + ] + }, + "provider": { + "type": [ + "string", + "null" + ] + }, + "repo": { + "type": [ + "string", + "null" + ] + }, + "state": { + "type": [ + "string", + "null" + ] + }, + "updated_at": { + "type": [ + "string", + "null" + ] + }, + "uri": { + "type": [ + "string", + "null" + ] + }, + "url": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind" + ], + "type": "object" + }, + "EpiphanyPlanningState": { + "properties": { + "backlog_items": { + "items": { + "$ref": "#/definitions/v2/EpiphanyBacklogItem" + }, + "type": "array" + }, + "captures": { + "items": { + "$ref": "#/definitions/v2/EpiphanyPlanningCapture" + }, + "type": "array" + }, + "objective_drafts": { + "items": { + "$ref": "#/definitions/v2/EpiphanyObjectiveDraft" + }, + "type": "array" + }, + "roadmap_streams": { + "items": { + "$ref": "#/definitions/v2/EpiphanyRoadmapStream" + }, + "type": "array" + }, + "workspace_root": { + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "EpiphanyRetrievalShardSummary": { + "properties": { + "exact_available": { + "type": "boolean" + }, + "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "path_prefix": { + "type": "string" + }, + "semantic_available": { + "type": "boolean" + }, + "shard_id": { + "type": "string" + }, + "status": { + "allOf": [ + { + "$ref": "#/definitions/v2/EpiphanyRetrievalStatus" + } + ], + "default": "unavailable" + } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" + }, + "EpiphanyRetrievalState": { + "properties": { + "dirty_paths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "index_revision": { + "type": [ + "string", + "null" + ] + }, + "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "last_indexed_at_unix_seconds": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "semantic_available": { + "type": "boolean" + }, + "shards": { + "items": { + "$ref": "#/definitions/v2/EpiphanyRetrievalShardSummary" + }, + "type": "array" + }, + "status": { + "allOf": [ + { + "$ref": "#/definitions/v2/EpiphanyRetrievalStatus" + } + ], + "default": "unavailable" + }, + "workspace_root": { + "type": "string" + } + }, + "required": [ + "workspace_root" + ], + "type": "object" + }, + "EpiphanyRetrievalStatus": { + "enum": [ + "unavailable", + "ready", + "stale", + "indexing" + ], + "type": "string" + }, + "EpiphanyRoadmapStream": { + "properties": { + "blocked_by": { + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "item_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "near_term_focus": { + "type": [ + "string", + "null" + ] + }, + "purpose": { + "type": "string" + }, + "review_cadence": { + "type": [ + "string", + "null" + ] + }, + "status": { + "type": "string" + }, + "title": { + "type": "string" + } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" + }, + "EpiphanyRuntimeLink": { + "properties": { + "authority_scope": { + "type": "string" + }, + "binding_id": { + "type": "string" + }, + "id": { + "type": "string" + }, + "linked_graph_node_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "linked_subgoal_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "role_id": { + "type": "string" + }, + "runtime_job_id": { + "type": "string" + }, + "runtime_result_id": { + "type": [ + "string", + "null" + ] + }, + "surface": { + "type": "string" + } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" + }, + "EpiphanyScratchPad": { + "properties": { + "hypothesis": { + "type": [ + "string", + "null" + ] + }, + "next_probe": { + "type": [ + "string", + "null" + ] + }, + "notes": { + "items": { + "type": "string" + }, + "type": "array" + }, + "summary": { + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "EpiphanySubgoal": { + "properties": { + "id": { + "type": "string" + }, + "status": { + "type": "string" + }, + "summary": { + "type": [ + "string", + "null" + ] + }, + "title": { + "type": "string" + } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" + }, + "EpiphanyThreadState": { + "properties": { + "acceptance_receipts": { + "items": { + "$ref": "#/definitions/v2/EpiphanyAcceptanceReceipt" + }, + "type": "array" + }, + "active_subgoal_id": { + "type": [ + "string", + "null" + ] + }, + "churn": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyChurnState" + }, + { + "type": "null" + } + ] + }, + "graph_checkpoint": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyGraphCheckpoint" + }, + { + "type": "null" + } + ] + }, + "graph_frontier": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyGraphFrontier" + }, + { + "type": "null" + } + ] + }, + "graphs": { + "$ref": "#/definitions/v2/EpiphanyGraphs" + }, + "invariants": { + "items": { + "$ref": "#/definitions/v2/EpiphanyInvariant" + }, + "type": "array" + }, + "investigation_checkpoint": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyInvestigationCheckpoint" + }, + { + "type": "null" + } + ] + }, + "job_bindings": { + "items": { + "$ref": "#/definitions/v2/EpiphanyJobBinding" + }, + "type": "array" + }, + "last_updated_turn_id": { + "type": [ + "string", + "null" + ] + }, + "mode": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyModeState" + }, + { + "type": "null" + } + ] + }, + "objective": { + "type": [ + "string", + "null" + ] + }, + "observations": { + "items": { + "$ref": "#/definitions/v2/EpiphanyObservation" + }, + "type": "array" + }, + "planning": { + "$ref": "#/definitions/v2/EpiphanyPlanningState" + }, + "recent_evidence": { + "items": { + "$ref": "#/definitions/v2/EpiphanyEvidenceRecord" + }, + "type": "array" + }, + "retrieval": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyRetrievalState" + }, + { + "type": "null" + } + ] + }, + "revision": { + "format": "uint64", + "minimum": 0.0, + "type": "integer" + }, + "runtime_links": { + "items": { + "$ref": "#/definitions/v2/EpiphanyRuntimeLink" + }, + "type": "array" + }, + "scratch": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyScratchPad" + }, + { + "type": "null" + } + ] + }, + "subgoals": { + "items": { + "$ref": "#/definitions/v2/EpiphanySubgoal" + }, + "type": "array" + } + }, + "required": [ + "revision" + ], + "type": "object" + }, + "ErrorNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "error": { + "$ref": "#/definitions/v2/TurnError" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + }, + "willRetry": { + "type": "boolean" + } + }, + "required": [ + "error", + "threadId", + "turnId", + "willRetry" + ], + "title": "ErrorNotification", + "type": "object" + }, + "ExperimentalFeature": { + "properties": { + "announcement": { + "description": "Announcement copy shown to users when the feature is introduced. Null when this feature is not in beta.", + "type": [ + "string", + "null" + ] + }, + "defaultEnabled": { + "description": "Whether this feature is enabled by default.", + "type": "boolean" + }, + "description": { + "description": "Short summary describing what the feature does. Null when this feature is not in beta.", + "type": [ + "string", + "null" + ] + }, + "displayName": { + "description": "User-facing display name shown in the experimental features UI. Null when this feature is not in beta.", + "type": [ + "string", + "null" + ] + }, + "enabled": { + "description": "Whether this feature is currently enabled in the loaded config.", + "type": "boolean" + }, + "name": { + "description": "Stable key used in config.toml and CLI flag toggles.", + "type": "string" + }, + "stage": { + "allOf": [ + { + "$ref": "#/definitions/v2/ExperimentalFeatureStage" + } + ], + "description": "Lifecycle stage of this feature flag." + } + }, + "required": [ + "defaultEnabled", + "enabled", + "name", + "stage" + ], + "type": "object" + }, + "ExperimentalFeatureEnablementSetParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "enablement": { + "additionalProperties": { + "type": "boolean" + }, + "description": "Process-wide runtime feature enablement keyed by canonical feature name.\n\nOnly named features are updated. Omitted features are left unchanged. Send an empty map for a no-op.", + "type": "object" + } + }, + "required": [ + "enablement" + ], + "title": "ExperimentalFeatureEnablementSetParams", + "type": "object" + }, + "ExperimentalFeatureEnablementSetResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "enablement": { + "additionalProperties": { + "type": "boolean" + }, + "description": "Feature enablement entries updated by this request.", + "type": "object" + } + }, + "required": [ + "enablement" + ], + "title": "ExperimentalFeatureEnablementSetResponse", + "type": "object" + }, + "ExperimentalFeatureListParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cursor": { + "description": "Opaque pagination cursor returned by a previous call.", + "type": [ + "string", + "null" + ] + }, + "limit": { + "description": "Optional page size; defaults to a reasonable server-side value.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "title": "ExperimentalFeatureListParams", + "type": "object" + }, + "ExperimentalFeatureListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "data": { + "items": { + "$ref": "#/definitions/v2/ExperimentalFeature" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ExperimentalFeatureListResponse", + "type": "object" + }, + "ExperimentalFeatureStage": { + "oneOf": [ + { + "description": "Feature is available for user testing and feedback.", + "enum": [ + "beta" + ], + "type": "string" + }, + { + "description": "Feature is still being built and not ready for broad use.", + "enum": [ + "underDevelopment" + ], + "type": "string" + }, + { + "description": "Feature is production-ready.", + "enum": [ + "stable" + ], + "type": "string" + }, + { + "description": "Feature is deprecated and should be avoided.", + "enum": [ + "deprecated" + ], + "type": "string" + }, + { + "description": "Feature flag is retained only for backwards compatibility.", + "enum": [ + "removed" + ], + "type": "string" + } + ] + }, + "FeedbackUploadParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "classification": { + "type": "string" + }, + "extraLogFiles": { + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "includeLogs": { + "type": "boolean" + }, + "reason": { + "type": [ + "string", + "null" + ] + }, + "tags": { + "additionalProperties": { + "type": "string" + }, + "type": [ + "object", + "null" + ] + }, + "threadId": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "classification", + "includeLogs" + ], + "title": "FeedbackUploadParams", + "type": "object" + }, + "FeedbackUploadResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "FeedbackUploadResponse", + "type": "object" + }, + "FileChangeOutputDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "FileChangeOutputDeltaNotification", + "type": "object" + }, + "FileChangePatchUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "changes": { + "items": { + "$ref": "#/definitions/v2/FileUpdateChange" + }, + "type": "array" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "changes", + "itemId", + "threadId", + "turnId" + ], + "title": "FileChangePatchUpdatedNotification", + "type": "object" + }, + "FileSystemAccessMode": { + "enum": [ + "read", + "write", + "none" + ], + "type": "string" + }, + "FileSystemPath": { + "oneOf": [ + { + "properties": { + "path": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "type": { + "enum": [ + "path" + ], + "title": "PathFileSystemPathType", + "type": "string" + } + }, + "required": [ + "path", + "type" + ], + "title": "PathFileSystemPath", + "type": "object" + }, + { + "properties": { + "pattern": { + "type": "string" + }, + "type": { + "enum": [ + "glob_pattern" + ], + "title": "GlobPatternFileSystemPathType", + "type": "string" + } + }, + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "special" + ], + "title": "SpecialFileSystemPathType", + "type": "string" + }, + "value": { + "$ref": "#/definitions/v2/FileSystemSpecialPath" + } + }, + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" + } + ] + }, + "FileSystemSandboxEntry": { + "properties": { + "access": { + "$ref": "#/definitions/v2/FileSystemAccessMode" + }, + "path": { + "$ref": "#/definitions/v2/FileSystemPath" + } + }, + "required": [ + "access", + "path" + ], + "type": "object" + }, + "FileSystemSpecialPath": { + "oneOf": [ + { + "properties": { + "kind": { + "enum": [ + "root" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "minimal" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "current_working_directory" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "project_roots" + ], + "type": "string" + }, + "subpath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind" + ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "tmpdir" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "unknown" + ], + "type": "string" + }, + "path": { + "type": "string" + }, + "subpath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind", + "path" + ], + "type": "object" + } + ] + }, + "FileUpdateChange": { + "properties": { + "diff": { + "type": "string" + }, + "kind": { + "$ref": "#/definitions/v2/PatchChangeKind" + }, + "path": { + "type": "string" + } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" + }, "ForcedLoginMethod": { - "type": "string", "enum": [ "chatgpt", "api" + ], + "type": "string" + }, + "FsChangedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Filesystem watch notification emitted for `fs/watch` subscribers.", + "properties": { + "changedPaths": { + "description": "File or directory paths associated with this event.", + "items": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "type": "array" + }, + "watchId": { + "description": "Watch identifier previously provided to `fs/watch`.", + "type": "string" + } + }, + "required": [ + "changedPaths", + "watchId" + ], + "title": "FsChangedNotification", + "type": "object" + }, + "FsCopyParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Copy a file or directory tree on the host filesystem.", + "properties": { + "destinationPath": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Absolute destination path." + }, + "recursive": { + "description": "Required for directory copies; ignored for file copies.", + "type": "boolean" + }, + "sourcePath": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Absolute source path." + } + }, + "required": [ + "destinationPath", + "sourcePath" + ], + "title": "FsCopyParams", + "type": "object" + }, + "FsCopyResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Successful response for `fs/copy`.", + "title": "FsCopyResponse", + "type": "object" + }, + "FsCreateDirectoryParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Create a directory on the host filesystem.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Absolute directory path to create." + }, + "recursive": { + "description": "Whether parent directories should also be created. Defaults to `true`.", + "type": [ + "boolean", + "null" + ] + } + }, + "required": [ + "path" + ], + "title": "FsCreateDirectoryParams", + "type": "object" + }, + "FsCreateDirectoryResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Successful response for `fs/createDirectory`.", + "title": "FsCreateDirectoryResponse", + "type": "object" + }, + "FsGetMetadataParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Request metadata for an absolute path.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Absolute path to inspect." + } + }, + "required": [ + "path" + ], + "title": "FsGetMetadataParams", + "type": "object" + }, + "FsGetMetadataResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Metadata returned by `fs/getMetadata`.", + "properties": { + "createdAtMs": { + "description": "File creation time in Unix milliseconds when available, otherwise `0`.", + "format": "int64", + "type": "integer" + }, + "isDirectory": { + "description": "Whether the path resolves to a directory.", + "type": "boolean" + }, + "isFile": { + "description": "Whether the path resolves to a regular file.", + "type": "boolean" + }, + "isSymlink": { + "description": "Whether the path itself is a symbolic link.", + "type": "boolean" + }, + "modifiedAtMs": { + "description": "File modification time in Unix milliseconds when available, otherwise `0`.", + "format": "int64", + "type": "integer" + } + }, + "required": [ + "createdAtMs", + "isDirectory", + "isFile", + "isSymlink", + "modifiedAtMs" + ], + "title": "FsGetMetadataResponse", + "type": "object" + }, + "FsReadDirectoryEntry": { + "description": "A directory entry returned by `fs/readDirectory`.", + "properties": { + "fileName": { + "description": "Direct child entry name only, not an absolute or relative path.", + "type": "string" + }, + "isDirectory": { + "description": "Whether this entry resolves to a directory.", + "type": "boolean" + }, + "isFile": { + "description": "Whether this entry resolves to a regular file.", + "type": "boolean" + } + }, + "required": [ + "fileName", + "isDirectory", + "isFile" + ], + "type": "object" + }, + "FsReadDirectoryParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "List direct child names for a directory.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Absolute directory path to read." + } + }, + "required": [ + "path" + ], + "title": "FsReadDirectoryParams", + "type": "object" + }, + "FsReadDirectoryResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Directory entries returned by `fs/readDirectory`.", + "properties": { + "entries": { + "description": "Direct child entries in the requested directory.", + "items": { + "$ref": "#/definitions/v2/FsReadDirectoryEntry" + }, + "type": "array" + } + }, + "required": [ + "entries" + ], + "title": "FsReadDirectoryResponse", + "type": "object" + }, + "FsReadFileParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Read a file from the host filesystem.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Absolute path to read." + } + }, + "required": [ + "path" + ], + "title": "FsReadFileParams", + "type": "object" + }, + "FsReadFileResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Base64-encoded file contents returned by `fs/readFile`.", + "properties": { + "dataBase64": { + "description": "File contents encoded as base64.", + "type": "string" + } + }, + "required": [ + "dataBase64" + ], + "title": "FsReadFileResponse", + "type": "object" + }, + "FsRemoveParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Remove a file or directory tree from the host filesystem.", + "properties": { + "force": { + "description": "Whether missing paths should be ignored. Defaults to `true`.", + "type": [ + "boolean", + "null" + ] + }, + "path": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Absolute path to remove." + }, + "recursive": { + "description": "Whether directory removal should recurse. Defaults to `true`.", + "type": [ + "boolean", + "null" + ] + } + }, + "required": [ + "path" + ], + "title": "FsRemoveParams", + "type": "object" + }, + "FsRemoveResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Successful response for `fs/remove`.", + "title": "FsRemoveResponse", + "type": "object" + }, + "FsUnwatchParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Stop filesystem watch notifications for a prior `fs/watch`.", + "properties": { + "watchId": { + "description": "Watch identifier previously provided to `fs/watch`.", + "type": "string" + } + }, + "required": [ + "watchId" + ], + "title": "FsUnwatchParams", + "type": "object" + }, + "FsUnwatchResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Successful response for `fs/unwatch`.", + "title": "FsUnwatchResponse", + "type": "object" + }, + "FsWatchParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Start filesystem watch notifications for an absolute path.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Absolute file or directory path to watch." + }, + "watchId": { + "description": "Connection-scoped watch identifier used for `fs/unwatch` and `fs/changed`.", + "type": "string" + } + }, + "required": [ + "path", + "watchId" + ], + "title": "FsWatchParams", + "type": "object" + }, + "FsWatchResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Successful response for `fs/watch`.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Canonicalized path associated with the watch." + } + }, + "required": [ + "path" + ], + "title": "FsWatchResponse", + "type": "object" + }, + "FsWriteFileParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Write a file on the host filesystem.", + "properties": { + "dataBase64": { + "description": "File contents encoded as base64.", + "type": "string" + }, + "path": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Absolute path to write." + } + }, + "required": [ + "dataBase64", + "path" + ], + "title": "FsWriteFileParams", + "type": "object" + }, + "FsWriteFileResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Successful response for `fs/writeFile`.", + "title": "FsWriteFileResponse", + "type": "object" + }, + "FunctionCallOutputBody": { + "anyOf": [ + { + "type": "string" + }, + { + "items": { + "$ref": "#/definitions/v2/FunctionCallOutputContentItem" + }, + "type": "array" + } ] }, + "FunctionCallOutputContentItem": { + "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.", + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "input_text" + ], + "title": "InputTextFunctionCallOutputContentItemType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "InputTextFunctionCallOutputContentItem", + "type": "object" + }, + { + "properties": { + "detail": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ImageDetail" + }, + { + "type": "null" + } + ] + }, + "image_url": { + "type": "string" + }, + "type": { + "enum": [ + "input_image" + ], + "title": "InputImageFunctionCallOutputContentItemType", + "type": "string" + } + }, + "required": [ + "image_url", + "type" + ], + "title": "InputImageFunctionCallOutputContentItem", + "type": "object" + } + ] + }, + "GetAccountParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "refreshToken": { + "default": false, + "description": "When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.", + "type": "boolean" + } + }, + "title": "GetAccountParams", + "type": "object" + }, + "GetAccountRateLimitsResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "rateLimits": { + "allOf": [ + { + "$ref": "#/definitions/v2/RateLimitSnapshot" + } + ], + "description": "Backward-compatible single-bucket view; mirrors the historical payload." + }, + "rateLimitsByLimitId": { + "additionalProperties": { + "$ref": "#/definitions/v2/RateLimitSnapshot" + }, + "description": "Multi-bucket view keyed by metered `limit_id` (for example, `codex`).", + "type": [ + "object", + "null" + ] + } + }, + "required": [ + "rateLimits" + ], + "title": "GetAccountRateLimitsResponse", + "type": "object" + }, + "GetAccountResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "account": { + "anyOf": [ + { + "$ref": "#/definitions/v2/Account" + }, + { + "type": "null" + } + ] + }, + "requiresOpenaiAuth": { + "type": "boolean" + } + }, + "required": [ + "requiresOpenaiAuth" + ], + "title": "GetAccountResponse", + "type": "object" + }, + "GhostCommit": { + "description": "Details of a ghost commit created from a repository state.", + "properties": { + "id": { + "type": "string" + }, + "parent": { + "type": [ + "string", + "null" + ] + }, + "preexisting_untracked_dirs": { + "items": { + "type": "string" + }, + "type": "array" + }, + "preexisting_untracked_files": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "id", + "preexisting_untracked_dirs", + "preexisting_untracked_files" + ], + "type": "object" + }, + "GitInfo": { + "properties": { + "branch": { + "type": [ + "string", + "null" + ] + }, + "originUrl": { + "type": [ + "string", + "null" + ] + }, + "sha": { + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "GuardianApprovalReview": { + "description": "[UNSTABLE] Temporary approval auto-review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.", + "properties": { + "rationale": { + "type": [ + "string", + "null" + ] + }, + "riskLevel": { + "anyOf": [ + { + "$ref": "#/definitions/v2/GuardianRiskLevel" + }, + { + "type": "null" + } + ] + }, + "status": { + "$ref": "#/definitions/v2/GuardianApprovalReviewStatus" + }, + "userAuthorization": { + "anyOf": [ + { + "$ref": "#/definitions/v2/GuardianUserAuthorization" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "status" + ], + "type": "object" + }, + "GuardianApprovalReviewAction": { + "oneOf": [ + { + "properties": { + "command": { + "type": "string" + }, + "cwd": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "source": { + "$ref": "#/definitions/v2/GuardianCommandSource" + }, + "type": { + "enum": [ + "command" + ], + "title": "CommandGuardianApprovalReviewActionType", + "type": "string" + } + }, + "required": [ + "command", + "cwd", + "source", + "type" + ], + "title": "CommandGuardianApprovalReviewAction", + "type": "object" + }, + { + "properties": { + "argv": { + "items": { + "type": "string" + }, + "type": "array" + }, + "cwd": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "program": { + "type": "string" + }, + "source": { + "$ref": "#/definitions/v2/GuardianCommandSource" + }, + "type": { + "enum": [ + "execve" + ], + "title": "ExecveGuardianApprovalReviewActionType", + "type": "string" + } + }, + "required": [ + "argv", + "cwd", + "program", + "source", + "type" + ], + "title": "ExecveGuardianApprovalReviewAction", + "type": "object" + }, + { + "properties": { + "cwd": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "files": { + "items": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "type": "array" + }, + "type": { + "enum": [ + "applyPatch" + ], + "title": "ApplyPatchGuardianApprovalReviewActionType", + "type": "string" + } + }, + "required": [ + "cwd", + "files", + "type" + ], + "title": "ApplyPatchGuardianApprovalReviewAction", + "type": "object" + }, + { + "properties": { + "host": { + "type": "string" + }, + "port": { + "format": "uint16", + "minimum": 0.0, + "type": "integer" + }, + "protocol": { + "$ref": "#/definitions/v2/NetworkApprovalProtocol" + }, + "target": { + "type": "string" + }, + "type": { + "enum": [ + "networkAccess" + ], + "title": "NetworkAccessGuardianApprovalReviewActionType", + "type": "string" + } + }, + "required": [ + "host", + "port", + "protocol", + "target", + "type" + ], + "title": "NetworkAccessGuardianApprovalReviewAction", + "type": "object" + }, + { + "properties": { + "connectorId": { + "type": [ + "string", + "null" + ] + }, + "connectorName": { + "type": [ + "string", + "null" + ] + }, + "server": { + "type": "string" + }, + "toolName": { + "type": "string" + }, + "toolTitle": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "mcpToolCall" + ], + "title": "McpToolCallGuardianApprovalReviewActionType", + "type": "string" + } + }, + "required": [ + "server", + "toolName", + "type" + ], + "title": "McpToolCallGuardianApprovalReviewAction", + "type": "object" + }, + { + "properties": { + "permissions": { + "$ref": "#/definitions/v2/RequestPermissionProfile" + }, + "reason": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "requestPermissions" + ], + "title": "RequestPermissionsGuardianApprovalReviewActionType", + "type": "string" + } + }, + "required": [ + "permissions", + "type" + ], + "title": "RequestPermissionsGuardianApprovalReviewAction", + "type": "object" + } + ] + }, + "GuardianApprovalReviewStatus": { + "description": "[UNSTABLE] Lifecycle state for an approval auto-review.", + "enum": [ + "inProgress", + "approved", + "denied", + "timedOut", + "aborted" + ], + "type": "string" + }, + "GuardianCommandSource": { + "enum": [ + "shell", + "unifiedExec" + ], + "type": "string" + }, + "GuardianRiskLevel": { + "description": "[UNSTABLE] Risk level assigned by approval auto-review.", + "enum": [ + "low", + "medium", + "high", + "critical" + ], + "type": "string" + }, + "GuardianUserAuthorization": { + "description": "[UNSTABLE] Authorization level assigned by approval auto-review.", + "enum": [ + "unknown", + "low", + "medium", + "high" + ], + "type": "string" + }, + "GuardianWarningNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "message": { + "description": "Concise guardian warning message for the user.", + "type": "string" + }, + "threadId": { + "description": "Thread target for the guardian warning.", + "type": "string" + } + }, + "required": [ + "message", + "threadId" + ], + "title": "GuardianWarningNotification", + "type": "object" + }, + "HookCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "run": { + "$ref": "#/definitions/v2/HookRunSummary" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "run", + "threadId" + ], + "title": "HookCompletedNotification", + "type": "object" + }, + "HookEventName": { + "enum": [ + "preToolUse", + "permissionRequest", + "postToolUse", + "sessionStart", + "userPromptSubmit", + "stop" + ], + "type": "string" + }, + "HookExecutionMode": { + "enum": [ + "sync", + "async" + ], + "type": "string" + }, + "HookHandlerType": { + "enum": [ + "command", + "prompt", + "agent" + ], + "type": "string" + }, + "HookOutputEntry": { + "properties": { + "kind": { + "$ref": "#/definitions/v2/HookOutputEntryKind" + }, + "text": { + "type": "string" + } + }, + "required": [ + "kind", + "text" + ], + "type": "object" + }, + "HookOutputEntryKind": { + "enum": [ + "warning", + "stop", + "feedback", + "context", + "error" + ], + "type": "string" + }, + "HookPromptFragment": { + "properties": { + "hookRunId": { + "type": "string" + }, + "text": { + "type": "string" + } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" + }, + "HookRunStatus": { + "enum": [ + "running", + "completed", + "failed", + "blocked", + "stopped" + ], + "type": "string" + }, + "HookRunSummary": { + "properties": { + "completedAt": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "displayOrder": { + "format": "int64", + "type": "integer" + }, + "durationMs": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "entries": { + "items": { + "$ref": "#/definitions/v2/HookOutputEntry" + }, + "type": "array" + }, + "eventName": { + "$ref": "#/definitions/v2/HookEventName" + }, + "executionMode": { + "$ref": "#/definitions/v2/HookExecutionMode" + }, + "handlerType": { + "$ref": "#/definitions/v2/HookHandlerType" + }, + "id": { + "type": "string" + }, + "scope": { + "$ref": "#/definitions/v2/HookScope" + }, + "source": { + "allOf": [ + { + "$ref": "#/definitions/v2/HookSource" + } + ], + "default": "unknown" + }, + "sourcePath": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "startedAt": { + "format": "int64", + "type": "integer" + }, + "status": { + "$ref": "#/definitions/v2/HookRunStatus" + }, + "statusMessage": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "displayOrder", + "entries", + "eventName", + "executionMode", + "handlerType", + "id", + "scope", + "sourcePath", + "startedAt", + "status" + ], + "type": "object" + }, + "HookScope": { + "enum": [ + "thread", + "turn" + ], + "type": "string" + }, + "HookSource": { + "enum": [ + "system", + "user", + "project", + "mdm", + "sessionFlags", + "legacyManagedConfigFile", + "legacyManagedConfigMdm", + "unknown" + ], + "type": "string" + }, + "HookStartedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "run": { + "$ref": "#/definitions/v2/HookRunSummary" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "run", + "threadId" + ], + "title": "HookStartedNotification", + "type": "object" + }, + "ImageDetail": { + "enum": [ + "auto", + "low", + "high", + "original" + ], + "type": "string" + }, + "InputModality": { + "description": "Canonical user-input modality tags advertised by a model.", + "oneOf": [ + { + "description": "Plain text turns and tool payloads.", + "enum": [ + "text" + ], + "type": "string" + }, + { + "description": "Image attachments included in user turns.", + "enum": [ + "image" + ], + "type": "string" + } + ] + }, + "ItemCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "item": { + "$ref": "#/definitions/v2/ThreadItem" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "item", + "threadId", + "turnId" + ], + "title": "ItemCompletedNotification", + "type": "object" + }, + "ItemGuardianApprovalReviewCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", + "properties": { + "action": { + "$ref": "#/definitions/v2/GuardianApprovalReviewAction" + }, + "decisionSource": { + "$ref": "#/definitions/v2/AutoReviewDecisionSource" + }, + "review": { + "$ref": "#/definitions/v2/GuardianApprovalReview" + }, + "reviewId": { + "description": "Stable identifier for this review.", + "type": "string" + }, + "targetItemId": { + "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", + "type": [ + "string", + "null" + ] + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "action", + "decisionSource", + "review", + "reviewId", + "threadId", + "turnId" + ], + "title": "ItemGuardianApprovalReviewCompletedNotification", + "type": "object" + }, + "ItemGuardianApprovalReviewStartedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", + "properties": { + "action": { + "$ref": "#/definitions/v2/GuardianApprovalReviewAction" + }, + "review": { + "$ref": "#/definitions/v2/GuardianApprovalReview" + }, + "reviewId": { + "description": "Stable identifier for this review.", + "type": "string" + }, + "targetItemId": { + "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", + "type": [ + "string", + "null" + ] + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "action", + "review", + "reviewId", + "threadId", + "turnId" + ], + "title": "ItemGuardianApprovalReviewStartedNotification", + "type": "object" + }, + "ItemStartedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "item": { + "$ref": "#/definitions/v2/ThreadItem" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "item", + "threadId", + "turnId" + ], + "title": "ItemStartedNotification", + "type": "object" + }, + "ListMcpServerStatusParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cursor": { + "description": "Opaque pagination cursor returned by a previous call.", + "type": [ + "string", + "null" + ] + }, + "detail": { + "anyOf": [ + { + "$ref": "#/definitions/v2/McpServerStatusDetail" + }, + { + "type": "null" + } + ], + "description": "Controls how much MCP inventory data to fetch for each server. Defaults to `Full` when omitted." + }, + "limit": { + "description": "Optional page size; defaults to a server-defined value.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "title": "ListMcpServerStatusParams", + "type": "object" + }, + "ListMcpServerStatusResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "data": { + "items": { + "$ref": "#/definitions/v2/McpServerStatus" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ListMcpServerStatusResponse", + "type": "object" + }, + "LocalShellAction": { + "oneOf": [ + { + "properties": { + "command": { + "items": { + "type": "string" + }, + "type": "array" + }, + "env": { + "additionalProperties": { + "type": "string" + }, + "type": [ + "object", + "null" + ] + }, + "timeout_ms": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "type": { + "enum": [ + "exec" + ], + "title": "ExecLocalShellActionType", + "type": "string" + }, + "user": { + "type": [ + "string", + "null" + ] + }, + "working_directory": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "command", + "type" + ], + "title": "ExecLocalShellAction", + "type": "object" + } + ] + }, + "LocalShellStatus": { + "enum": [ + "completed", + "in_progress", + "incomplete" + ], + "type": "string" + }, + "LoginAccountParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "oneOf": [ + { + "properties": { + "apiKey": { + "type": "string" + }, + "type": { + "enum": [ + "apiKey" + ], + "title": "ApiKeyv2::LoginAccountParamsType", + "type": "string" + } + }, + "required": [ + "apiKey", + "type" + ], + "title": "ApiKeyv2::LoginAccountParams", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "chatgpt" + ], + "title": "Chatgptv2::LoginAccountParamsType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "Chatgptv2::LoginAccountParams", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "chatgptDeviceCode" + ], + "title": "ChatgptDeviceCodev2::LoginAccountParamsType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ChatgptDeviceCodev2::LoginAccountParams", + "type": "object" + }, + { + "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE. The access token must contain the same scopes that Codex-managed ChatGPT auth tokens have.", + "properties": { + "accessToken": { + "description": "Access token (JWT) supplied by the client. This token is used for backend API requests and email extraction.", + "type": "string" + }, + "chatgptAccountId": { + "description": "Workspace/account identifier supplied by the client.", + "type": "string" + }, + "chatgptPlanType": { + "description": "Optional plan type supplied by the client.\n\nWhen `null`, Codex attempts to derive the plan type from access-token claims. If unavailable, the plan defaults to `unknown`.", + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "chatgptAuthTokens" + ], + "title": "ChatgptAuthTokensv2::LoginAccountParamsType", + "type": "string" + } + }, + "required": [ + "accessToken", + "chatgptAccountId", + "type" + ], + "title": "ChatgptAuthTokensv2::LoginAccountParams", + "type": "object" + } + ], + "title": "LoginAccountParams" + }, + "LoginAccountResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "apiKey" + ], + "title": "ApiKeyv2::LoginAccountResponseType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ApiKeyv2::LoginAccountResponse", + "type": "object" + }, + { + "properties": { + "authUrl": { + "description": "URL the client should open in a browser to initiate the OAuth flow.", + "type": "string" + }, + "loginId": { + "type": "string" + }, + "type": { + "enum": [ + "chatgpt" + ], + "title": "Chatgptv2::LoginAccountResponseType", + "type": "string" + } + }, + "required": [ + "authUrl", + "loginId", + "type" + ], + "title": "Chatgptv2::LoginAccountResponse", + "type": "object" + }, + { + "properties": { + "loginId": { + "type": "string" + }, + "type": { + "enum": [ + "chatgptDeviceCode" + ], + "title": "ChatgptDeviceCodev2::LoginAccountResponseType", + "type": "string" + }, + "userCode": { + "description": "One-time code the user must enter after signing in.", + "type": "string" + }, + "verificationUrl": { + "description": "URL the client should open in a browser to complete device code authorization.", + "type": "string" + } + }, + "required": [ + "loginId", + "type", + "userCode", + "verificationUrl" + ], + "title": "ChatgptDeviceCodev2::LoginAccountResponse", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "chatgptAuthTokens" + ], + "title": "ChatgptAuthTokensv2::LoginAccountResponseType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ChatgptAuthTokensv2::LoginAccountResponse", + "type": "object" + } + ], + "title": "LoginAccountResponse" + }, + "LogoutAccountResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "LogoutAccountResponse", + "type": "object" + }, + "McpAuthStatus": { + "enum": [ + "unsupported", + "notLoggedIn", + "bearerToken", + "oAuth" + ], + "type": "string" + }, + "McpResourceReadParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "server": { + "type": "string" + }, + "threadId": { + "type": [ + "string", + "null" + ] + }, + "uri": { + "type": "string" + } + }, + "required": [ + "server", + "uri" + ], + "title": "McpResourceReadParams", + "type": "object" + }, + "McpResourceReadResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "contents": { + "items": { + "$ref": "#/definitions/v2/ResourceContent" + }, + "type": "array" + } + }, + "required": [ + "contents" + ], + "title": "McpResourceReadResponse", + "type": "object" + }, + "McpServerOauthLoginCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "error": { + "type": [ + "string", + "null" + ] + }, + "name": { + "type": "string" + }, + "success": { + "type": "boolean" + } + }, + "required": [ + "name", + "success" + ], + "title": "McpServerOauthLoginCompletedNotification", + "type": "object" + }, + "McpServerOauthLoginParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "name": { + "type": "string" + }, + "scopes": { + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "timeoutSecs": { + "format": "int64", + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "name" + ], + "title": "McpServerOauthLoginParams", + "type": "object" + }, + "McpServerOauthLoginResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "authorizationUrl": { + "type": "string" + } + }, + "required": [ + "authorizationUrl" + ], + "title": "McpServerOauthLoginResponse", + "type": "object" + }, + "McpServerRefreshResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "McpServerRefreshResponse", + "type": "object" + }, + "McpServerStartupState": { + "enum": [ + "starting", + "ready", + "failed", + "cancelled" + ], + "type": "string" + }, + "McpServerStatus": { + "properties": { + "authStatus": { + "$ref": "#/definitions/v2/McpAuthStatus" + }, + "name": { + "type": "string" + }, + "resourceTemplates": { + "items": { + "$ref": "#/definitions/v2/ResourceTemplate" + }, + "type": "array" + }, + "resources": { + "items": { + "$ref": "#/definitions/v2/Resource" + }, + "type": "array" + }, + "tools": { + "additionalProperties": { + "$ref": "#/definitions/v2/Tool" + }, + "type": "object" + } + }, + "required": [ + "authStatus", + "name", + "resourceTemplates", + "resources", + "tools" + ], + "type": "object" + }, + "McpServerStatusDetail": { + "enum": [ + "full", + "toolsAndAuthOnly" + ], + "type": "string" + }, + "McpServerStatusUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "error": { + "type": [ + "string", + "null" + ] + }, + "name": { + "type": "string" + }, + "status": { + "$ref": "#/definitions/v2/McpServerStartupState" + } + }, + "required": [ + "name", + "status" + ], + "title": "McpServerStatusUpdatedNotification", + "type": "object" + }, + "McpServerToolCallParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "_meta": true, + "arguments": true, + "server": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "tool": { + "type": "string" + } + }, + "required": [ + "server", + "threadId", + "tool" + ], + "title": "McpServerToolCallParams", + "type": "object" + }, + "McpServerToolCallResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "_meta": true, + "content": { + "items": true, + "type": "array" + }, + "isError": { + "type": [ + "boolean", + "null" + ] + }, + "structuredContent": true + }, + "required": [ + "content" + ], + "title": "McpServerToolCallResponse", + "type": "object" + }, + "McpToolCallError": { + "properties": { + "message": { + "type": "string" + } + }, + "required": [ + "message" + ], + "type": "object" + }, + "McpToolCallProgressNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "itemId": { + "type": "string" + }, + "message": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "itemId", + "message", + "threadId", + "turnId" + ], + "title": "McpToolCallProgressNotification", + "type": "object" + }, + "McpToolCallResult": { + "properties": { + "_meta": true, + "content": { + "items": true, + "type": "array" + }, + "structuredContent": true + }, + "required": [ + "content" + ], + "type": "object" + }, + "McpToolCallStatus": { + "enum": [ + "inProgress", + "completed", + "failed" + ], + "type": "string" + }, + "MemoryCitation": { + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/v2/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "entries", + "threadIds" + ], + "type": "object" + }, + "MemoryCitationEntry": { + "properties": { + "lineEnd": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "lineStart": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "note": { + "type": "string" + }, + "path": { + "type": "string" + } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" + }, + "MergeStrategy": { + "enum": [ + "replace", + "upsert" + ], + "type": "string" + }, + "MessagePhase": { + "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", + "oneOf": [ + { + "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", + "enum": [ + "commentary" + ], + "type": "string" + }, + { + "description": "The assistant's terminal answer text for the current turn.", + "enum": [ + "final_answer" + ], + "type": "string" + } + ] + }, + "ModeKind": { + "description": "Initial collaboration mode to use when the TUI starts.", + "enum": [ + "plan", + "default" + ], + "type": "string" + }, + "Model": { + "properties": { + "additionalSpeedTiers": { + "default": [], + "items": { + "type": "string" + }, + "type": "array" + }, + "availabilityNux": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ModelAvailabilityNux" + }, + { + "type": "null" + } + ] + }, + "defaultReasoningEffort": { + "$ref": "#/definitions/v2/ReasoningEffort" + }, + "description": { + "type": "string" + }, + "displayName": { + "type": "string" + }, + "hidden": { + "type": "boolean" + }, + "id": { + "type": "string" + }, + "inputModalities": { + "default": [ + "text", + "image" + ], + "items": { + "$ref": "#/definitions/v2/InputModality" + }, + "type": "array" + }, + "isDefault": { + "type": "boolean" + }, + "model": { + "type": "string" + }, + "supportedReasoningEfforts": { + "items": { + "$ref": "#/definitions/v2/ReasoningEffortOption" + }, + "type": "array" + }, + "supportsPersonality": { + "default": false, + "type": "boolean" + }, + "upgrade": { + "type": [ + "string", + "null" + ] + }, + "upgradeInfo": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ModelUpgradeInfo" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "defaultReasoningEffort", + "description", + "displayName", + "hidden", + "id", + "isDefault", + "model", + "supportedReasoningEfforts" + ], + "type": "object" + }, + "ModelAvailabilityNux": { + "properties": { + "message": { + "type": "string" + } + }, + "required": [ + "message" + ], + "type": "object" + }, + "ModelListParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cursor": { + "description": "Opaque pagination cursor returned by a previous call.", + "type": [ + "string", + "null" + ] + }, + "includeHidden": { + "description": "When true, include models that are hidden from the default picker list.", + "type": [ + "boolean", + "null" + ] + }, + "limit": { + "description": "Optional page size; defaults to a reasonable server-side value.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "title": "ModelListParams", + "type": "object" + }, + "ModelListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "data": { + "items": { + "$ref": "#/definitions/v2/Model" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ModelListResponse", + "type": "object" + }, + "ModelRerouteReason": { + "enum": [ + "highRiskCyberActivity" + ], + "type": "string" + }, + "ModelReroutedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "fromModel": { + "type": "string" + }, + "reason": { + "$ref": "#/definitions/v2/ModelRerouteReason" + }, + "threadId": { + "type": "string" + }, + "toModel": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "fromModel", + "reason", + "threadId", + "toModel", + "turnId" + ], + "title": "ModelReroutedNotification", + "type": "object" + }, + "ModelUpgradeInfo": { + "properties": { + "migrationMarkdown": { + "type": [ + "string", + "null" + ] + }, + "model": { + "type": "string" + }, + "modelLink": { + "type": [ + "string", + "null" + ] + }, + "upgradeCopy": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "model" + ], + "type": "object" + }, + "NetworkAccess": { + "enum": [ + "restricted", + "enabled" + ], + "type": "string" + }, + "NetworkApprovalProtocol": { + "enum": [ + "http", + "https", + "socks5Tcp", + "socks5Udp" + ], + "type": "string" + }, + "NetworkDomainPermission": { + "enum": [ + "allow", + "deny" + ], + "type": "string" + }, + "NetworkRequirements": { + "properties": { + "allowLocalBinding": { + "type": [ + "boolean", + "null" + ] + }, + "allowUnixSockets": { + "description": "Legacy compatibility view derived from `unix_sockets`.", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "allowUpstreamProxy": { + "type": [ + "boolean", + "null" + ] + }, + "allowedDomains": { + "description": "Legacy compatibility view derived from `domains`.", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "dangerouslyAllowAllUnixSockets": { + "type": [ + "boolean", + "null" + ] + }, + "dangerouslyAllowNonLoopbackProxy": { + "type": [ + "boolean", + "null" + ] + }, + "deniedDomains": { + "description": "Legacy compatibility view derived from `domains`.", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "domains": { + "additionalProperties": { + "$ref": "#/definitions/v2/NetworkDomainPermission" + }, + "description": "Canonical network permission map for `experimental_network`.", + "type": [ + "object", + "null" + ] + }, + "enabled": { + "type": [ + "boolean", + "null" + ] + }, + "httpPort": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "managedAllowedDomainsOnly": { + "description": "When true, only managed allowlist entries are respected while managed network enforcement is active.", + "type": [ + "boolean", + "null" + ] + }, + "socksPort": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "unixSockets": { + "additionalProperties": { + "$ref": "#/definitions/v2/NetworkUnixSocketPermission" + }, + "description": "Canonical unix socket permission map for `experimental_network`.", + "type": [ + "object", + "null" + ] + } + }, + "type": "object" + }, + "NetworkUnixSocketPermission": { + "enum": [ + "allow", + "none" + ], + "type": "string" + }, + "NonSteerableTurnKind": { + "enum": [ + "review", + "compact" + ], + "type": "string" + }, + "OverriddenMetadata": { + "properties": { + "effectiveValue": true, + "message": { + "type": "string" + }, + "overridingLayer": { + "$ref": "#/definitions/v2/ConfigLayerMetadata" + } + }, + "required": [ + "effectiveValue", + "message", + "overridingLayer" + ], + "type": "object" + }, + "PatchApplyStatus": { + "enum": [ + "inProgress", + "completed", + "failed", + "declined" + ], + "type": "string" + }, + "PatchChangeKind": { + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "add" + ], + "title": "AddPatchChangeKindType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "delete" + ], + "title": "DeletePatchChangeKindType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { + "properties": { + "move_path": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "update" + ], + "title": "UpdatePatchChangeKindType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" + } + ] + }, + "PermissionProfile": { + "properties": { + "fileSystem": { + "anyOf": [ + { + "$ref": "#/definitions/v2/PermissionProfileFileSystemPermissions" + }, + { + "type": "null" + } + ] + }, + "network": { + "anyOf": [ + { + "$ref": "#/definitions/v2/PermissionProfileNetworkPermissions" + }, + { + "type": "null" + } + ] + } + }, + "type": "object" + }, + "PermissionProfileFileSystemPermissions": { + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/v2/FileSystemSandboxEntry" + }, + "type": "array" + }, + "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "entries" + ], + "type": "object" + }, + "PermissionProfileNetworkPermissions": { + "properties": { + "enabled": { + "type": [ + "boolean", + "null" + ] + } + }, + "type": "object" + }, + "Personality": { + "enum": [ + "none", + "friendly", + "pragmatic" + ], + "type": "string" + }, + "PlanDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items. Clients should not assume concatenated deltas match the completed plan item content.", + "properties": { + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "PlanDeltaNotification", + "type": "object" + }, + "PlanType": { + "enum": [ + "free", + "go", + "plus", + "pro", + "prolite", + "team", + "self_serve_business_usage_based", + "business", + "enterprise_cbp_usage_based", + "enterprise", + "edu", + "unknown" + ], + "type": "string" + }, "ProfileV2": { - "type": "object", + "additionalProperties": true, "properties": { "approval_policy": { "anyOf": [ @@ -18183,7 +11591,6 @@ ] }, "approvals_reviewer": { - "description": "[UNSTABLE] Optional profile-level override for where approval requests are routed for review. If omitted, the enclosing config default is used.", "anyOf": [ { "$ref": "#/definitions/v2/ApprovalsReviewer" @@ -18191,7 +11598,8 @@ { "type": "null" } - ] + ], + "description": "[UNSTABLE] Optional profile-level override for where approval requests are routed for review. If omitted, the enclosing config default is used." }, "chatgpt_base_url": { "type": [ @@ -18272,10 +11680,1487 @@ ] } }, - "additionalProperties": true + "type": "object" + }, + "RateLimitReachedType": { + "enum": [ + "rate_limit_reached", + "workspace_owner_credits_depleted", + "workspace_member_credits_depleted", + "workspace_owner_usage_limit_reached", + "workspace_member_usage_limit_reached" + ], + "type": "string" + }, + "RateLimitSnapshot": { + "properties": { + "credits": { + "anyOf": [ + { + "$ref": "#/definitions/v2/CreditsSnapshot" + }, + { + "type": "null" + } + ] + }, + "limitId": { + "type": [ + "string", + "null" + ] + }, + "limitName": { + "type": [ + "string", + "null" + ] + }, + "planType": { + "anyOf": [ + { + "$ref": "#/definitions/v2/PlanType" + }, + { + "type": "null" + } + ] + }, + "primary": { + "anyOf": [ + { + "$ref": "#/definitions/v2/RateLimitWindow" + }, + { + "type": "null" + } + ] + }, + "rateLimitReachedType": { + "anyOf": [ + { + "$ref": "#/definitions/v2/RateLimitReachedType" + }, + { + "type": "null" + } + ] + }, + "secondary": { + "anyOf": [ + { + "$ref": "#/definitions/v2/RateLimitWindow" + }, + { + "type": "null" + } + ] + } + }, + "type": "object" + }, + "RateLimitWindow": { + "properties": { + "resetsAt": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "usedPercent": { + "format": "int32", + "type": "integer" + }, + "windowDurationMins": { + "format": "int64", + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "usedPercent" + ], + "type": "object" + }, + "RawResponseItemCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "item": { + "$ref": "#/definitions/v2/ResponseItem" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "item", + "threadId", + "turnId" + ], + "title": "RawResponseItemCompletedNotification", + "type": "object" + }, + "ReadOnlyAccess": { + "oneOf": [ + { + "properties": { + "includePlatformDefaults": { + "default": true, + "type": "boolean" + }, + "readableRoots": { + "default": [], + "items": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "type": "array" + }, + "type": { + "enum": [ + "restricted" + ], + "title": "RestrictedReadOnlyAccessType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "RestrictedReadOnlyAccess", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "fullAccess" + ], + "title": "FullAccessReadOnlyAccessType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "FullAccessReadOnlyAccess", + "type": "object" + } + ] + }, + "RealtimeConversationVersion": { + "enum": [ + "v1", + "v2" + ], + "type": "string" + }, + "RealtimeOutputModality": { + "enum": [ + "text", + "audio" + ], + "type": "string" + }, + "RealtimeVoice": { + "enum": [ + "alloy", + "arbor", + "ash", + "ballad", + "breeze", + "cedar", + "coral", + "cove", + "echo", + "ember", + "juniper", + "maple", + "marin", + "sage", + "shimmer", + "sol", + "spruce", + "vale", + "verse" + ], + "type": "string" + }, + "RealtimeVoicesList": { + "properties": { + "defaultV1": { + "$ref": "#/definitions/v2/RealtimeVoice" + }, + "defaultV2": { + "$ref": "#/definitions/v2/RealtimeVoice" + }, + "v1": { + "items": { + "$ref": "#/definitions/v2/RealtimeVoice" + }, + "type": "array" + }, + "v2": { + "items": { + "$ref": "#/definitions/v2/RealtimeVoice" + }, + "type": "array" + } + }, + "required": [ + "defaultV1", + "defaultV2", + "v1", + "v2" + ], + "type": "object" + }, + "ReasoningEffort": { + "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "enum": [ + "none", + "minimal", + "low", + "medium", + "high", + "xhigh" + ], + "type": "string" + }, + "ReasoningEffortOption": { + "properties": { + "description": { + "type": "string" + }, + "reasoningEffort": { + "$ref": "#/definitions/v2/ReasoningEffort" + } + }, + "required": [ + "description", + "reasoningEffort" + ], + "type": "object" + }, + "ReasoningItemContent": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "reasoning_text" + ], + "title": "ReasoningTextReasoningItemContentType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "ReasoningTextReasoningItemContent", + "type": "object" + }, + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "text" + ], + "title": "TextReasoningItemContentType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "TextReasoningItemContent", + "type": "object" + } + ] + }, + "ReasoningItemReasoningSummary": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "summary_text" + ], + "title": "SummaryTextReasoningItemReasoningSummaryType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "SummaryTextReasoningItemReasoningSummary", + "type": "object" + } + ] + }, + "ReasoningSummary": { + "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries", + "oneOf": [ + { + "enum": [ + "auto", + "concise", + "detailed" + ], + "type": "string" + }, + { + "description": "Option to disable reasoning summaries.", + "enum": [ + "none" + ], + "type": "string" + } + ] + }, + "ReasoningSummaryPartAddedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "itemId": { + "type": "string" + }, + "summaryIndex": { + "format": "int64", + "type": "integer" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "itemId", + "summaryIndex", + "threadId", + "turnId" + ], + "title": "ReasoningSummaryPartAddedNotification", + "type": "object" + }, + "ReasoningSummaryTextDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "summaryIndex": { + "format": "int64", + "type": "integer" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "delta", + "itemId", + "summaryIndex", + "threadId", + "turnId" + ], + "title": "ReasoningSummaryTextDeltaNotification", + "type": "object" + }, + "ReasoningTextDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "contentIndex": { + "format": "int64", + "type": "integer" + }, + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "contentIndex", + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "ReasoningTextDeltaNotification", + "type": "object" + }, + "RemoteControlClientConnectionAudience": { + "description": "Audience for a remote-control client connection device-key proof.", + "enum": [ + "remote_control_client_websocket" + ], + "type": "string" + }, + "RemoteControlClientEnrollmentAudience": { + "description": "Audience for a remote-control client enrollment device-key proof.", + "enum": [ + "remote_control_client_enrollment" + ], + "type": "string" + }, + "RequestId": { + "anyOf": [ + { + "type": "string" + }, + { + "format": "int64", + "type": "integer" + } + ] + }, + "RequestPermissionProfile": { + "additionalProperties": false, + "properties": { + "fileSystem": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AdditionalFileSystemPermissions" + }, + { + "type": "null" + } + ] + }, + "network": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AdditionalNetworkPermissions" + }, + { + "type": "null" + } + ] + } + }, + "type": "object" + }, + "ResidencyRequirement": { + "enum": [ + "us" + ], + "type": "string" + }, + "Resource": { + "description": "A known resource that the server is capable of reading.", + "properties": { + "_meta": true, + "annotations": true, + "description": { + "type": [ + "string", + "null" + ] + }, + "icons": { + "items": true, + "type": [ + "array", + "null" + ] + }, + "mimeType": { + "type": [ + "string", + "null" + ] + }, + "name": { + "type": "string" + }, + "size": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "uri": { + "type": "string" + } + }, + "required": [ + "name", + "uri" + ], + "type": "object" + }, + "ResourceContent": { + "anyOf": [ + { + "properties": { + "_meta": true, + "mimeType": { + "type": [ + "string", + "null" + ] + }, + "text": { + "type": "string" + }, + "uri": { + "description": "The URI of this resource.", + "type": "string" + } + }, + "required": [ + "text", + "uri" + ], + "type": "object" + }, + { + "properties": { + "_meta": true, + "blob": { + "type": "string" + }, + "mimeType": { + "type": [ + "string", + "null" + ] + }, + "uri": { + "description": "The URI of this resource.", + "type": "string" + } + }, + "required": [ + "blob", + "uri" + ], + "type": "object" + } + ], + "description": "Contents returned when reading a resource from an MCP server." + }, + "ResourceTemplate": { + "description": "A template description for resources available on the server.", + "properties": { + "annotations": true, + "description": { + "type": [ + "string", + "null" + ] + }, + "mimeType": { + "type": [ + "string", + "null" + ] + }, + "name": { + "type": "string" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "uriTemplate": { + "type": "string" + } + }, + "required": [ + "name", + "uriTemplate" + ], + "type": "object" + }, + "ResponseItem": { + "oneOf": [ + { + "properties": { + "content": { + "items": { + "$ref": "#/definitions/v2/ContentItem" + }, + "type": "array" + }, + "end_turn": { + "type": [ + "boolean", + "null" + ] + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "phase": { + "anyOf": [ + { + "$ref": "#/definitions/v2/MessagePhase" + }, + { + "type": "null" + } + ] + }, + "role": { + "type": "string" + }, + "type": { + "enum": [ + "message" + ], + "title": "MessageResponseItemType", + "type": "string" + } + }, + "required": [ + "content", + "role", + "type" + ], + "title": "MessageResponseItem", + "type": "object" + }, + { + "properties": { + "content": { + "default": null, + "items": { + "$ref": "#/definitions/v2/ReasoningItemContent" + }, + "type": [ + "array", + "null" + ] + }, + "encrypted_content": { + "type": [ + "string", + "null" + ] + }, + "summary": { + "items": { + "$ref": "#/definitions/v2/ReasoningItemReasoningSummary" + }, + "type": "array" + }, + "type": { + "enum": [ + "reasoning" + ], + "title": "ReasoningResponseItemType", + "type": "string" + } + }, + "required": [ + "summary", + "type" + ], + "title": "ReasoningResponseItem", + "type": "object" + }, + { + "properties": { + "action": { + "$ref": "#/definitions/v2/LocalShellAction" + }, + "call_id": { + "description": "Set when using the Responses API.", + "type": [ + "string", + "null" + ] + }, + "id": { + "description": "Legacy id field retained for compatibility with older payloads.", + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "status": { + "$ref": "#/definitions/v2/LocalShellStatus" + }, + "type": { + "enum": [ + "local_shell_call" + ], + "title": "LocalShellCallResponseItemType", + "type": "string" + } + }, + "required": [ + "action", + "status", + "type" + ], + "title": "LocalShellCallResponseItem", + "type": "object" + }, + { + "properties": { + "arguments": { + "type": "string" + }, + "call_id": { + "type": "string" + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "name": { + "type": "string" + }, + "namespace": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "function_call" + ], + "title": "FunctionCallResponseItemType", + "type": "string" + } + }, + "required": [ + "arguments", + "call_id", + "name", + "type" + ], + "title": "FunctionCallResponseItem", + "type": "object" + }, + { + "properties": { + "arguments": true, + "call_id": { + "type": [ + "string", + "null" + ] + }, + "execution": { + "type": "string" + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "status": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "tool_search_call" + ], + "title": "ToolSearchCallResponseItemType", + "type": "string" + } + }, + "required": [ + "arguments", + "execution", + "type" + ], + "title": "ToolSearchCallResponseItem", + "type": "object" + }, + { + "properties": { + "call_id": { + "type": "string" + }, + "output": { + "$ref": "#/definitions/v2/FunctionCallOutputBody" + }, + "type": { + "enum": [ + "function_call_output" + ], + "title": "FunctionCallOutputResponseItemType", + "type": "string" + } + }, + "required": [ + "call_id", + "output", + "type" + ], + "title": "FunctionCallOutputResponseItem", + "type": "object" + }, + { + "properties": { + "call_id": { + "type": "string" + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "input": { + "type": "string" + }, + "name": { + "type": "string" + }, + "status": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "custom_tool_call" + ], + "title": "CustomToolCallResponseItemType", + "type": "string" + } + }, + "required": [ + "call_id", + "input", + "name", + "type" + ], + "title": "CustomToolCallResponseItem", + "type": "object" + }, + { + "properties": { + "call_id": { + "type": "string" + }, + "name": { + "type": [ + "string", + "null" + ] + }, + "output": { + "$ref": "#/definitions/v2/FunctionCallOutputBody" + }, + "type": { + "enum": [ + "custom_tool_call_output" + ], + "title": "CustomToolCallOutputResponseItemType", + "type": "string" + } + }, + "required": [ + "call_id", + "output", + "type" + ], + "title": "CustomToolCallOutputResponseItem", + "type": "object" + }, + { + "properties": { + "call_id": { + "type": [ + "string", + "null" + ] + }, + "execution": { + "type": "string" + }, + "status": { + "type": "string" + }, + "tools": { + "items": true, + "type": "array" + }, + "type": { + "enum": [ + "tool_search_output" + ], + "title": "ToolSearchOutputResponseItemType", + "type": "string" + } + }, + "required": [ + "execution", + "status", + "tools", + "type" + ], + "title": "ToolSearchOutputResponseItem", + "type": "object" + }, + { + "properties": { + "action": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ResponsesApiWebSearchAction" + }, + { + "type": "null" + } + ] + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "status": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "web_search_call" + ], + "title": "WebSearchCallResponseItemType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "WebSearchCallResponseItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "result": { + "type": "string" + }, + "revised_prompt": { + "type": [ + "string", + "null" + ] + }, + "status": { + "type": "string" + }, + "type": { + "enum": [ + "image_generation_call" + ], + "title": "ImageGenerationCallResponseItemType", + "type": "string" + } + }, + "required": [ + "id", + "result", + "status", + "type" + ], + "title": "ImageGenerationCallResponseItem", + "type": "object" + }, + { + "properties": { + "ghost_commit": { + "$ref": "#/definitions/v2/GhostCommit" + }, + "type": { + "enum": [ + "ghost_snapshot" + ], + "title": "GhostSnapshotResponseItemType", + "type": "string" + } + }, + "required": [ + "ghost_commit", + "type" + ], + "title": "GhostSnapshotResponseItem", + "type": "object" + }, + { + "properties": { + "encrypted_content": { + "type": "string" + }, + "type": { + "enum": [ + "compaction" + ], + "title": "CompactionResponseItemType", + "type": "string" + } + }, + "required": [ + "encrypted_content", + "type" + ], + "title": "CompactionResponseItem", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "other" + ], + "title": "OtherResponseItemType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "OtherResponseItem", + "type": "object" + } + ] + }, + "ResponsesApiWebSearchAction": { + "oneOf": [ + { + "properties": { + "queries": { + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "query": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "search" + ], + "title": "SearchResponsesApiWebSearchActionType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "SearchResponsesApiWebSearchAction", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "open_page" + ], + "title": "OpenPageResponsesApiWebSearchActionType", + "type": "string" + }, + "url": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "type" + ], + "title": "OpenPageResponsesApiWebSearchAction", + "type": "object" + }, + { + "properties": { + "pattern": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "find_in_page" + ], + "title": "FindInPageResponsesApiWebSearchActionType", + "type": "string" + }, + "url": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "type" + ], + "title": "FindInPageResponsesApiWebSearchAction", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "other" + ], + "title": "OtherResponsesApiWebSearchActionType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "OtherResponsesApiWebSearchAction", + "type": "object" + } + ] + }, + "ReviewDelivery": { + "enum": [ + "inline", + "detached" + ], + "type": "string" + }, + "ReviewStartParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "delivery": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ReviewDelivery" + }, + { + "type": "null" + } + ], + "default": null, + "description": "Where to run the review: inline (default) on the current thread or detached on a new thread (returned in `reviewThreadId`)." + }, + "target": { + "$ref": "#/definitions/v2/ReviewTarget" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "target", + "threadId" + ], + "title": "ReviewStartParams", + "type": "object" + }, + "ReviewStartResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "reviewThreadId": { + "description": "Identifies the thread where the review runs.\n\nFor inline reviews, this is the original thread id. For detached reviews, this is the id of the new review thread.", + "type": "string" + }, + "turn": { + "$ref": "#/definitions/v2/Turn" + } + }, + "required": [ + "reviewThreadId", + "turn" + ], + "title": "ReviewStartResponse", + "type": "object" + }, + "ReviewTarget": { + "oneOf": [ + { + "description": "Review the working tree: staged, unstaged, and untracked files.", + "properties": { + "type": { + "enum": [ + "uncommittedChanges" + ], + "title": "UncommittedChangesReviewTargetType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "UncommittedChangesReviewTarget", + "type": "object" + }, + { + "description": "Review changes between the current branch and the given base branch.", + "properties": { + "branch": { + "type": "string" + }, + "type": { + "enum": [ + "baseBranch" + ], + "title": "BaseBranchReviewTargetType", + "type": "string" + } + }, + "required": [ + "branch", + "type" + ], + "title": "BaseBranchReviewTarget", + "type": "object" + }, + { + "description": "Review the changes introduced by a specific commit.", + "properties": { + "sha": { + "type": "string" + }, + "title": { + "description": "Optional human-readable label (e.g., commit subject) for UIs.", + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "commit" + ], + "title": "CommitReviewTargetType", + "type": "string" + } + }, + "required": [ + "sha", + "type" + ], + "title": "CommitReviewTarget", + "type": "object" + }, + { + "description": "Arbitrary instructions, equivalent to the old free-form prompt.", + "properties": { + "instructions": { + "type": "string" + }, + "type": { + "enum": [ + "custom" + ], + "title": "CustomReviewTargetType", + "type": "string" + } + }, + "required": [ + "instructions", + "type" + ], + "title": "CustomReviewTarget", + "type": "object" + } + ] + }, + "SandboxMode": { + "enum": [ + "read-only", + "workspace-write", + "danger-full-access" + ], + "type": "string" + }, + "SandboxPolicy": { + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "dangerFullAccess" + ], + "title": "DangerFullAccessSandboxPolicyType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "DangerFullAccessSandboxPolicy", + "type": "object" + }, + { + "properties": { + "access": { + "allOf": [ + { + "$ref": "#/definitions/v2/ReadOnlyAccess" + } + ], + "default": { + "type": "fullAccess" + } + }, + "networkAccess": { + "default": false, + "type": "boolean" + }, + "type": { + "enum": [ + "readOnly" + ], + "title": "ReadOnlySandboxPolicyType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ReadOnlySandboxPolicy", + "type": "object" + }, + { + "properties": { + "networkAccess": { + "allOf": [ + { + "$ref": "#/definitions/v2/NetworkAccess" + } + ], + "default": "restricted" + }, + "type": { + "enum": [ + "externalSandbox" + ], + "title": "ExternalSandboxSandboxPolicyType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ExternalSandboxSandboxPolicy", + "type": "object" + }, + { + "properties": { + "excludeSlashTmp": { + "default": false, + "type": "boolean" + }, + "excludeTmpdirEnvVar": { + "default": false, + "type": "boolean" + }, + "networkAccess": { + "default": false, + "type": "boolean" + }, + "readOnlyAccess": { + "allOf": [ + { + "$ref": "#/definitions/v2/ReadOnlyAccess" + } + ], + "default": { + "type": "fullAccess" + } + }, + "type": { + "enum": [ + "workspaceWrite" + ], + "title": "WorkspaceWriteSandboxPolicyType", + "type": "string" + }, + "writableRoots": { + "default": [], + "items": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "type": "array" + } + }, + "required": [ + "type" + ], + "title": "WorkspaceWriteSandboxPolicy", + "type": "object" + } + ] }, "SandboxWorkspaceWrite": { - "type": "object", "properties": { "exclude_slash_tmp": { "default": false, @@ -18291,15 +13176,5139 @@ }, "writable_roots": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" + }, + "SendAddCreditsNudgeEmailParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "creditType": { + "$ref": "#/definitions/v2/AddCreditsNudgeCreditType" + } + }, + "required": [ + "creditType" + ], + "title": "SendAddCreditsNudgeEmailParams", + "type": "object" + }, + "SendAddCreditsNudgeEmailResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "status": { + "$ref": "#/definitions/v2/AddCreditsNudgeEmailStatus" + } + }, + "required": [ + "status" + ], + "title": "SendAddCreditsNudgeEmailResponse", + "type": "object" + }, + "ServerRequestResolvedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "requestId": { + "$ref": "#/definitions/v2/RequestId" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "requestId", + "threadId" + ], + "title": "ServerRequestResolvedNotification", + "type": "object" + }, + "ServiceTier": { + "enum": [ + "fast", + "flex" + ], + "type": "string" + }, + "SessionSource": { + "oneOf": [ + { + "enum": [ + "cli", + "vscode", + "exec", + "appServer", + "unknown" + ], + "type": "string" + }, + { + "additionalProperties": false, + "properties": { + "custom": { + "type": "string" + } + }, + "required": [ + "custom" + ], + "title": "CustomSessionSource", + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "subAgent": { + "$ref": "#/definitions/v2/SubAgentSource" + } + }, + "required": [ + "subAgent" + ], + "title": "SubAgentSessionSource", + "type": "object" + } + ] + }, + "Settings": { + "description": "Settings for a collaboration mode.", + "properties": { + "developer_instructions": { + "type": [ + "string", + "null" + ] + }, + "model": { + "type": "string" + }, + "reasoning_effort": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ReasoningEffort" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "model" + ], + "type": "object" + }, + "SortDirection": { + "enum": [ + "asc", + "desc" + ], + "type": "string" + }, + "SubAgentSource": { + "oneOf": [ + { + "enum": [ + "review", + "compact", + "memory_consolidation" + ], + "type": "string" + }, + { + "additionalProperties": false, + "properties": { + "thread_spawn": { + "properties": { + "agent_nickname": { + "default": null, + "type": [ + "string", + "null" + ] + }, + "agent_path": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AgentPath" + }, + { + "type": "null" + } + ], + "default": null + }, + "agent_role": { + "default": null, + "type": [ + "string", + "null" + ] + }, + "depth": { + "format": "int32", + "type": "integer" + }, + "parent_thread_id": { + "$ref": "#/definitions/v2/ThreadId" + } + }, + "required": [ + "depth", + "parent_thread_id" + ], + "type": "object" + } + }, + "required": [ + "thread_spawn" + ], + "title": "ThreadSpawnSubAgentSource", + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "other": { + "type": "string" + } + }, + "required": [ + "other" + ], + "title": "OtherSubAgentSource", + "type": "object" + } + ] + }, + "TerminalInteractionNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "itemId": { + "type": "string" + }, + "processId": { + "type": "string" + }, + "stdin": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "itemId", + "processId", + "stdin", + "threadId", + "turnId" + ], + "title": "TerminalInteractionNotification", + "type": "object" + }, + "TextElement": { + "properties": { + "byteRange": { + "allOf": [ + { + "$ref": "#/definitions/v2/ByteRange" + } + ], + "description": "Byte range in the parent `text` buffer that this element occupies." + }, + "placeholder": { + "description": "Optional human-readable placeholder for the element, displayed in the UI.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "byteRange" + ], + "type": "object" + }, + "TextPosition": { + "properties": { + "column": { + "description": "1-based column number (in Unicode scalar values).", + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "line": { + "description": "1-based line number.", + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "column", + "line" + ], + "type": "object" + }, + "TextRange": { + "properties": { + "end": { + "$ref": "#/definitions/v2/TextPosition" + }, + "start": { + "$ref": "#/definitions/v2/TextPosition" + } + }, + "required": [ + "end", + "start" + ], + "type": "object" + }, + "Thread": { + "properties": { + "agentNickname": { + "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", + "type": [ + "string", + "null" + ] + }, + "agentRole": { + "description": "Optional role (agent_role) assigned to an AgentControl-spawned sub-agent.", + "type": [ + "string", + "null" + ] + }, + "cliVersion": { + "description": "Version of the CLI that created the thread.", + "type": "string" + }, + "createdAt": { + "description": "Unix timestamp (in seconds) when the thread was created.", + "format": "int64", + "type": "integer" + }, + "cwd": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "Working directory captured for the thread." + }, + "ephemeral": { + "description": "Whether the thread is ephemeral and should not be materialized on disk.", + "type": "boolean" + }, + "epiphanyState": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyThreadState" + }, + { + "type": "null" + } + ], + "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads." + }, + "forkedFromId": { + "description": "Source thread id when this thread was created by forking another thread.", + "type": [ + "string", + "null" + ] + }, + "gitInfo": { + "anyOf": [ + { + "$ref": "#/definitions/v2/GitInfo" + }, + { + "type": "null" + } + ], + "description": "Optional Git metadata captured when the thread was created." + }, + "id": { + "type": "string" + }, + "modelProvider": { + "description": "Model provider used for this thread (for example, 'openai').", + "type": "string" + }, + "name": { + "description": "Optional user-facing thread title.", + "type": [ + "string", + "null" + ] + }, + "path": { + "description": "[UNSTABLE] Path to the thread on disk.", + "type": [ + "string", + "null" + ] + }, + "preview": { + "description": "Usually the first user message in the thread, if available.", + "type": "string" + }, + "source": { + "allOf": [ + { + "$ref": "#/definitions/v2/SessionSource" + } + ], + "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." + }, + "status": { + "allOf": [ + { + "$ref": "#/definitions/v2/ThreadStatus" + } + ], + "description": "Current runtime status for the thread." + }, + "turns": { + "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", + "items": { + "$ref": "#/definitions/v2/Turn" + }, + "type": "array" + }, + "updatedAt": { + "description": "Unix timestamp (in seconds) when the thread was last updated.", + "format": "int64", + "type": "integer" + } + }, + "required": [ + "cliVersion", + "createdAt", + "cwd", + "ephemeral", + "id", + "modelProvider", + "preview", + "source", + "status", + "turns", + "updatedAt" + ], + "type": "object" + }, + "ThreadActiveFlag": { + "enum": [ + "waitingOnApproval", + "waitingOnUserInput" + ], + "type": "string" + }, + "ThreadApproveGuardianDeniedActionParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "event": { + "description": "Serialized `codex_protocol::protocol::GuardianAssessmentEvent`." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "event", + "threadId" + ], + "title": "ThreadApproveGuardianDeniedActionParams", + "type": "object" + }, + "ThreadApproveGuardianDeniedActionResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadApproveGuardianDeniedActionResponse", + "type": "object" + }, + "ThreadArchiveParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadArchiveParams", + "type": "object" + }, + "ThreadArchiveResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadArchiveResponse", + "type": "object" + }, + "ThreadArchivedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadArchivedNotification", + "type": "object" + }, + "ThreadClosedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadClosedNotification", + "type": "object" + }, + "ThreadCompactStartParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadCompactStartParams", + "type": "object" + }, + "ThreadCompactStartResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadCompactStartResponse", + "type": "object" + }, + "ThreadEpiphanyContext": { + "properties": { + "checkpoint": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyGraphCheckpoint" + }, + { + "type": "null" + } + ] + }, + "evidence": { + "items": { + "$ref": "#/definitions/v2/EpiphanyEvidenceRecord" + }, + "type": "array" + }, + "frontier": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyGraphFrontier" + }, + { + "type": "null" + } + ] + }, + "graph": { + "$ref": "#/definitions/v2/ThreadEpiphanyGraphContext" + }, + "investigationCheckpoint": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyInvestigationCheckpoint" + }, + { + "type": "null" + } + ] + }, + "observations": { + "items": { + "$ref": "#/definitions/v2/EpiphanyObservation" + }, + "type": "array" + } + }, + "required": [ + "graph" + ], + "type": "object" + }, + "ThreadEpiphanyContextMissing": { + "properties": { + "evidenceIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "graphEdgeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "graphNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "observationIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ThreadEpiphanyContextSource": { + "enum": [ + "stored", + "live" + ], + "type": "string" + }, + "ThreadEpiphanyContextStateStatus": { + "enum": [ + "missing", + "ready" + ], + "type": "string" + }, + "ThreadEpiphanyCoordinatorAction": { + "enum": [ + "prepareCheckpoint", + "compactRehydrateReorient", + "launchReorientWorker", + "waitForReorientWorker", + "reviewReorientResult", + "regatherManually", + "launchResearch", + "reviewResearchResult", + "launchModeling", + "reviewModelingResult", + "launchVerification", + "reviewVerificationResult", + "continueImplementation" + ], + "type": "string" + }, + "ThreadEpiphanyCoordinatorSignals": { + "properties": { + "crrcAction": { + "$ref": "#/definitions/v2/ThreadEpiphanyCrrcAction" + }, + "modelingResultStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyRoleResultStatus" + }, + "pressureLevel": { + "$ref": "#/definitions/v2/ThreadEpiphanyPressureLevel" + }, + "reorientAction": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientAction" + }, + "reorientResultStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientResultStatus" + }, + "researchResultStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyRoleResultStatus" + }, + "shouldPrepareCompaction": { + "type": "boolean" + }, + "verificationResultStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyRoleResultStatus" + } + }, + "required": [ + "crrcAction", + "modelingResultStatus", + "pressureLevel", + "reorientAction", + "reorientResultStatus", + "researchResultStatus", + "shouldPrepareCompaction", + "verificationResultStatus" + ], + "type": "object" + }, + "ThreadEpiphanyCrrcAction": { + "enum": [ + "continue", + "prepareCheckpoint", + "launchReorientWorker", + "waitForReorientWorker", + "reviewReorientResult", + "acceptReorientResult", + "regatherManually" + ], + "type": "string" + }, + "ThreadEpiphanyCrrcRecommendation": { + "properties": { + "action": { + "$ref": "#/definitions/v2/ThreadEpiphanyCrrcAction" + }, + "reason": { + "type": "string" + }, + "recommendedSceneAction": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanySceneAction" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "action", + "reason" + ], + "type": "object" + }, + "ThreadEpiphanyFreshnessSource": { + "enum": [ + "stored", + "live" + ], + "type": "string" + }, + "ThreadEpiphanyGraphContext": { + "properties": { + "architectureEdges": { + "items": { + "$ref": "#/definitions/v2/EpiphanyGraphEdge" + }, + "type": "array" + }, + "architectureNodes": { + "items": { + "$ref": "#/definitions/v2/EpiphanyGraphNode" + }, + "type": "array" + }, + "dataflowEdges": { + "items": { + "$ref": "#/definitions/v2/EpiphanyGraphEdge" + }, + "type": "array" + }, + "dataflowNodes": { + "items": { + "$ref": "#/definitions/v2/EpiphanyGraphNode" + }, + "type": "array" + }, + "links": { + "items": { + "$ref": "#/definitions/v2/EpiphanyGraphLink" + }, + "type": "array" + } + }, + "type": "object" + }, + "ThreadEpiphanyGraphFreshness": { + "properties": { + "checkpointId": { + "type": [ + "string", + "null" + ] + }, + "dirtyPathCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "dirtyPaths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "graphFreshness": { + "type": [ + "string", + "null" + ] + }, + "note": { + "type": "string" + }, + "openGapCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "openQuestionCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "status": { + "$ref": "#/definitions/v2/ThreadEpiphanyGraphFreshnessStatus" + } + }, + "required": [ + "dirtyPathCount", + "note", + "openGapCount", + "openQuestionCount", + "status" + ], + "type": "object" + }, + "ThreadEpiphanyGraphFreshnessStatus": { + "enum": [ + "missing", + "ready", + "stale" + ], + "type": "string" + }, + "ThreadEpiphanyGraphQuery": { + "properties": { + "depth": { + "description": "Defaults to 1 and is capped by the server.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "direction": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanyGraphQueryDirection" + }, + { + "type": "null" + } + ], + "description": "Defaults to `both`." + }, + "edgeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "edgeKinds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "includeLinks": { + "description": "Defaults to true so neighborhood queries preserve dataflow/architecture joins.", + "type": [ + "boolean", + "null" + ] + }, + "kind": { + "$ref": "#/definitions/v2/ThreadEpiphanyGraphQueryKind" + }, + "nodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "paths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "symbols": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "kind" + ], + "type": "object" + }, + "ThreadEpiphanyGraphQueryDirection": { + "enum": [ + "incoming", + "outgoing", + "both" + ], + "type": "string" + }, + "ThreadEpiphanyGraphQueryKind": { + "enum": [ + "node", + "path", + "frontierNeighborhood", + "neighbors" + ], + "type": "string" + }, + "ThreadEpiphanyGraphQueryMatched": { + "properties": { + "edgeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "edgeKinds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "nodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "paths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "symbols": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ThreadEpiphanyGraphQueryMissing": { + "properties": { + "edgeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "nodeIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ThreadEpiphanyInvalidationInput": { + "properties": { + "activeFrontierNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "changedPathCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "changedPaths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "graphNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "note": { + "type": "string" + }, + "observedAtUnixSeconds": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "status": { + "$ref": "#/definitions/v2/ThreadEpiphanyInvalidationStatus" + }, + "watchedRoot": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "changedPathCount", + "note", + "status" + ], + "type": "object" + }, + "ThreadEpiphanyInvalidationStatus": { + "enum": [ + "unavailable", + "clean", + "changed" + ], + "type": "string" + }, + "ThreadEpiphanyJob": { + "properties": { + "activeThreadIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "authorityScope": { + "type": [ + "string", + "null" + ] + }, + "backendJobId": { + "type": [ + "string", + "null" + ] + }, + "blockingReason": { + "type": [ + "string", + "null" + ] + }, + "id": { + "type": "string" + }, + "itemsProcessed": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "itemsTotal": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "kind": { + "$ref": "#/definitions/v2/ThreadEpiphanyJobKind" + }, + "lastCheckpointAtUnixSeconds": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "launcherJobId": { + "type": [ + "string", + "null" + ] + }, + "linkedGraphNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "linkedSubgoalIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "ownerRole": { + "type": "string" + }, + "progressNote": { + "type": [ + "string", + "null" + ] + }, + "scope": { + "type": "string" + }, + "status": { + "$ref": "#/definitions/v2/ThreadEpiphanyJobStatus" + } + }, + "required": [ + "id", + "kind", + "ownerRole", + "scope", + "status" + ], + "type": "object" + }, + "ThreadEpiphanyJobKind": { + "enum": [ + "indexing", + "remap", + "verification", + "specialist" + ], + "type": "string" + }, + "ThreadEpiphanyJobStatus": { + "enum": [ + "idle", + "needed", + "pending", + "running", + "completed", + "failed", + "cancelled", + "blocked", + "unavailable" + ], + "type": "string" + }, + "ThreadEpiphanyJobsUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "jobs": { + "items": { + "$ref": "#/definitions/v2/ThreadEpiphanyJob" + }, + "type": "array" + }, + "source": { + "$ref": "#/definitions/v2/ThreadEpiphanyJobsUpdatedSource" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "source", + "threadId" + ], + "title": "ThreadEpiphanyJobsUpdatedNotification", + "type": "object" + }, + "ThreadEpiphanyJobsUpdatedSource": { + "enum": [ + "runtimeProgress" + ], + "type": "string" + }, + "ThreadEpiphanyPlanningSummary": { + "properties": { + "activeObjective": { + "type": [ + "string", + "null" + ] + }, + "backlogItemCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "captureCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "draftObjectiveCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "githubIssueCaptureCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "note": { + "type": "string" + }, + "objectiveDraftCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "pendingCaptureCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "readyBacklogItemCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "roadmapStreamCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "backlogItemCount", + "captureCount", + "draftObjectiveCount", + "githubIssueCaptureCount", + "note", + "objectiveDraftCount", + "pendingCaptureCount", + "readyBacklogItemCount", + "roadmapStreamCount" + ], + "type": "object" + }, + "ThreadEpiphanyPressure": { + "properties": { + "basis": { + "$ref": "#/definitions/v2/ThreadEpiphanyPressureBasis" + }, + "level": { + "$ref": "#/definitions/v2/ThreadEpiphanyPressureLevel" + }, + "modelAutoCompactTokenLimit": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "modelContextWindow": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "note": { + "type": "string" + }, + "ratioPerMille": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "remainingTokens": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "shouldPrepareCompaction": { + "type": "boolean" + }, + "status": { + "$ref": "#/definitions/v2/ThreadEpiphanyPressureStatus" + }, + "usedTokens": { + "format": "int64", + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "basis", + "level", + "note", + "shouldPrepareCompaction", + "status" + ], + "type": "object" + }, + "ThreadEpiphanyPressureBasis": { + "enum": [ + "unknown", + "autoCompactLimit", + "modelContextWindow" + ], + "type": "string" + }, + "ThreadEpiphanyPressureLevel": { + "enum": [ + "unknown", + "low", + "elevated", + "high", + "critical" + ], + "type": "string" + }, + "ThreadEpiphanyPressureStatus": { + "enum": [ + "unknown", + "ready" + ], + "type": "string" + }, + "ThreadEpiphanyReorientAction": { + "enum": [ + "resume", + "regather" + ], + "type": "string" + }, + "ThreadEpiphanyReorientCheckpointStatus": { + "enum": [ + "missing", + "resumeReady", + "regatherRequired" + ], + "type": "string" + }, + "ThreadEpiphanyReorientDecision": { + "properties": { + "action": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientAction" + }, + "activeFrontierNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "checkpointChangedPaths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "checkpointDirtyPaths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "checkpointId": { + "type": [ + "string", + "null" + ] + }, + "checkpointStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientCheckpointStatus" + }, + "graphStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyGraphFreshnessStatus" + }, + "nextAction": { + "type": "string" + }, + "note": { + "type": "string" + }, + "pressureLevel": { + "$ref": "#/definitions/v2/ThreadEpiphanyPressureLevel" + }, + "reasons": { + "items": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientReason" + }, + "type": "array" + }, + "retrievalStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyRetrievalFreshnessStatus" + }, + "watcherStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyInvalidationStatus" + } + }, + "required": [ + "action", + "checkpointStatus", + "graphStatus", + "nextAction", + "note", + "pressureLevel", + "retrievalStatus", + "watcherStatus" + ], + "type": "object" + }, + "ThreadEpiphanyReorientFinding": { + "properties": { + "artifactRefs": { + "items": { + "type": "string" + }, + "type": "array" + }, + "checkpointStillValid": { + "type": [ + "boolean", + "null" + ] + }, + "evidenceIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "filesInspected": { + "items": { + "type": "string" + }, + "type": "array" + }, + "frontierNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "itemError": { + "type": [ + "string", + "null" + ] + }, + "jobError": { + "type": [ + "string", + "null" + ] + }, + "mode": { + "type": [ + "string", + "null" + ] + }, + "nextSafeMove": { + "type": [ + "string", + "null" + ] + }, + "runtimeJobId": { + "type": [ + "string", + "null" + ] + }, + "runtimeResultId": { + "type": [ + "string", + "null" + ] + }, + "summary": { + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "ThreadEpiphanyReorientReason": { + "enum": [ + "missingState", + "missingCheckpoint", + "checkpointRequestedRegather", + "checkpointPathsDirty", + "checkpointPathsChanged", + "frontierChanged", + "unanchoredCheckpointWhileStateStale", + "checkpointReady" + ], + "type": "string" + }, + "ThreadEpiphanyReorientResultStatus": { + "enum": [ + "missingState", + "missingBinding", + "backendUnavailable", + "backendMissing", + "pending", + "running", + "completed", + "failed", + "cancelled" + ], + "type": "string" + }, + "ThreadEpiphanyReorientSource": { + "enum": [ + "stored", + "live" + ], + "type": "string" + }, + "ThreadEpiphanyReorientStateStatus": { + "enum": [ + "missing", + "ready" + ], + "type": "string" + }, + "ThreadEpiphanyRetrievalFreshness": { + "properties": { + "dirtyPaths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "indexedChunkCount": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "indexedFileCount": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "lastIndexedAtUnixSeconds": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "note": { + "type": "string" + }, + "semanticAvailable": { + "type": [ + "boolean", + "null" + ] + }, + "status": { + "$ref": "#/definitions/v2/ThreadEpiphanyRetrievalFreshnessStatus" + } + }, + "required": [ + "note", + "status" + ], + "type": "object" + }, + "ThreadEpiphanyRetrievalFreshnessStatus": { + "enum": [ + "missing", + "ready", + "stale", + "indexing", + "unavailable" + ], + "type": "string" + }, + "ThreadEpiphanyRoleFinding": { + "properties": { + "artifactRefs": { + "items": { + "type": "string" + }, + "type": "array" + }, + "checkpointSummary": { + "type": [ + "string", + "null" + ] + }, + "evidenceGaps": { + "items": { + "type": "string" + }, + "type": "array" + }, + "evidenceIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "filesInspected": { + "items": { + "type": "string" + }, + "type": "array" + }, + "frontierNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "itemError": { + "type": [ + "string", + "null" + ] + }, + "jobError": { + "type": [ + "string", + "null" + ] + }, + "nextSafeMove": { + "type": [ + "string", + "null" + ] + }, + "openQuestions": { + "items": { + "type": "string" + }, + "type": "array" + }, + "risks": { + "items": { + "type": "string" + }, + "type": "array" + }, + "roleId": { + "$ref": "#/definitions/v2/ThreadEpiphanyRoleId" + }, + "runtimeJobId": { + "type": [ + "string", + "null" + ] + }, + "runtimeResultId": { + "type": [ + "string", + "null" + ] + }, + "scratchSummary": { + "type": [ + "string", + "null" + ] + }, + "selfPatch": true, + "selfPersistence": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanyRoleSelfPersistenceReview" + }, + { + "type": "null" + } + ] + }, + "statePatch": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanyUpdatePatch" + }, + { + "type": "null" + } + ] + }, + "summary": { + "type": [ + "string", + "null" + ] + }, + "verdict": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "roleId" + ], + "type": "object" + }, + "ThreadEpiphanyRoleId": { + "enum": [ + "implementation", + "imagination", + "research", + "modeling", + "verification", + "reorientation" + ], + "type": "string" + }, + "ThreadEpiphanyRoleLane": { + "properties": { + "authorityScopes": { + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "$ref": "#/definitions/v2/ThreadEpiphanyRoleId" + }, + "jobs": { + "items": { + "$ref": "#/definitions/v2/ThreadEpiphanyJob" + }, + "type": "array" + }, + "note": { + "type": "string" + }, + "ownerRole": { + "type": "string" + }, + "recommendedAction": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanySceneAction" + }, + { + "type": "null" + } + ] + }, + "status": { + "$ref": "#/definitions/v2/ThreadEpiphanyRoleStatus" + }, + "title": { + "type": "string" + } + }, + "required": [ + "id", + "note", + "ownerRole", + "status", + "title" + ], + "type": "object" + }, + "ThreadEpiphanyRoleResultStatus": { + "enum": [ + "missingState", + "missingBinding", + "backendUnavailable", + "backendMissing", + "pending", + "running", + "completed", + "failed", + "cancelled" + ], + "type": "string" + }, + "ThreadEpiphanyRoleSelfPersistenceReview": { + "properties": { + "reasons": { + "items": { + "type": "string" + }, + "type": "array" + }, + "status": { + "$ref": "#/definitions/v2/ThreadEpiphanyRoleSelfPersistenceStatus" + }, + "targetAgentId": { + "type": [ + "string", + "null" + ] + }, + "targetPath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "status" + ], + "type": "object" + }, + "ThreadEpiphanyRoleSelfPersistenceStatus": { + "enum": [ + "missing", + "accepted", + "rejected" + ], + "type": "string" + }, + "ThreadEpiphanyRoleStatus": { + "enum": [ + "ready", + "needed", + "blocked", + "running", + "completed", + "waiting", + "review", + "unavailable" + ], + "type": "string" + }, + "ThreadEpiphanyRolesSource": { + "enum": [ + "stored", + "live" + ], + "type": "string" + }, + "ThreadEpiphanyScene": { + "properties": { + "activeSubgoal": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanySceneSubgoal" + }, + { + "type": "null" + } + ] + }, + "availableActions": { + "items": { + "$ref": "#/definitions/v2/ThreadEpiphanySceneAction" + }, + "type": "array" + }, + "churn": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanySceneChurn" + }, + { + "type": "null" + } + ] + }, + "evidence": { + "$ref": "#/definitions/v2/ThreadEpiphanySceneRecords" + }, + "graph": { + "$ref": "#/definitions/v2/ThreadEpiphanySceneGraph" + }, + "invariantStatusCounts": { + "items": { + "$ref": "#/definitions/v2/ThreadEpiphanySceneStatusCount" + }, + "type": "array" + }, + "investigationCheckpoint": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanySceneInvestigationCheckpoint" + }, + { + "type": "null" + } + ] + }, + "objective": { + "type": [ + "string", + "null" + ] + }, + "observations": { + "$ref": "#/definitions/v2/ThreadEpiphanySceneRecords" + }, + "retrieval": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanySceneRetrieval" + }, + { + "type": "null" + } + ] + }, + "revision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "source": { + "$ref": "#/definitions/v2/ThreadEpiphanySceneSource" + }, + "stateStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanySceneStateStatus" + }, + "subgoals": { + "items": { + "$ref": "#/definitions/v2/ThreadEpiphanySceneSubgoal" + }, + "type": "array" + } + }, + "required": [ + "evidence", + "graph", + "observations", + "source", + "stateStatus" + ], + "type": "object" + }, + "ThreadEpiphanySceneAction": { + "enum": [ + "index", + "retrieve", + "distill", + "context", + "planning", + "graphQuery", + "jobs", + "roles", + "coordinator", + "roleLaunch", + "roleResult", + "roleAccept", + "jobLaunch", + "jobInterrupt", + "freshness", + "pressure", + "reorient", + "crrc", + "reorientLaunch", + "reorientResult", + "reorientAccept", + "propose", + "promote", + "update" + ], + "type": "string" + }, + "ThreadEpiphanySceneChurn": { + "properties": { + "diffPressure": { + "type": "string" + }, + "graphFreshness": { + "type": [ + "string", + "null" + ] + }, + "understandingStatus": { + "type": "string" + }, + "unexplainedWrites": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "warning": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "diffPressure", + "understandingStatus" + ], + "type": "object" + }, + "ThreadEpiphanySceneGraph": { + "properties": { + "activeEdgeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "activeNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "architectureEdgeCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "architectureNodeCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "checkpointId": { + "type": [ + "string", + "null" + ] + }, + "checkpointSummary": { + "type": [ + "string", + "null" + ] + }, + "dataflowEdgeCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "dataflowNodeCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "dirtyPaths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "linkCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "openGapCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "openQuestionCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "architectureEdgeCount", + "architectureNodeCount", + "dataflowEdgeCount", + "dataflowNodeCount", + "linkCount", + "openGapCount", + "openQuestionCount" + ], + "type": "object" + }, + "ThreadEpiphanySceneInvestigationCheckpoint": { + "properties": { + "capturedAtTurnId": { + "type": [ + "string", + "null" + ] + }, + "checkpointId": { + "type": "string" + }, + "codeRefCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "disposition": { + "$ref": "#/definitions/v2/EpiphanyInvestigationDisposition" + }, + "evidenceCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "focus": { + "type": "string" + }, + "kind": { + "type": "string" + }, + "nextAction": { + "type": [ + "string", + "null" + ] + }, + "openQuestionCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "summary": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "checkpointId", + "codeRefCount", + "disposition", + "evidenceCount", + "focus", + "kind", + "openQuestionCount" + ], + "type": "object" + }, + "ThreadEpiphanySceneRecord": { + "properties": { + "codeRefCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "id": { + "type": "string" + }, + "kind": { + "type": "string" + }, + "status": { + "type": "string" + }, + "summary": { + "type": "string" + } + }, + "required": [ + "codeRefCount", + "id", + "kind", + "status", + "summary" + ], + "type": "object" + }, + "ThreadEpiphanySceneRecords": { + "properties": { + "latest": { + "items": { + "$ref": "#/definitions/v2/ThreadEpiphanySceneRecord" + }, + "type": "array" + }, + "totalCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "totalCount" + ], + "type": "object" + }, + "ThreadEpiphanySceneRetrieval": { + "properties": { + "dirtyPathCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "indexRevision": { + "type": [ + "string", + "null" + ] + }, + "indexedChunkCount": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "indexedFileCount": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "semanticAvailable": { + "type": "boolean" + }, + "shardCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "status": { + "$ref": "#/definitions/v2/EpiphanyRetrievalStatus" + }, + "workspaceRoot": { + "type": "string" + } + }, + "required": [ + "dirtyPathCount", + "semanticAvailable", + "shardCount", + "status", + "workspaceRoot" + ], + "type": "object" + }, + "ThreadEpiphanySceneSource": { + "enum": [ + "stored", + "live" + ], + "type": "string" + }, + "ThreadEpiphanySceneStateStatus": { + "enum": [ + "missing", + "ready" + ], + "type": "string" + }, + "ThreadEpiphanySceneStatusCount": { + "properties": { + "count": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "status": { + "type": "string" + } + }, + "required": [ + "count", + "status" + ], + "type": "object" + }, + "ThreadEpiphanySceneSubgoal": { + "properties": { + "active": { + "type": "boolean" + }, + "id": { + "type": "string" + }, + "status": { + "type": "string" + }, + "summary": { + "type": [ + "string", + "null" + ] + }, + "title": { + "type": "string" + } + }, + "required": [ + "active", + "id", + "status", + "title" + ], + "type": "object" + }, + "ThreadEpiphanyStateUpdatedField": { + "enum": [ + "objective", + "activeSubgoalId", + "subgoals", + "invariants", + "graphs", + "graphFrontier", + "graphCheckpoint", + "scratch", + "investigationCheckpoint", + "jobBindings", + "acceptanceReceipts", + "runtimeLinks", + "observations", + "evidence", + "churn", + "mode", + "planning" + ], + "type": "string" + }, + "ThreadEpiphanyStateUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "changedFields": { + "items": { + "$ref": "#/definitions/v2/ThreadEpiphanyStateUpdatedField" + }, + "type": "array" + }, + "epiphanyState": { + "$ref": "#/definitions/v2/EpiphanyThreadState" + }, + "revision": { + "format": "uint64", + "minimum": 0.0, + "type": "integer" + }, + "source": { + "$ref": "#/definitions/v2/ThreadEpiphanyStateUpdatedSource" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "changedFields", + "epiphanyState", + "revision", + "source", + "threadId" + ], + "title": "ThreadEpiphanyStateUpdatedNotification", + "type": "object" + }, + "ThreadEpiphanyStateUpdatedSource": { + "enum": [ + "update", + "promote", + "jobLaunch", + "jobInterrupt", + "reorientAccept", + "roleAccept" + ], + "type": "string" + }, + "ThreadEpiphanyUpdatePatch": { + "properties": { + "acceptanceReceipts": { + "items": { + "$ref": "#/definitions/v2/EpiphanyAcceptanceReceipt" + }, + "type": "array" + }, + "activeSubgoalId": { + "type": [ + "string", + "null" + ] + }, + "churn": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyChurnState" + }, + { + "type": "null" + } + ] + }, + "evidence": { + "items": { + "$ref": "#/definitions/v2/EpiphanyEvidenceRecord" + }, + "type": "array" + }, + "graphCheckpoint": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyGraphCheckpoint" + }, + { + "type": "null" + } + ] + }, + "graphFrontier": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyGraphFrontier" + }, + { + "type": "null" + } + ] + }, + "graphs": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyGraphs" + }, + { + "type": "null" + } + ] + }, + "invariants": { + "items": { + "$ref": "#/definitions/v2/EpiphanyInvariant" + }, + "type": [ + "array", + "null" + ] + }, + "investigationCheckpoint": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyInvestigationCheckpoint" + }, + { + "type": "null" + } + ] + }, + "jobBindings": { + "items": { + "$ref": "#/definitions/v2/EpiphanyJobBinding" + }, + "type": [ + "array", + "null" + ] + }, + "mode": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyModeState" + }, + { + "type": "null" + } + ] + }, + "objective": { + "type": [ + "string", + "null" + ] + }, + "observations": { + "items": { + "$ref": "#/definitions/v2/EpiphanyObservation" + }, + "type": "array" + }, + "planning": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyPlanningState" + }, + { + "type": "null" + } + ] + }, + "runtimeLinks": { + "items": { + "$ref": "#/definitions/v2/EpiphanyRuntimeLink" + }, + "type": "array" + }, + "scratch": { + "anyOf": [ + { + "$ref": "#/definitions/v2/EpiphanyScratchPad" + }, + { + "type": "null" + } + ] + }, + "subgoals": { + "items": { + "$ref": "#/definitions/v2/EpiphanySubgoal" + }, + "type": [ + "array", + "null" + ] + } + }, + "type": "object" + }, + "ThreadEpiphanyViewCoordinator": { + "properties": { + "action": { + "$ref": "#/definitions/v2/ThreadEpiphanyCoordinatorAction" + }, + "canAutoRun": { + "type": "boolean" + }, + "note": { + "type": "string" + }, + "reason": { + "type": "string" + }, + "recommendedSceneAction": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanySceneAction" + }, + { + "type": "null" + } + ] + }, + "requiresReview": { + "type": "boolean" + }, + "roles": { + "items": { + "$ref": "#/definitions/v2/ThreadEpiphanyRoleLane" + }, + "type": "array" + }, + "source": { + "$ref": "#/definitions/v2/ThreadEpiphanyRolesSource" + }, + "sourceSignals": { + "$ref": "#/definitions/v2/ThreadEpiphanyCoordinatorSignals" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "stateStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientStateStatus" + }, + "targetRole": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanyRoleId" + }, + { + "type": "null" + } + ] + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "action", + "canAutoRun", + "note", + "reason", + "requiresReview", + "roles", + "source", + "sourceSignals", + "stateStatus", + "threadId" + ], + "type": "object" + }, + "ThreadEpiphanyViewCrrc": { + "properties": { + "availableActions": { + "items": { + "$ref": "#/definitions/v2/ThreadEpiphanySceneAction" + }, + "type": "array" + }, + "decision": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientDecision" + }, + "note": { + "type": "string" + }, + "pressure": { + "$ref": "#/definitions/v2/ThreadEpiphanyPressure" + }, + "recommendation": { + "$ref": "#/definitions/v2/ThreadEpiphanyCrrcRecommendation" + }, + "reorientBindingId": { + "type": "string" + }, + "reorientFinding": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientFinding" + }, + { + "type": "null" + } + ] + }, + "reorientJob": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadEpiphanyJob" + }, + { + "type": "null" + } + ] + }, + "reorientResultStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientResultStatus" + }, + "source": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientSource" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "stateStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientStateStatus" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "decision", + "note", + "pressure", + "recommendation", + "reorientBindingId", + "reorientResultStatus", + "source", + "stateStatus", + "threadId" + ], + "type": "object" + }, + "ThreadEpiphanyViewLens": { + "enum": [ + "scene", + "jobs", + "roles", + "planning", + "pressure", + "reorient", + "crrc", + "coordinator" + ], + "type": "string" + }, + "ThreadEpiphanyViewPlanning": { + "properties": { + "planning": { + "$ref": "#/definitions/v2/EpiphanyPlanningState" + }, + "source": { + "$ref": "#/definitions/v2/ThreadEpiphanyContextSource" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "stateStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyContextStateStatus" + }, + "summary": { + "$ref": "#/definitions/v2/ThreadEpiphanyPlanningSummary" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "planning", + "source", + "stateStatus", + "summary", + "threadId" + ], + "type": "object" + }, + "ThreadEpiphanyViewReorient": { + "properties": { + "decision": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientDecision" + }, + "source": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientSource" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "stateStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientStateStatus" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "decision", + "source", + "stateStatus", + "threadId" + ], + "type": "object" + }, + "ThreadEpiphanyViewRoles": { + "properties": { + "note": { + "type": "string" + }, + "roles": { + "items": { + "$ref": "#/definitions/v2/ThreadEpiphanyRoleLane" + }, + "type": "array" + }, + "source": { + "$ref": "#/definitions/v2/ThreadEpiphanyRolesSource" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "stateStatus": { + "$ref": "#/definitions/v2/ThreadEpiphanyReorientStateStatus" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "note", + "roles", + "source", + "stateStatus", + "threadId" + ], + "type": "object" + }, + "ThreadForkParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", + "properties": { + "approvalPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AskForApproval" + }, + { + "type": "null" + } + ] + }, + "approvalsReviewer": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ApprovalsReviewer" + }, + { + "type": "null" + } + ], + "description": "Override where approval requests are routed for review on this thread and subsequent turns." + }, + "baseInstructions": { + "type": [ + "string", + "null" + ] + }, + "config": { + "additionalProperties": true, + "type": [ + "object", + "null" + ] + }, + "cwd": { + "type": [ + "string", + "null" + ] + }, + "developerInstructions": { + "type": [ + "string", + "null" + ] + }, + "ephemeral": { + "type": "boolean" + }, + "model": { + "description": "Configuration overrides for the forked thread, if any.", + "type": [ + "string", + "null" + ] + }, + "modelProvider": { + "type": [ + "string", + "null" + ] + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/v2/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Full permissions override for the forked thread. Cannot be combined with `sandbox`." + }, + "sandbox": { + "anyOf": [ + { + "$ref": "#/definitions/v2/SandboxMode" + }, + { + "type": "null" + } + ] + }, + "serviceTier": { + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/v2/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "type": "null" + } + ] + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadForkParams", + "type": "object" + }, + "ThreadForkResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "approvalPolicy": { + "$ref": "#/definitions/v2/AskForApproval" + }, + "approvalsReviewer": { + "allOf": [ + { + "$ref": "#/definitions/v2/ApprovalsReviewer" + } + ], + "description": "Reviewer currently used for approval requests on this thread." + }, + "cwd": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "instructionSources": { + "default": [], + "description": "Instruction source files currently loaded for this thread.", + "items": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "type": "array" + }, + "model": { + "type": "string" + }, + "modelProvider": { + "type": "string" + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/v2/PermissionProfile" + }, + { + "type": "null" + } + ], + "default": null, + "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`." + }, + "reasoningEffort": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ReasoningEffort" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "allOf": [ + { + "$ref": "#/definitions/v2/SandboxPolicy" + } + ], + "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view." + }, + "serviceTier": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ServiceTier" + }, + { + "type": "null" + } + ] + }, + "thread": { + "$ref": "#/definitions/v2/Thread" + } + }, + "required": [ + "approvalPolicy", + "approvalsReviewer", + "cwd", + "model", + "modelProvider", + "sandbox", + "thread" + ], + "title": "ThreadForkResponse", + "type": "object" + }, + "ThreadId": { + "type": "string" + }, + "ThreadInjectItemsParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "items": { + "description": "Raw Responses API items to append to the thread's model-visible history.", + "items": true, + "type": "array" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "items", + "threadId" + ], + "title": "ThreadInjectItemsParams", + "type": "object" + }, + "ThreadInjectItemsResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadInjectItemsResponse", + "type": "object" + }, + "ThreadItem": { + "oneOf": [ + { + "properties": { + "content": { + "items": { + "$ref": "#/definitions/v2/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, + "required": [ + "content", + "id", + "type" + ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { + "properties": { + "fragments": { + "items": { + "$ref": "#/definitions/v2/HookPromptFragment" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "hookPrompt" + ], + "title": "HookPromptThreadItemType", + "type": "string" + } + }, + "required": [ + "fragments", + "id", + "type" + ], + "title": "HookPromptThreadItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "memoryCitation": { + "anyOf": [ + { + "$ref": "#/definitions/v2/MemoryCitation" + }, + { + "type": "null" + } + ], + "default": null + }, + "phase": { + "anyOf": [ + { + "$ref": "#/definitions/v2/MessagePhase" + }, + { + "type": "null" + } + ], + "default": null + }, + "text": { + "type": "string" + }, + "type": { + "enum": [ + "agentMessage" + ], + "title": "AgentMessageThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "text", + "type" + ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", + "properties": { + "id": { + "type": "string" + }, + "text": { + "type": "string" + }, + "type": { + "enum": [ + "plan" + ], + "title": "PlanThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "text", + "type" + ], + "title": "PlanThreadItem", + "type": "object" + }, + { + "properties": { + "content": { + "default": [], + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "summary": { + "default": [], + "items": { + "type": "string" + }, + "type": "array" + }, + "type": { + "enum": [ + "reasoning" + ], + "title": "ReasoningThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "type" + ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { + "properties": { + "aggregatedOutput": { + "description": "The command's output, aggregated from stdout and stderr.", + "type": [ + "string", + "null" + ] + }, + "command": { + "description": "The command to be executed.", + "type": "string" + }, + "commandActions": { + "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", + "items": { + "$ref": "#/definitions/v2/CommandAction" + }, + "type": "array" + }, + "cwd": { + "allOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + } + ], + "description": "The command's working directory." + }, + "durationMs": { + "description": "The duration of the command execution in milliseconds.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "exitCode": { + "description": "The command's exit code.", + "format": "int32", + "type": [ + "integer", + "null" + ] + }, + "id": { + "type": "string" + }, + "processId": { + "description": "Identifier for the underlying PTY process (when available).", + "type": [ + "string", + "null" + ] + }, + "source": { + "allOf": [ + { + "$ref": "#/definitions/v2/CommandExecutionSource" + } + ], + "default": "agent" + }, + "status": { + "$ref": "#/definitions/v2/CommandExecutionStatus" + }, + "type": { + "enum": [ + "commandExecution" + ], + "title": "CommandExecutionThreadItemType", + "type": "string" + } + }, + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { + "properties": { + "changes": { + "items": { + "$ref": "#/definitions/v2/FileUpdateChange" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "status": { + "$ref": "#/definitions/v2/PatchApplyStatus" + }, + "type": { + "enum": [ + "fileChange" + ], + "title": "FileChangeThreadItemType", + "type": "string" + } + }, + "required": [ + "changes", + "id", + "status", + "type" + ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { + "properties": { + "arguments": true, + "durationMs": { + "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "error": { + "anyOf": [ + { + "$ref": "#/definitions/v2/McpToolCallError" + }, + { + "type": "null" + } + ] + }, + "id": { + "type": "string" + }, + "mcpAppResourceUri": { + "type": [ + "string", + "null" + ] + }, + "result": { + "anyOf": [ + { + "$ref": "#/definitions/v2/McpToolCallResult" + }, + { + "type": "null" + } + ] + }, + "server": { + "type": "string" + }, + "status": { + "$ref": "#/definitions/v2/McpToolCallStatus" + }, + "tool": { + "type": "string" + }, + "type": { + "enum": [ + "mcpToolCall" + ], + "title": "McpToolCallThreadItemType", + "type": "string" + } + }, + "required": [ + "arguments", + "id", + "server", + "status", + "tool", + "type" + ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { + "properties": { + "arguments": true, + "contentItems": { + "items": { + "$ref": "#/definitions/v2/DynamicToolCallOutputContentItem" + }, + "type": [ + "array", + "null" + ] + }, + "durationMs": { + "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "id": { + "type": "string" + }, + "namespace": { + "type": [ + "string", + "null" + ] + }, + "status": { + "$ref": "#/definitions/v2/DynamicToolCallStatus" + }, + "success": { + "type": [ + "boolean", + "null" + ] + }, + "tool": { + "type": "string" + }, + "type": { + "enum": [ + "dynamicToolCall" + ], + "title": "DynamicToolCallThreadItemType", + "type": "string" + } + }, + "required": [ + "arguments", + "id", + "status", + "tool", + "type" + ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { + "properties": { + "agentsStates": { + "additionalProperties": { + "$ref": "#/definitions/v2/CollabAgentState" + }, + "description": "Last known status of the target agents, when available.", + "type": "object" + }, + "id": { + "description": "Unique identifier for this collab tool call.", + "type": "string" + }, + "model": { + "description": "Model requested for the spawned agent, when applicable.", + "type": [ + "string", + "null" + ] + }, + "prompt": { + "description": "Prompt text sent as part of the collab tool call, when available.", + "type": [ + "string", + "null" + ] + }, + "reasoningEffort": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ReasoningEffort" + }, + { + "type": "null" + } + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." + }, + "receiverThreadIds": { + "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", + "items": { + "type": "string" + }, + "type": "array" + }, + "senderThreadId": { + "description": "Thread ID of the agent issuing the collab request.", + "type": "string" + }, + "status": { + "allOf": [ + { + "$ref": "#/definitions/v2/CollabAgentToolCallStatus" + } + ], + "description": "Current status of the collab tool call." + }, + "tool": { + "allOf": [ + { + "$ref": "#/definitions/v2/CollabAgentTool" + } + ], + "description": "Name of the collab tool that was invoked." + }, + "type": { + "enum": [ + "collabAgentToolCall" + ], + "title": "CollabAgentToolCallThreadItemType", + "type": "string" + } + }, + "required": [ + "agentsStates", + "id", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", + "type" + ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { + "properties": { + "action": { + "anyOf": [ + { + "$ref": "#/definitions/v2/WebSearchAction" + }, + { + "type": "null" + } + ] + }, + "id": { + "type": "string" + }, + "query": { + "type": "string" + }, + "type": { + "enum": [ + "webSearch" + ], + "title": "WebSearchThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "query", + "type" + ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "path": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "type": { + "enum": [ + "imageView" + ], + "title": "ImageViewThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "path", + "type" + ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "result": { + "type": "string" + }, + "revisedPrompt": { + "type": [ + "string", + "null" + ] + }, + "savedPath": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + { + "type": "null" + } + ] + }, + "status": { + "type": "string" + }, + "type": { + "enum": [ + "imageGeneration" + ], + "title": "ImageGenerationThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "result", + "status", + "type" + ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "review": { + "type": "string" + }, + "type": { + "enum": [ + "enteredReviewMode" + ], + "title": "EnteredReviewModeThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "review", + "type" + ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "review": { + "type": "string" + }, + "type": { + "enum": [ + "exitedReviewMode" + ], + "title": "ExitedReviewModeThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "review", + "type" + ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "type": { + "enum": [ + "contextCompaction" + ], + "title": "ContextCompactionThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" + } + ] + }, + "ThreadListCwdFilter": { + "anyOf": [ + { + "type": "string" + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + }, + "ThreadListParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "archived": { + "description": "Optional archived filter; when set to true, only archived threads are returned. If false or null, only non-archived threads are returned.", + "type": [ + "boolean", + "null" + ] + }, + "cursor": { + "description": "Opaque pagination cursor returned by a previous call.", + "type": [ + "string", + "null" + ] + }, + "cwd": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadListCwdFilter" + }, + { + "type": "null" + } + ], + "description": "Optional cwd filter or filters; when set, only threads whose session cwd exactly matches one of these paths are returned." + }, + "limit": { + "description": "Optional page size; defaults to a reasonable server-side value.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "modelProviders": { + "description": "Optional provider filter; when set, only sessions recorded under these providers are returned. When present but empty, includes all providers.", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "searchTerm": { + "description": "Optional substring filter for the extracted thread title.", + "type": [ + "string", + "null" + ] + }, + "sortDirection": { + "anyOf": [ + { + "$ref": "#/definitions/v2/SortDirection" + }, + { + "type": "null" + } + ], + "description": "Optional sort direction; defaults to descending (newest first)." + }, + "sortKey": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadSortKey" + }, + { + "type": "null" + } + ], + "description": "Optional sort key; defaults to created_at." + }, + "sourceKinds": { + "description": "Optional source filter; when set, only sessions from these source kinds are returned. When omitted or empty, defaults to interactive sources.", + "items": { + "$ref": "#/definitions/v2/ThreadSourceKind" + }, + "type": [ + "array", + "null" + ] + }, + "useStateDbOnly": { + "description": "If true, return from the state DB without scanning JSONL rollouts to repair thread metadata. Omitted or false preserves scan-and-repair behavior.", + "type": "boolean" + } + }, + "title": "ThreadListParams", + "type": "object" + }, + "ThreadListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "backwardsCursor": { + "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one thread. Use it with the opposite `sortDirection`; for timestamp sorts it anchors at the start of the page timestamp so same-second updates are not skipped.", + "type": [ + "string", + "null" + ] + }, + "data": { + "items": { + "$ref": "#/definitions/v2/Thread" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ThreadListResponse", + "type": "object" + }, + "ThreadLoadedListParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cursor": { + "description": "Opaque pagination cursor returned by a previous call.", + "type": [ + "string", + "null" + ] + }, + "limit": { + "description": "Optional page size; defaults to no limit.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "title": "ThreadLoadedListParams", + "type": "object" + }, + "ThreadLoadedListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "data": { + "description": "Thread ids for sessions currently loaded in memory.", + "items": { + "type": "string" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ThreadLoadedListResponse", + "type": "object" + }, + "ThreadMemoryMode": { + "enum": [ + "enabled", + "disabled" + ], + "type": "string" + }, + "ThreadMetadataGitInfoUpdateParams": { + "properties": { + "branch": { + "description": "Omit to leave the stored branch unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", + "type": [ + "string", + "null" + ] + }, + "originUrl": { + "description": "Omit to leave the stored origin URL unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", + "type": [ + "string", + "null" + ] + }, + "sha": { + "description": "Omit to leave the stored commit unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "ThreadMetadataUpdateParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "gitInfo": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadMetadataGitInfoUpdateParams" + }, + { + "type": "null" + } + ], + "description": "Patch the stored Git metadata for this thread. Omit a field to leave it unchanged, set it to `null` to clear it, or provide a string to replace the stored value." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadMetadataUpdateParams", + "type": "object" + }, + "ThreadMetadataUpdateResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "thread": { + "$ref": "#/definitions/v2/Thread" + } + }, + "required": [ + "thread" + ], + "title": "ThreadMetadataUpdateResponse", + "type": "object" + }, + "ThreadNameUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + }, + "threadName": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "threadId" + ], + "title": "ThreadNameUpdatedNotification", + "type": "object" + }, + "ThreadReadParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "includeTurns": { + "default": false, + "description": "When true, include turns and their items from rollout history.", + "type": "boolean" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadReadParams", + "type": "object" + }, + "ThreadReadResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "thread": { + "$ref": "#/definitions/v2/Thread" + } + }, + "required": [ + "thread" + ], + "title": "ThreadReadResponse", + "type": "object" + }, + "ThreadRealtimeAudioChunk": { + "description": "EXPERIMENTAL - thread realtime audio chunk.", + "properties": { + "data": { + "type": "string" + }, + "itemId": { + "type": [ + "string", + "null" + ] + }, + "numChannels": { + "format": "uint16", + "minimum": 0.0, + "type": "integer" + }, + "sampleRate": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "samplesPerChannel": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "data", + "numChannels", + "sampleRate" + ], + "type": "object" + }, + "ThreadRealtimeClosedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - emitted when thread realtime transport closes.", + "properties": { + "reason": { + "type": [ + "string", + "null" + ] + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadRealtimeClosedNotification", + "type": "object" + }, + "ThreadRealtimeErrorNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - emitted when thread realtime encounters an error.", + "properties": { + "message": { + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "message", + "threadId" + ], + "title": "ThreadRealtimeErrorNotification", + "type": "object" + }, + "ThreadRealtimeItemAddedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - raw non-audio thread realtime item emitted by the backend.", + "properties": { + "item": true, + "threadId": { + "type": "string" + } + }, + "required": [ + "item", + "threadId" + ], + "title": "ThreadRealtimeItemAddedNotification", + "type": "object" + }, + "ThreadRealtimeOutputAudioDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - streamed output audio emitted by thread realtime.", + "properties": { + "audio": { + "$ref": "#/definitions/v2/ThreadRealtimeAudioChunk" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "audio", + "threadId" + ], + "title": "ThreadRealtimeOutputAudioDeltaNotification", + "type": "object" + }, + "ThreadRealtimeSdpNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - emitted with the remote SDP for a WebRTC realtime session.", + "properties": { + "sdp": { + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "sdp", + "threadId" + ], + "title": "ThreadRealtimeSdpNotification", + "type": "object" + }, + "ThreadRealtimeStartTransport": { + "description": "EXPERIMENTAL - transport used by thread realtime.", + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "websocket" + ], + "title": "WebsocketThreadRealtimeStartTransportType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "WebsocketThreadRealtimeStartTransport", + "type": "object" + }, + { + "properties": { + "sdp": { + "description": "SDP offer generated by a WebRTC RTCPeerConnection after configuring audio and the realtime events data channel.", + "type": "string" + }, + "type": { + "enum": [ + "webrtc" + ], + "title": "WebrtcThreadRealtimeStartTransportType", + "type": "string" + } + }, + "required": [ + "sdp", + "type" + ], + "title": "WebrtcThreadRealtimeStartTransport", + "type": "object" + } + ] + }, + "ThreadRealtimeStartedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - emitted when thread realtime startup is accepted.", + "properties": { + "sessionId": { + "type": [ + "string", + "null" + ] + }, + "threadId": { + "type": "string" + }, + "version": { + "$ref": "#/definitions/v2/RealtimeConversationVersion" + } + }, + "required": [ + "threadId", + "version" + ], + "title": "ThreadRealtimeStartedNotification", + "type": "object" + }, + "ThreadRealtimeTranscriptDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - flat transcript delta emitted whenever realtime transcript text changes.", + "properties": { + "delta": { + "description": "Live transcript delta from the realtime event.", + "type": "string" + }, + "role": { + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "delta", + "role", + "threadId" + ], + "title": "ThreadRealtimeTranscriptDeltaNotification", + "type": "object" + }, + "ThreadRealtimeTranscriptDoneNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - final transcript text emitted when realtime completes a transcript part.", + "properties": { + "role": { + "type": "string" + }, + "text": { + "description": "Final complete text for the transcript part.", + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "role", + "text", + "threadId" + ], + "title": "ThreadRealtimeTranscriptDoneNotification", + "type": "object" + }, + "ThreadResumeParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", + "properties": { + "approvalPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AskForApproval" + }, + { + "type": "null" + } + ] + }, + "approvalsReviewer": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ApprovalsReviewer" + }, + { + "type": "null" + } + ], + "description": "Override where approval requests are routed for review on this thread and subsequent turns." + }, + "baseInstructions": { + "type": [ + "string", + "null" + ] + }, + "config": { + "additionalProperties": true, + "type": [ + "object", + "null" + ] + }, + "cwd": { + "type": [ + "string", + "null" + ] + }, + "developerInstructions": { + "type": [ + "string", + "null" + ] + }, + "model": { + "description": "Configuration overrides for the resumed thread, if any.", + "type": [ + "string", + "null" + ] + }, + "modelProvider": { + "type": [ + "string", + "null" + ] + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/v2/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Full permissions override for the resumed thread. Cannot be combined with `sandbox`." + }, + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/v2/Personality" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "anyOf": [ + { + "$ref": "#/definitions/v2/SandboxMode" + }, + { + "type": "null" + } + ] + }, + "serviceTier": { + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/v2/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "type": "null" + } + ] + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadResumeParams", + "type": "object" + }, + "ThreadResumeResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "approvalPolicy": { + "$ref": "#/definitions/v2/AskForApproval" + }, + "approvalsReviewer": { + "allOf": [ + { + "$ref": "#/definitions/v2/ApprovalsReviewer" + } + ], + "description": "Reviewer currently used for approval requests on this thread." + }, + "cwd": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "instructionSources": { + "default": [], + "description": "Instruction source files currently loaded for this thread.", + "items": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "type": "array" + }, + "model": { + "type": "string" + }, + "modelProvider": { + "type": "string" + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/v2/PermissionProfile" + }, + { + "type": "null" + } + ], + "default": null, + "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`." + }, + "reasoningEffort": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ReasoningEffort" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "allOf": [ + { + "$ref": "#/definitions/v2/SandboxPolicy" + } + ], + "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view." + }, + "serviceTier": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ServiceTier" + }, + { + "type": "null" + } + ] + }, + "thread": { + "$ref": "#/definitions/v2/Thread" + } + }, + "required": [ + "approvalPolicy", + "approvalsReviewer", + "cwd", + "model", + "modelProvider", + "sandbox", + "thread" + ], + "title": "ThreadResumeResponse", + "type": "object" + }, + "ThreadRollbackParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "numTurns": { + "description": "The number of turns to drop from the end of the thread. Must be >= 1.\n\nThis only modifies the thread's history and does not revert local file changes that have been made by the agent. Clients are responsible for reverting these changes.", + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "numTurns", + "threadId" + ], + "title": "ThreadRollbackParams", + "type": "object" + }, + "ThreadRollbackResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "thread": { + "allOf": [ + { + "$ref": "#/definitions/v2/Thread" + } + ], + "description": "The updated thread after applying the rollback, with `turns` populated.\n\nThe ThreadItems stored in each Turn are lossy since we explicitly do not persist all agent interactions, such as command executions. This is the same behavior as `thread/resume`." + } + }, + "required": [ + "thread" + ], + "title": "ThreadRollbackResponse", + "type": "object" + }, + "ThreadSetNameParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "name": { + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "name", + "threadId" + ], + "title": "ThreadSetNameParams", + "type": "object" + }, + "ThreadSetNameResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadSetNameResponse", + "type": "object" + }, + "ThreadShellCommandParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "command": { + "description": "Shell command string evaluated by the thread's configured shell. Unlike `command/exec`, this intentionally preserves shell syntax such as pipes, redirects, and quoting. This runs unsandboxed with full access rather than inheriting the thread sandbox policy.", + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "command", + "threadId" + ], + "title": "ThreadShellCommandParams", + "type": "object" + }, + "ThreadShellCommandResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadShellCommandResponse", + "type": "object" + }, + "ThreadSortKey": { + "enum": [ + "created_at", + "updated_at" + ], + "type": "string" + }, + "ThreadSourceKind": { + "enum": [ + "cli", + "vscode", + "exec", + "appServer", + "subAgent", + "subAgentReview", + "subAgentCompact", + "subAgentThreadSpawn", + "subAgentOther", + "unknown" + ], + "type": "string" + }, + "ThreadStartParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "approvalPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AskForApproval" + }, + { + "type": "null" + } + ] + }, + "approvalsReviewer": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ApprovalsReviewer" + }, + { + "type": "null" + } + ], + "description": "Override where approval requests are routed for review on this thread and subsequent turns." + }, + "baseInstructions": { + "type": [ + "string", + "null" + ] + }, + "config": { + "additionalProperties": true, + "type": [ + "object", + "null" + ] + }, + "cwd": { + "type": [ + "string", + "null" + ] + }, + "developerInstructions": { + "type": [ + "string", + "null" + ] + }, + "ephemeral": { + "type": [ + "boolean", + "null" + ] + }, + "model": { + "type": [ + "string", + "null" + ] + }, + "modelProvider": { + "type": [ + "string", + "null" + ] + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/v2/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Full permissions override for this thread. Cannot be combined with `sandbox`." + }, + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/v2/Personality" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "anyOf": [ + { + "$ref": "#/definitions/v2/SandboxMode" + }, + { + "type": "null" + } + ] + }, + "serviceName": { + "type": [ + "string", + "null" + ] + }, + "serviceTier": { + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/v2/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "type": "null" + } + ] + }, + "sessionStartSource": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ThreadStartSource" + }, + { + "type": "null" + } + ] + } + }, + "title": "ThreadStartParams", + "type": "object" + }, + "ThreadStartResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "approvalPolicy": { + "$ref": "#/definitions/v2/AskForApproval" + }, + "approvalsReviewer": { + "allOf": [ + { + "$ref": "#/definitions/v2/ApprovalsReviewer" + } + ], + "description": "Reviewer currently used for approval requests on this thread." + }, + "cwd": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "instructionSources": { + "default": [], + "description": "Instruction source files currently loaded for this thread.", + "items": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "type": "array" + }, + "model": { + "type": "string" + }, + "modelProvider": { + "type": "string" + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/v2/PermissionProfile" + }, + { + "type": "null" + } + ], + "default": null, + "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`." + }, + "reasoningEffort": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ReasoningEffort" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "allOf": [ + { + "$ref": "#/definitions/v2/SandboxPolicy" + } + ], + "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view." + }, + "serviceTier": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ServiceTier" + }, + { + "type": "null" + } + ] + }, + "thread": { + "$ref": "#/definitions/v2/Thread" + } + }, + "required": [ + "approvalPolicy", + "approvalsReviewer", + "cwd", + "model", + "modelProvider", + "sandbox", + "thread" + ], + "title": "ThreadStartResponse", + "type": "object" + }, + "ThreadStartSource": { + "enum": [ + "startup", + "clear" + ], + "type": "string" + }, + "ThreadStartedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "thread": { + "$ref": "#/definitions/v2/Thread" + } + }, + "required": [ + "thread" + ], + "title": "ThreadStartedNotification", + "type": "object" + }, + "ThreadStatus": { + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "notLoaded" + ], + "title": "NotLoadedThreadStatusType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "idle" + ], + "title": "IdleThreadStatusType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "IdleThreadStatus", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "systemError" + ], + "title": "SystemErrorThreadStatusType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" + }, + { + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/v2/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, + "required": [ + "activeFlags", + "type" + ], + "title": "ActiveThreadStatus", + "type": "object" + } + ] + }, + "ThreadStatusChangedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "status": { + "$ref": "#/definitions/v2/ThreadStatus" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "status", + "threadId" + ], + "title": "ThreadStatusChangedNotification", + "type": "object" + }, + "ThreadTokenUsage": { + "properties": { + "last": { + "$ref": "#/definitions/v2/TokenUsageBreakdown" + }, + "modelAutoCompactTokenLimit": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "modelContextWindow": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "total": { + "$ref": "#/definitions/v2/TokenUsageBreakdown" + } + }, + "required": [ + "last", + "total" + ], + "type": "object" + }, + "ThreadTokenUsageUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + }, + "tokenUsage": { + "$ref": "#/definitions/v2/ThreadTokenUsage" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "threadId", + "tokenUsage", + "turnId" + ], + "title": "ThreadTokenUsageUpdatedNotification", + "type": "object" + }, + "ThreadTurnsListParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cursor": { + "description": "Opaque cursor to pass to the next call to continue after the last turn.", + "type": [ + "string", + "null" + ] + }, + "limit": { + "description": "Optional turn page size.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "sortDirection": { + "anyOf": [ + { + "$ref": "#/definitions/v2/SortDirection" + }, + { + "type": "null" + } + ], + "description": "Optional turn pagination direction; defaults to descending." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadTurnsListParams", + "type": "object" + }, + "ThreadTurnsListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "backwardsCursor": { + "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one turn. Use it with the opposite `sortDirection` to include the anchor turn again and catch updates to that turn.", + "type": [ + "string", + "null" + ] + }, + "data": { + "items": { + "$ref": "#/definitions/v2/Turn" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last turn. if None, there are no more turns to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ThreadTurnsListResponse", + "type": "object" + }, + "ThreadUnarchiveParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadUnarchiveParams", + "type": "object" + }, + "ThreadUnarchiveResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "thread": { + "$ref": "#/definitions/v2/Thread" + } + }, + "required": [ + "thread" + ], + "title": "ThreadUnarchiveResponse", + "type": "object" + }, + "ThreadUnarchivedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadUnarchivedNotification", + "type": "object" + }, + "ThreadUnsubscribeParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadUnsubscribeParams", + "type": "object" + }, + "ThreadUnsubscribeResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "status": { + "$ref": "#/definitions/v2/ThreadUnsubscribeStatus" + } + }, + "required": [ + "status" + ], + "title": "ThreadUnsubscribeResponse", + "type": "object" + }, + "ThreadUnsubscribeStatus": { + "enum": [ + "notLoaded", + "notSubscribed", + "unsubscribed" + ], + "type": "string" + }, + "TokenUsageBreakdown": { + "properties": { + "cachedInputTokens": { + "format": "int64", + "type": "integer" + }, + "inputTokens": { + "format": "int64", + "type": "integer" + }, + "outputTokens": { + "format": "int64", + "type": "integer" + }, + "reasoningOutputTokens": { + "format": "int64", + "type": "integer" + }, + "totalTokens": { + "format": "int64", + "type": "integer" + } + }, + "required": [ + "cachedInputTokens", + "inputTokens", + "outputTokens", + "reasoningOutputTokens", + "totalTokens" + ], + "type": "object" + }, + "Tool": { + "description": "Definition for a tool the client can call.", + "properties": { + "_meta": true, + "annotations": true, + "description": { + "type": [ + "string", + "null" + ] + }, + "icons": { + "items": true, + "type": [ + "array", + "null" + ] + }, + "inputSchema": true, + "name": { + "type": "string" + }, + "outputSchema": true, + "title": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "inputSchema", + "name" + ], + "type": "object" }, "ToolsV2": { - "type": "object", "properties": { "view_image": { "type": [ @@ -18317,27 +18326,670 @@ } ] } - } + }, + "type": "object" + }, + "Turn": { + "properties": { + "completedAt": { + "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "durationMs": { + "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "error": { + "anyOf": [ + { + "$ref": "#/definitions/v2/TurnError" + }, + { + "type": "null" + } + ], + "description": "Only populated when the Turn's status is failed." + }, + "id": { + "type": "string" + }, + "items": { + "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", + "items": { + "$ref": "#/definitions/v2/ThreadItem" + }, + "type": "array" + }, + "startedAt": { + "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "status": { + "$ref": "#/definitions/v2/TurnStatus" + } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" + }, + "TurnCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + }, + "turn": { + "$ref": "#/definitions/v2/Turn" + } + }, + "required": [ + "threadId", + "turn" + ], + "title": "TurnCompletedNotification", + "type": "object" + }, + "TurnDiffUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Notification that the turn-level unified diff has changed. Contains the latest aggregated diff across all file changes in the turn.", + "properties": { + "diff": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "diff", + "threadId", + "turnId" + ], + "title": "TurnDiffUpdatedNotification", + "type": "object" + }, + "TurnEnvironmentParams": { + "properties": { + "cwd": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "environmentId": { + "type": "string" + } + }, + "required": [ + "cwd", + "environmentId" + ], + "type": "object" + }, + "TurnError": { + "properties": { + "additionalDetails": { + "default": null, + "type": [ + "string", + "null" + ] + }, + "codexErrorInfo": { + "anyOf": [ + { + "$ref": "#/definitions/v2/CodexErrorInfo" + }, + { + "type": "null" + } + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "message" + ], + "type": "object" + }, + "TurnInterruptParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "threadId", + "turnId" + ], + "title": "TurnInterruptParams", + "type": "object" + }, + "TurnInterruptResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "TurnInterruptResponse", + "type": "object" + }, + "TurnPlanStep": { + "properties": { + "status": { + "$ref": "#/definitions/v2/TurnPlanStepStatus" + }, + "step": { + "type": "string" + } + }, + "required": [ + "status", + "step" + ], + "type": "object" + }, + "TurnPlanStepStatus": { + "enum": [ + "pending", + "inProgress", + "completed" + ], + "type": "string" + }, + "TurnPlanUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "explanation": { + "type": [ + "string", + "null" + ] + }, + "plan": { + "items": { + "$ref": "#/definitions/v2/TurnPlanStep" + }, + "type": "array" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "plan", + "threadId", + "turnId" + ], + "title": "TurnPlanUpdatedNotification", + "type": "object" + }, + "TurnStartParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "approvalPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AskForApproval" + }, + { + "type": "null" + } + ], + "description": "Override the approval policy for this turn and subsequent turns." + }, + "approvalsReviewer": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ApprovalsReviewer" + }, + { + "type": "null" + } + ], + "description": "Override where approval requests are routed for review on this turn and subsequent turns." + }, + "cwd": { + "description": "Override the working directory for this turn and subsequent turns.", + "type": [ + "string", + "null" + ] + }, + "effort": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ReasoningEffort" + }, + { + "type": "null" + } + ], + "description": "Override the reasoning effort for this turn and subsequent turns." + }, + "input": { + "items": { + "$ref": "#/definitions/v2/UserInput" + }, + "type": "array" + }, + "model": { + "description": "Override the model for this turn and subsequent turns.", + "type": [ + "string", + "null" + ] + }, + "outputSchema": { + "description": "Optional JSON Schema used to constrain the final assistant message for this turn." + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/v2/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Override the full permissions profile for this turn and subsequent turns. Cannot be combined with `sandboxPolicy`." + }, + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/v2/Personality" + }, + { + "type": "null" + } + ], + "description": "Override the personality for this turn and subsequent turns." + }, + "sandboxPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/v2/SandboxPolicy" + }, + { + "type": "null" + } + ], + "description": "Override the sandbox policy for this turn and subsequent turns." + }, + "serviceTier": { + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/v2/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "type": "null" + } + ], + "description": "Override the service tier for this turn and subsequent turns." + }, + "summary": { + "anyOf": [ + { + "$ref": "#/definitions/v2/ReasoningSummary" + }, + { + "type": "null" + } + ], + "description": "Override the reasoning summary for this turn and subsequent turns." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "input", + "threadId" + ], + "title": "TurnStartParams", + "type": "object" + }, + "TurnStartResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "turn": { + "$ref": "#/definitions/v2/Turn" + } + }, + "required": [ + "turn" + ], + "title": "TurnStartResponse", + "type": "object" + }, + "TurnStartedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + }, + "turn": { + "$ref": "#/definitions/v2/Turn" + } + }, + "required": [ + "threadId", + "turn" + ], + "title": "TurnStartedNotification", + "type": "object" + }, + "TurnStatus": { + "enum": [ + "completed", + "interrupted", + "failed", + "inProgress" + ], + "type": "string" + }, + "TurnSteerParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "expectedTurnId": { + "description": "Required active turn id precondition. The request fails when it does not match the currently active turn.", + "type": "string" + }, + "input": { + "items": { + "$ref": "#/definitions/v2/UserInput" + }, + "type": "array" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "expectedTurnId", + "input", + "threadId" + ], + "title": "TurnSteerParams", + "type": "object" + }, + "TurnSteerResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "turnId": { + "type": "string" + } + }, + "required": [ + "turnId" + ], + "title": "TurnSteerResponse", + "type": "object" + }, + "UserInput": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "text_elements": { + "default": [], + "description": "UI-defined spans within `text` used to render or persist special elements.", + "items": { + "$ref": "#/definitions/v2/TextElement" + }, + "type": "array" + }, + "type": { + "enum": [ + "text" + ], + "title": "TextUserInputType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "image" + ], + "title": "ImageUserInputType", + "type": "string" + }, + "url": { + "type": "string" + } + }, + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" + }, + { + "properties": { + "path": { + "type": "string" + }, + "type": { + "enum": [ + "localImage" + ], + "title": "LocalImageUserInputType", + "type": "string" + } + }, + "required": [ + "path", + "type" + ], + "title": "LocalImageUserInput", + "type": "object" + }, + { + "properties": { + "name": { + "type": "string" + }, + "path": { + "type": "string" + }, + "type": { + "enum": [ + "mention" + ], + "title": "MentionUserInputType", + "type": "string" + } + }, + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" + } + ] }, "Verbosity": { "description": "Controls output length/detail on GPT-5 models via the Responses API. Serialized with lowercase values to match the OpenAI API.", - "type": "string", "enum": [ "low", "medium", "high" + ], + "type": "string" + }, + "WarningNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "message": { + "description": "Concise warning message for the user.", + "type": "string" + }, + "threadId": { + "description": "Optional thread target when the warning applies to a specific thread.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "message" + ], + "title": "WarningNotification", + "type": "object" + }, + "WebSearchAction": { + "oneOf": [ + { + "properties": { + "queries": { + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "query": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "search" + ], + "title": "SearchWebSearchActionType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "openPage" + ], + "title": "OpenPageWebSearchActionType", + "type": "string" + }, + "url": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "type" + ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { + "properties": { + "pattern": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "findInPage" + ], + "title": "FindInPageWebSearchActionType", + "type": "string" + }, + "url": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "type" + ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "other" + ], + "title": "OtherWebSearchActionType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" + } ] }, "WebSearchContextSize": { - "type": "string", "enum": [ "low", "medium", "high" - ] + ], + "type": "string" }, "WebSearchLocation": { - "type": "object", + "additionalProperties": false, "properties": { "city": { "type": [ @@ -18364,27 +19016,27 @@ ] } }, - "additionalProperties": false + "type": "object" }, "WebSearchMode": { - "type": "string", "enum": [ "disabled", "cached", "live" - ] + ], + "type": "string" }, "WebSearchToolConfig": { - "type": "object", + "additionalProperties": false, "properties": { "allowed_domains": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "context_size": { "anyOf": [ @@ -18407,1216 +19059,109 @@ ] } }, - "additionalProperties": false + "type": "object" }, - "ConfigReadResponse": { + "WindowsSandboxSetupCompletedNotification": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigReadResponse", - "type": "object", - "required": [ - "config", - "origins" - ], "properties": { - "config": { - "$ref": "#/definitions/v2/Config" - }, - "layers": { + "error": { "type": [ - "array", + "string", "null" - ], - "items": { - "$ref": "#/definitions/v2/ConfigLayer" - } + ] }, - "origins": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/v2/ConfigLayerMetadata" - } + "mode": { + "$ref": "#/definitions/v2/WindowsSandboxSetupMode" + }, + "success": { + "type": "boolean" } - } - }, - "OverriddenMetadata": { - "type": "object", + }, "required": [ - "effectiveValue", - "message", - "overridingLayer" + "mode", + "success" ], + "title": "WindowsSandboxSetupCompletedNotification", + "type": "object" + }, + "WindowsSandboxSetupMode": { + "enum": [ + "elevated", + "unelevated" + ], + "type": "string" + }, + "WindowsSandboxSetupStartParams": { + "$schema": "http://json-schema.org/draft-07/schema#", "properties": { - "effectiveValue": true, - "message": { - "type": "string" + "cwd": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + { + "type": "null" + } + ] }, - "overridingLayer": { - "$ref": "#/definitions/v2/ConfigLayerMetadata" + "mode": { + "$ref": "#/definitions/v2/WindowsSandboxSetupMode" } - } + }, + "required": [ + "mode" + ], + "title": "WindowsSandboxSetupStartParams", + "type": "object" + }, + "WindowsSandboxSetupStartResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "started": { + "type": "boolean" + } + }, + "required": [ + "started" + ], + "title": "WindowsSandboxSetupStartResponse", + "type": "object" + }, + "WindowsWorldWritableWarningNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "extraCount": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "failedScan": { + "type": "boolean" + }, + "samplePaths": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "extraCount", + "failedScan", + "samplePaths" + ], + "title": "WindowsWorldWritableWarningNotification", + "type": "object" }, "WriteStatus": { - "type": "string", "enum": [ "ok", "okOverridden" - ] - }, - "ConfigWriteResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigWriteResponse", - "type": "object", - "required": [ - "filePath", - "status", - "version" ], - "properties": { - "filePath": { - "description": "Canonical path to the config file that was written.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - }, - "overriddenMetadata": { - "anyOf": [ - { - "$ref": "#/definitions/v2/OverriddenMetadata" - }, - { - "type": "null" - } - ] - }, - "status": { - "$ref": "#/definitions/v2/WriteStatus" - }, - "version": { - "type": "string" - } - } - }, - "ConfigRequirements": { - "type": "object", - "properties": { - "allowedApprovalPolicies": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/v2/AskForApproval" - } - }, - "featureRequirements": { - "type": [ - "object", - "null" - ], - "additionalProperties": { - "type": "boolean" - } - }, - "allowedSandboxModes": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/v2/SandboxMode" - } - }, - "allowedWebSearchModes": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/v2/WebSearchMode" - } - }, - "enforceResidency": { - "anyOf": [ - { - "$ref": "#/definitions/v2/ResidencyRequirement" - }, - { - "type": "null" - } - ] - } - } - }, - "NetworkDomainPermission": { - "type": "string", - "enum": [ - "allow", - "deny" - ] - }, - "NetworkRequirements": { - "type": "object", - "properties": { - "allowLocalBinding": { - "type": [ - "boolean", - "null" - ] - }, - "allowUnixSockets": { - "description": "Legacy compatibility view derived from `unix_sockets`.", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "allowUpstreamProxy": { - "type": [ - "boolean", - "null" - ] - }, - "allowedDomains": { - "description": "Legacy compatibility view derived from `domains`.", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "dangerouslyAllowAllUnixSockets": { - "type": [ - "boolean", - "null" - ] - }, - "dangerouslyAllowNonLoopbackProxy": { - "type": [ - "boolean", - "null" - ] - }, - "deniedDomains": { - "description": "Legacy compatibility view derived from `domains`.", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "domains": { - "description": "Canonical network permission map for `experimental_network`.", - "type": [ - "object", - "null" - ], - "additionalProperties": { - "$ref": "#/definitions/v2/NetworkDomainPermission" - } - }, - "enabled": { - "type": [ - "boolean", - "null" - ] - }, - "httpPort": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - }, - "managedAllowedDomainsOnly": { - "description": "When true, only managed allowlist entries are respected while managed network enforcement is active.", - "type": [ - "boolean", - "null" - ] - }, - "socksPort": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - }, - "unixSockets": { - "description": "Canonical unix socket permission map for `experimental_network`.", - "type": [ - "object", - "null" - ], - "additionalProperties": { - "$ref": "#/definitions/v2/NetworkUnixSocketPermission" - } - } - } - }, - "NetworkUnixSocketPermission": { - "type": "string", - "enum": [ - "allow", - "none" - ] - }, - "ResidencyRequirement": { - "type": "string", - "enum": [ - "us" - ] - }, - "ConfigRequirementsReadResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigRequirementsReadResponse", - "type": "object", - "properties": { - "requirements": { - "description": "Null if no requirements are configured (e.g. no requirements.toml/MDM entries).", - "anyOf": [ - { - "$ref": "#/definitions/v2/ConfigRequirements" - }, - { - "type": "null" - } - ] - } - } - }, - "Account": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "apiKey" - ], - "title": "ApiKeyAccountType" - } - }, - "title": "ApiKeyAccount" - }, - { - "type": "object", - "required": [ - "email", - "planType", - "type" - ], - "properties": { - "email": { - "type": "string" - }, - "planType": { - "$ref": "#/definitions/v2/PlanType" - }, - "type": { - "type": "string", - "enum": [ - "chatgpt" - ], - "title": "ChatgptAccountType" - } - }, - "title": "ChatgptAccount" - } - ] - }, - "GetAccountResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "GetAccountResponse", - "type": "object", - "required": [ - "requiresOpenaiAuth" - ], - "properties": { - "account": { - "anyOf": [ - { - "$ref": "#/definitions/v2/Account" - }, - { - "type": "null" - } - ] - }, - "requiresOpenaiAuth": { - "type": "boolean" - } - } - }, - "ErrorNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ErrorNotification", - "type": "object", - "required": [ - "error", - "threadId", - "turnId", - "willRetry" - ], - "properties": { - "error": { - "$ref": "#/definitions/v2/TurnError" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - }, - "willRetry": { - "type": "boolean" - } - } - }, - "ThreadStartedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadStartedNotification", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "$ref": "#/definitions/v2/Thread" - } - } - }, - "ThreadStatusChangedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadStatusChangedNotification", - "type": "object", - "required": [ - "status", - "threadId" - ], - "properties": { - "status": { - "$ref": "#/definitions/v2/ThreadStatus" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadArchivedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadArchivedNotification", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadUnarchivedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnarchivedNotification", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadClosedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadClosedNotification", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadNameUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadNameUpdatedNotification", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - }, - "threadName": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadTokenUsage": { - "type": "object", - "required": [ - "last", - "total" - ], - "properties": { - "last": { - "$ref": "#/definitions/v2/TokenUsageBreakdown" - }, - "modelAutoCompactTokenLimit": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "modelContextWindow": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "total": { - "$ref": "#/definitions/v2/TokenUsageBreakdown" - } - } - }, - "TokenUsageBreakdown": { - "type": "object", - "required": [ - "cachedInputTokens", - "inputTokens", - "outputTokens", - "reasoningOutputTokens", - "totalTokens" - ], - "properties": { - "cachedInputTokens": { - "type": "integer", - "format": "int64" - }, - "inputTokens": { - "type": "integer", - "format": "int64" - }, - "outputTokens": { - "type": "integer", - "format": "int64" - }, - "reasoningOutputTokens": { - "type": "integer", - "format": "int64" - }, - "totalTokens": { - "type": "integer", - "format": "int64" - } - } - }, - "ThreadTokenUsageUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadTokenUsageUpdatedNotification", - "type": "object", - "required": [ - "threadId", - "tokenUsage", - "turnId" - ], - "properties": { - "threadId": { - "type": "string" - }, - "tokenUsage": { - "$ref": "#/definitions/v2/ThreadTokenUsage" - }, - "turnId": { - "type": "string" - } - } - }, - "TurnStartedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnStartedNotification", - "type": "object", - "required": [ - "threadId", - "turn" - ], - "properties": { - "threadId": { - "type": "string" - }, - "turn": { - "$ref": "#/definitions/v2/Turn" - } - } - }, - "HookEventName": { - "type": "string", - "enum": [ - "preToolUse", - "permissionRequest", - "postToolUse", - "sessionStart", - "userPromptSubmit", - "stop" - ] - }, - "HookExecutionMode": { - "type": "string", - "enum": [ - "sync", - "async" - ] - }, - "HookHandlerType": { - "type": "string", - "enum": [ - "command", - "prompt", - "agent" - ] - }, - "HookOutputEntry": { - "type": "object", - "required": [ - "kind", - "text" - ], - "properties": { - "kind": { - "$ref": "#/definitions/v2/HookOutputEntryKind" - }, - "text": { - "type": "string" - } - } - }, - "HookOutputEntryKind": { - "type": "string", - "enum": [ - "warning", - "stop", - "feedback", - "context", - "error" - ] - }, - "HookRunStatus": { - "type": "string", - "enum": [ - "running", - "completed", - "failed", - "blocked", - "stopped" - ] - }, - "HookRunSummary": { - "type": "object", - "required": [ - "displayOrder", - "entries", - "eventName", - "executionMode", - "handlerType", - "id", - "scope", - "sourcePath", - "startedAt", - "status" - ], - "properties": { - "completedAt": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "displayOrder": { - "type": "integer", - "format": "int64" - }, - "durationMs": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/HookOutputEntry" - } - }, - "eventName": { - "$ref": "#/definitions/v2/HookEventName" - }, - "executionMode": { - "$ref": "#/definitions/v2/HookExecutionMode" - }, - "handlerType": { - "$ref": "#/definitions/v2/HookHandlerType" - }, - "id": { - "type": "string" - }, - "scope": { - "$ref": "#/definitions/v2/HookScope" - }, - "source": { - "default": "unknown", - "allOf": [ - { - "$ref": "#/definitions/v2/HookSource" - } - ] - }, - "sourcePath": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - "startedAt": { - "type": "integer", - "format": "int64" - }, - "status": { - "$ref": "#/definitions/v2/HookRunStatus" - }, - "statusMessage": { - "type": [ - "string", - "null" - ] - } - } - }, - "HookScope": { - "type": "string", - "enum": [ - "thread", - "turn" - ] - }, - "HookSource": { - "type": "string", - "enum": [ - "system", - "user", - "project", - "mdm", - "sessionFlags", - "legacyManagedConfigFile", - "legacyManagedConfigMdm", - "unknown" - ] - }, - "HookStartedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "HookStartedNotification", - "type": "object", - "required": [ - "run", - "threadId" - ], - "properties": { - "run": { - "$ref": "#/definitions/v2/HookRunSummary" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": [ - "string", - "null" - ] - } - } - }, - "TurnCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnCompletedNotification", - "type": "object", - "required": [ - "threadId", - "turn" - ], - "properties": { - "threadId": { - "type": "string" - }, - "turn": { - "$ref": "#/definitions/v2/Turn" - } - } - }, - "HookCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "HookCompletedNotification", - "type": "object", - "required": [ - "run", - "threadId" - ], - "properties": { - "run": { - "$ref": "#/definitions/v2/HookRunSummary" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": [ - "string", - "null" - ] - } - } - }, - "TurnDiffUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnDiffUpdatedNotification", - "description": "Notification that the turn-level unified diff has changed. Contains the latest aggregated diff across all file changes in the turn.", - "type": "object", - "required": [ - "diff", - "threadId", - "turnId" - ], - "properties": { - "diff": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "TurnPlanStep": { - "type": "object", - "required": [ - "status", - "step" - ], - "properties": { - "status": { - "$ref": "#/definitions/v2/TurnPlanStepStatus" - }, - "step": { - "type": "string" - } - } - }, - "TurnPlanStepStatus": { - "type": "string", - "enum": [ - "pending", - "inProgress", - "completed" - ] - }, - "TurnPlanUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnPlanUpdatedNotification", - "type": "object", - "required": [ - "plan", - "threadId", - "turnId" - ], - "properties": { - "explanation": { - "type": [ - "string", - "null" - ] - }, - "plan": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/TurnPlanStep" - } - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ItemStartedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ItemStartedNotification", - "type": "object", - "required": [ - "item", - "threadId", - "turnId" - ], - "properties": { - "item": { - "$ref": "#/definitions/v2/ThreadItem" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "AdditionalFileSystemPermissions": { - "type": "object", - "properties": { - "entries": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/v2/FileSystemSandboxEntry" - } - }, - "globScanMaxDepth": { - "type": [ - "integer", - "null" - ], - "format": "uint", - "minimum": 1.0 - }, - "read": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - }, - "write": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - } - } - }, - "AdditionalNetworkPermissions": { - "type": "object", - "properties": { - "enabled": { - "type": [ - "boolean", - "null" - ] - } - } + "type": "string" } - }, - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - }, - "InitializeResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "InitializeResponse", - "type": "object", - "required": [ - "codexHome", - "platformFamily", - "platformOs", - "userAgent" - ], - "properties": { - "codexHome": { - "description": "Absolute path to the server's $CODEX_HOME directory.", - "allOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - ] - }, - "platformFamily": { - "description": "Platform family for the running app-server target, for example `\"unix\"` or `\"windows\"`.", - "type": "string" - }, - "platformOs": { - "description": "Operating system for the running app-server target, for example `\"macos\"`, `\"linux\"`, or `\"windows\"`.", - "type": "string" - }, - "userAgent": { - "type": "string" - } - } - }, - "FuzzyFileSearchResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FuzzyFileSearchResponse", - "type": "object", - "required": [ - "files" - ], - "properties": { - "files": { - "type": "array", - "items": { - "$ref": "#/definitions/FuzzyFileSearchResult" - } - } - } - }, - "ChatgptAuthTokensRefreshResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ChatgptAuthTokensRefreshResponse", - "type": "object", - "required": [ - "accessToken", - "chatgptAccountId" - ], - "properties": { - "accessToken": { - "type": "string" - }, - "chatgptAccountId": { - "type": "string" - }, - "chatgptPlanType": { - "type": [ - "string", - "null" - ] - } - } - }, - "DynamicToolCallResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DynamicToolCallResponse", - "type": "object", - "required": [ - "contentItems", - "success" - ], - "properties": { - "contentItems": { - "type": "array", - "items": { - "$ref": "#/definitions/v2/DynamicToolCallOutputContentItem" - } - }, - "success": { - "type": "boolean" - } - } - }, - "PermissionsRequestApprovalResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "PermissionsRequestApprovalResponse", - "type": "object", - "required": [ - "permissions" - ], - "properties": { - "permissions": { - "$ref": "#/definitions/GrantedPermissionProfile" - }, - "scope": { - "default": "turn", - "allOf": [ - { - "$ref": "#/definitions/PermissionGrantScope" - } - ] - }, - "strictAutoReview": { - "description": "Review every subsequent command in this turn before normal sandboxed execution.", - "type": [ - "boolean", - "null" - ] - } - } - }, - "CommandExecutionRequestApprovalResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecutionRequestApprovalResponse", - "type": "object", - "required": [ - "decision" - ], - "properties": { - "decision": { - "$ref": "#/definitions/CommandExecutionApprovalDecision" - } - } - }, - "FileChangeApprovalDecision": { - "oneOf": [ - { - "description": "User approved the file changes.", - "type": "string", - "enum": [ - "accept" - ] - }, - { - "description": "User approved the file changes and future changes to the same files should run without prompting.", - "type": "string", - "enum": [ - "acceptForSession" - ] - }, - { - "description": "User denied the file changes. The agent will continue the turn.", - "type": "string", - "enum": [ - "decline" - ] - }, - { - "description": "User denied the file changes. The turn will also be immediately interrupted.", - "type": "string", - "enum": [ - "cancel" - ] - } - ] - }, - "FileChangeRequestApprovalResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FileChangeRequestApprovalResponse", - "type": "object", - "required": [ - "decision" - ], - "properties": { - "decision": { - "$ref": "#/definitions/FileChangeApprovalDecision" - } - } - }, - "ToolRequestUserInputAnswer": { - "description": "EXPERIMENTAL. Captures a user's answer to a request_user_input question.", - "type": "object", - "required": [ - "answers" - ], - "properties": { - "answers": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ToolRequestUserInputResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ToolRequestUserInputResponse", - "description": "EXPERIMENTAL. Response payload mapping question ids to answers.", - "type": "object", - "required": [ - "answers" - ], - "properties": { - "answers": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/ToolRequestUserInputAnswer" - } - } - } - }, - "McpServerElicitationAction": { - "type": "string", - "enum": [ - "accept", - "decline", - "cancel" - ] - }, - "McpServerElicitationRequestResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerElicitationRequestResponse", - "type": "object", - "required": [ - "action" - ], - "properties": { - "_meta": { - "description": "Optional client metadata for form-mode action handling." - }, - "action": { - "$ref": "#/definitions/McpServerElicitationAction" - }, - "content": { - "description": "Structured user input for accepted elicitations, mirroring RMCP `CreateElicitationResult`.\n\nThis is nullable because decline/cancel responses have no content." - } - } - }, - "GrantedPermissionProfile": { - "type": "object", - "properties": { - "fileSystem": { - "anyOf": [ - { - "$ref": "#/definitions/v2/AdditionalFileSystemPermissions" - }, - { - "type": "null" - } - ] - }, - "network": { - "anyOf": [ - { - "$ref": "#/definitions/v2/AdditionalNetworkPermissions" - }, - { - "type": "null" - } - ] - } - } - }, - "PermissionGrantScope": { - "type": "string", - "enum": [ - "turn", - "session" - ] } - } -} + }, + "title": "CodexAppServerProtocol", + "type": "object" +} \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json index 8512533c..ff9a3ba0 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json @@ -1,8780 +1,94 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CodexAppServerProtocolV2", - "type": "object", "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, - "ApprovalsReviewer": { - "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", - "type": "string", - "enum": [ - "user", - "auto_review", - "guardian_subagent" - ] - }, - "AskForApproval": { + "Account": { "oneOf": [ { - "type": "string", - "enum": [ - "untrusted", - "on-failure", - "on-request", - "never" - ] - }, - { - "type": "object", - "required": [ - "granular" - ], - "properties": { - "granular": { - "type": "object", - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "properties": { - "mcp_elicitations": { - "type": "boolean" - }, - "request_permissions": { - "default": false, - "type": "boolean" - }, - "rules": { - "type": "boolean" - }, - "sandbox_approval": { - "type": "boolean" - } - } - } - }, - "additionalProperties": false, - "title": "GranularAskForApproval" - } - ] - }, - "DynamicToolSpec": { - "type": "object", - "required": [ - "description", - "inputSchema", - "name" - ], - "properties": { - "deferLoading": { - "type": "boolean" - }, - "description": { - "type": "string" - }, - "inputSchema": true, - "name": { - "type": "string" - }, - "namespace": { - "type": [ - "string", - "null" - ] - } - } - }, - "FileSystemAccessMode": { - "type": "string", - "enum": [ - "read", - "write", - "none" - ] - }, - "FileSystemPath": { - "oneOf": [ - { - "type": "object", - "required": [ - "path", - "type" - ], - "properties": { - "path": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": { - "type": "string", - "enum": [ - "path" - ], - "title": "PathFileSystemPathType" - } - }, - "title": "PathFileSystemPath" - }, - { - "type": "object", - "required": [ - "pattern", - "type" - ], - "properties": { - "pattern": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "glob_pattern" - ], - "title": "GlobPatternFileSystemPathType" - } - }, - "title": "GlobPatternFileSystemPath" - }, - { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", - "enum": [ - "special" - ], - "title": "SpecialFileSystemPathType" - }, - "value": { - "$ref": "#/definitions/FileSystemSpecialPath" - } - }, - "title": "SpecialFileSystemPath" - } - ] - }, - "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], - "properties": { - "access": { - "$ref": "#/definitions/FileSystemAccessMode" - }, - "path": { - "$ref": "#/definitions/FileSystemPath" - } - } - }, - "FileSystemSpecialPath": { - "oneOf": [ - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "root" - ] - } - }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "minimal" - ] - } - }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "current_working_directory" - ] - } - }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "project_roots" - ] - }, - "subpath": { - "type": [ - "string", - "null" - ] - } - }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "tmpdir" - ] - } - }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind", - "path" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "unknown" - ] - }, - "path": { - "type": "string" - }, - "subpath": { - "type": [ - "string", - "null" - ] - } - } - } - ] - }, - "PermissionProfile": { - "type": "object", - "properties": { - "fileSystem": { - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfileFileSystemPermissions" - }, - { - "type": "null" - } - ] - }, - "network": { - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfileNetworkPermissions" - }, - { - "type": "null" - } - ] - } - } - }, - "PermissionProfileFileSystemPermissions": { - "type": "object", - "required": [ - "entries" - ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - } - }, - "globScanMaxDepth": { - "type": [ - "integer", - "null" - ], - "format": "uint", - "minimum": 1.0 - } - } - }, - "PermissionProfileNetworkPermissions": { - "type": "object", - "properties": { - "enabled": { - "type": [ - "boolean", - "null" - ] - } - } - }, - "Personality": { - "type": "string", - "enum": [ - "none", - "friendly", - "pragmatic" - ] - }, - "SandboxMode": { - "type": "string", - "enum": [ - "read-only", - "workspace-write", - "danger-full-access" - ] - }, - "ServiceTier": { - "type": "string", - "enum": [ - "fast", - "flex" - ] - }, - "ThreadStartSource": { - "type": "string", - "enum": [ - "startup", - "clear" - ] - }, - "ThreadStartParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadStartParams", - "type": "object", - "properties": { - "approvalPolicy": { - "anyOf": [ - { - "$ref": "#/definitions/AskForApproval" - }, - { - "type": "null" - } - ] - }, - "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this thread and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - }, - { - "type": "null" - } - ] - }, - "baseInstructions": { - "type": [ - "string", - "null" - ] - }, - "config": { - "type": [ - "object", - "null" - ], - "additionalProperties": true - }, - "cwd": { - "type": [ - "string", - "null" - ] - }, - "developerInstructions": { - "type": [ - "string", - "null" - ] - }, - "serviceTier": { - "anyOf": [ - { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - { - "type": "null" - } - ] - }, - "ephemeral": { - "type": [ - "boolean", - "null" - ] - }, - "sandbox": { - "anyOf": [ - { - "$ref": "#/definitions/SandboxMode" - }, - { - "type": "null" - } - ] - }, - "sessionStartSource": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadStartSource" - }, - { - "type": "null" - } - ] - }, - "model": { - "type": [ - "string", - "null" - ] - }, - "modelProvider": { - "type": [ - "string", - "null" - ] - }, - "permissionProfile": { - "description": "Full permissions override for this thread. Cannot be combined with `sandbox`.", - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "serviceName": { - "type": [ - "string", - "null" - ] - }, - "personality": { - "anyOf": [ - { - "$ref": "#/definitions/Personality" - }, - { - "type": "null" - } - ] - } - } - }, - "ContentItem": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "input_text" - ], - "title": "InputTextContentItemType" - } - }, - "title": "InputTextContentItem" - }, - { - "type": "object", - "required": [ - "image_url", - "type" - ], - "properties": { - "detail": { - "anyOf": [ - { - "$ref": "#/definitions/ImageDetail" - }, - { - "type": "null" - } - ] - }, - "image_url": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "input_image" - ], - "title": "InputImageContentItemType" - } - }, - "title": "InputImageContentItem" - }, - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "output_text" - ], - "title": "OutputTextContentItemType" - } - }, - "title": "OutputTextContentItem" - } - ] - }, - "FunctionCallOutputBody": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "array", - "items": { - "$ref": "#/definitions/FunctionCallOutputContentItem" - } - } - ] - }, - "FunctionCallOutputContentItem": { - "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.", - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "input_text" - ], - "title": "InputTextFunctionCallOutputContentItemType" - } - }, - "title": "InputTextFunctionCallOutputContentItem" - }, - { - "type": "object", - "required": [ - "image_url", - "type" - ], - "properties": { - "detail": { - "anyOf": [ - { - "$ref": "#/definitions/ImageDetail" - }, - { - "type": "null" - } - ] - }, - "image_url": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "input_image" - ], - "title": "InputImageFunctionCallOutputContentItemType" - } - }, - "title": "InputImageFunctionCallOutputContentItem" - } - ] - }, - "GhostCommit": { - "description": "Details of a ghost commit created from a repository state.", - "type": "object", - "required": [ - "id", - "preexisting_untracked_dirs", - "preexisting_untracked_files" - ], - "properties": { - "id": { - "type": "string" - }, - "parent": { - "type": [ - "string", - "null" - ] - }, - "preexisting_untracked_dirs": { - "type": "array", - "items": { - "type": "string" - } - }, - "preexisting_untracked_files": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ImageDetail": { - "type": "string", - "enum": [ - "auto", - "low", - "high", - "original" - ] - }, - "LocalShellAction": { - "oneOf": [ - { - "type": "object", - "required": [ - "command", - "type" - ], - "properties": { - "command": { - "type": "array", - "items": { - "type": "string" - } - }, - "env": { - "type": [ - "object", - "null" - ], - "additionalProperties": { - "type": "string" - } - }, - "timeout_ms": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "type": { - "type": "string", - "enum": [ - "exec" - ], - "title": "ExecLocalShellActionType" - }, - "user": { - "type": [ - "string", - "null" - ] - }, - "working_directory": { - "type": [ - "string", - "null" - ] - } - }, - "title": "ExecLocalShellAction" - } - ] - }, - "LocalShellStatus": { - "type": "string", - "enum": [ - "completed", - "in_progress", - "incomplete" - ] - }, - "MessagePhase": { - "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", - "oneOf": [ - { - "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", - "enum": [ - "commentary" - ] - }, - { - "description": "The assistant's terminal answer text for the current turn.", - "type": "string", - "enum": [ - "final_answer" - ] - } - ] - }, - "ReasoningItemContent": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "reasoning_text" - ], - "title": "ReasoningTextReasoningItemContentType" - } - }, - "title": "ReasoningTextReasoningItemContent" - }, - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "text" - ], - "title": "TextReasoningItemContentType" - } - }, - "title": "TextReasoningItemContent" - } - ] - }, - "ReasoningItemReasoningSummary": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "summary_text" - ], - "title": "SummaryTextReasoningItemReasoningSummaryType" - } - }, - "title": "SummaryTextReasoningItemReasoningSummary" - } - ] - }, - "ResponseItem": { - "oneOf": [ - { - "type": "object", - "required": [ - "content", - "role", - "type" - ], - "properties": { - "content": { - "type": "array", - "items": { - "$ref": "#/definitions/ContentItem" - } - }, - "end_turn": { - "type": [ - "boolean", - "null" - ] - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "phase": { - "anyOf": [ - { - "$ref": "#/definitions/MessagePhase" - }, - { - "type": "null" - } - ] - }, - "role": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "message" - ], - "title": "MessageResponseItemType" - } - }, - "title": "MessageResponseItem" - }, - { - "type": "object", - "required": [ - "summary", - "type" - ], - "properties": { - "content": { - "default": null, - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/ReasoningItemContent" - } - }, - "encrypted_content": { - "type": [ - "string", - "null" - ] - }, - "summary": { - "type": "array", - "items": { - "$ref": "#/definitions/ReasoningItemReasoningSummary" - } - }, - "type": { - "type": "string", - "enum": [ - "reasoning" - ], - "title": "ReasoningResponseItemType" - } - }, - "title": "ReasoningResponseItem" - }, - { - "type": "object", - "required": [ - "action", - "status", - "type" - ], - "properties": { - "action": { - "$ref": "#/definitions/LocalShellAction" - }, - "call_id": { - "description": "Set when using the Responses API.", - "type": [ - "string", - "null" - ] - }, - "id": { - "description": "Legacy id field retained for compatibility with older payloads.", - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "status": { - "$ref": "#/definitions/LocalShellStatus" - }, - "type": { - "type": "string", - "enum": [ - "local_shell_call" - ], - "title": "LocalShellCallResponseItemType" - } - }, - "title": "LocalShellCallResponseItem" - }, - { - "type": "object", - "required": [ - "arguments", - "call_id", - "name", - "type" - ], - "properties": { - "arguments": { - "type": "string" - }, - "call_id": { - "type": "string" - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "name": { - "type": "string" - }, - "namespace": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "function_call" - ], - "title": "FunctionCallResponseItemType" - } - }, - "title": "FunctionCallResponseItem" - }, - { - "type": "object", - "required": [ - "arguments", - "execution", - "type" - ], - "properties": { - "arguments": true, - "call_id": { - "type": [ - "string", - "null" - ] - }, - "execution": { - "type": "string" - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "status": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "tool_search_call" - ], - "title": "ToolSearchCallResponseItemType" - } - }, - "title": "ToolSearchCallResponseItem" - }, - { - "type": "object", - "required": [ - "call_id", - "output", - "type" - ], - "properties": { - "call_id": { - "type": "string" - }, - "output": { - "$ref": "#/definitions/FunctionCallOutputBody" - }, - "type": { - "type": "string", - "enum": [ - "function_call_output" - ], - "title": "FunctionCallOutputResponseItemType" - } - }, - "title": "FunctionCallOutputResponseItem" - }, - { - "type": "object", - "required": [ - "call_id", - "input", - "name", - "type" - ], - "properties": { - "call_id": { - "type": "string" - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "input": { - "type": "string" - }, - "name": { - "type": "string" - }, - "status": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "custom_tool_call" - ], - "title": "CustomToolCallResponseItemType" - } - }, - "title": "CustomToolCallResponseItem" - }, - { - "type": "object", - "required": [ - "call_id", - "output", - "type" - ], - "properties": { - "call_id": { - "type": "string" - }, - "name": { - "type": [ - "string", - "null" - ] - }, - "output": { - "$ref": "#/definitions/FunctionCallOutputBody" - }, - "type": { - "type": "string", - "enum": [ - "custom_tool_call_output" - ], - "title": "CustomToolCallOutputResponseItemType" - } - }, - "title": "CustomToolCallOutputResponseItem" - }, - { - "type": "object", - "required": [ - "execution", - "status", - "tools", - "type" - ], - "properties": { - "call_id": { - "type": [ - "string", - "null" - ] - }, - "execution": { - "type": "string" - }, - "status": { - "type": "string" - }, - "tools": { - "type": "array", - "items": true - }, - "type": { - "type": "string", - "enum": [ - "tool_search_output" - ], - "title": "ToolSearchOutputResponseItemType" - } - }, - "title": "ToolSearchOutputResponseItem" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "action": { - "anyOf": [ - { - "$ref": "#/definitions/ResponsesApiWebSearchAction" - }, - { - "type": "null" - } - ] - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "status": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "web_search_call" - ], - "title": "WebSearchCallResponseItemType" - } - }, - "title": "WebSearchCallResponseItem" - }, - { - "type": "object", - "required": [ - "id", - "result", - "status", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "result": { - "type": "string" - }, - "revised_prompt": { - "type": [ - "string", - "null" - ] - }, - "status": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "image_generation_call" - ], - "title": "ImageGenerationCallResponseItemType" - } - }, - "title": "ImageGenerationCallResponseItem" - }, - { - "type": "object", - "required": [ - "ghost_commit", - "type" - ], - "properties": { - "ghost_commit": { - "$ref": "#/definitions/GhostCommit" - }, - "type": { - "type": "string", - "enum": [ - "ghost_snapshot" - ], - "title": "GhostSnapshotResponseItemType" - } - }, - "title": "GhostSnapshotResponseItem" - }, - { - "type": "object", - "required": [ - "encrypted_content", - "type" - ], - "properties": { - "encrypted_content": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "compaction" - ], - "title": "CompactionResponseItemType" - } - }, - "title": "CompactionResponseItem" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "other" - ], - "title": "OtherResponseItemType" - } - }, - "title": "OtherResponseItem" - } - ] - }, - "ResponsesApiWebSearchAction": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "queries": { - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "query": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "search" - ], - "title": "SearchResponsesApiWebSearchActionType" - } - }, - "title": "SearchResponsesApiWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "open_page" - ], - "title": "OpenPageResponsesApiWebSearchActionType" - }, - "url": { - "type": [ - "string", - "null" - ] - } - }, - "title": "OpenPageResponsesApiWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "pattern": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "find_in_page" - ], - "title": "FindInPageResponsesApiWebSearchActionType" - }, - "url": { - "type": [ - "string", - "null" - ] - } - }, - "title": "FindInPageResponsesApiWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "other" - ], - "title": "OtherResponsesApiWebSearchActionType" - } - }, - "title": "OtherResponsesApiWebSearchAction" - } - ] - }, - "ThreadResumeParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadResumeParams", - "description": "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "approvalPolicy": { - "anyOf": [ - { - "$ref": "#/definitions/AskForApproval" - }, - { - "type": "null" - } - ] - }, - "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this thread and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - }, - { - "type": "null" - } - ] - }, - "baseInstructions": { - "type": [ - "string", - "null" - ] - }, - "config": { - "type": [ - "object", - "null" - ], - "additionalProperties": true - }, - "cwd": { - "type": [ - "string", - "null" - ] - }, - "developerInstructions": { - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - }, - "model": { - "description": "Configuration overrides for the resumed thread, if any.", - "type": [ - "string", - "null" - ] - }, - "modelProvider": { - "type": [ - "string", - "null" - ] - }, - "sandbox": { - "anyOf": [ - { - "$ref": "#/definitions/SandboxMode" - }, - { - "type": "null" - } - ] - }, - "permissionProfile": { - "description": "Full permissions override for the resumed thread. Cannot be combined with `sandbox`.", - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "serviceTier": { - "anyOf": [ - { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - { - "type": "null" - } - ] - }, - "personality": { - "anyOf": [ - { - "$ref": "#/definitions/Personality" - }, - { - "type": "null" - } - ] - } - } - }, - "ThreadForkParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadForkParams", - "description": "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "approvalPolicy": { - "anyOf": [ - { - "$ref": "#/definitions/AskForApproval" - }, - { - "type": "null" - } - ] - }, - "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this thread and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - }, - { - "type": "null" - } - ] - }, - "baseInstructions": { - "type": [ - "string", - "null" - ] - }, - "config": { - "type": [ - "object", - "null" - ], - "additionalProperties": true - }, - "cwd": { - "type": [ - "string", - "null" - ] - }, - "developerInstructions": { - "type": [ - "string", - "null" - ] - }, - "ephemeral": { - "type": "boolean" - }, - "model": { - "description": "Configuration overrides for the forked thread, if any.", - "type": [ - "string", - "null" - ] - }, - "modelProvider": { - "type": [ - "string", - "null" - ] - }, - "serviceTier": { - "anyOf": [ - { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - { - "type": "null" - } - ] - }, - "permissionProfile": { - "description": "Full permissions override for the forked thread. Cannot be combined with `sandbox`.", - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - }, - "sandbox": { - "anyOf": [ - { - "$ref": "#/definitions/SandboxMode" - }, - { - "type": "null" - } - ] - } - } - }, - "ThreadArchiveParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadArchiveParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadUnsubscribeParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnsubscribeParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "AccountLoginCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "AccountLoginCompletedNotification", - "type": "object", - "required": [ - "success" - ], - "properties": { - "error": { - "type": [ - "string", - "null" - ] - }, - "loginId": { - "type": [ - "string", - "null" - ] - }, - "success": { - "type": "boolean" - } - } - }, - "WindowsSandboxSetupCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WindowsSandboxSetupCompletedNotification", - "type": "object", - "required": [ - "mode", - "success" - ], - "properties": { - "error": { - "type": [ - "string", - "null" - ] - }, - "mode": { - "$ref": "#/definitions/WindowsSandboxSetupMode" - }, - "success": { - "type": "boolean" - } - } - }, - "ThreadSetNameParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadSetNameParams", - "type": "object", - "required": [ - "name", - "threadId" - ], - "properties": { - "name": { - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadMetadataGitInfoUpdateParams": { - "type": "object", - "properties": { - "branch": { - "description": "Omit to leave the stored branch unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", - "type": [ - "string", - "null" - ] - }, - "originUrl": { - "description": "Omit to leave the stored origin URL unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", - "type": [ - "string", - "null" - ] - }, - "sha": { - "description": "Omit to leave the stored commit unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadMetadataUpdateParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadMetadataUpdateParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "gitInfo": { - "description": "Patch the stored Git metadata for this thread. Omit a field to leave it unchanged, set it to `null` to clear it, or provide a string to replace the stored value.", - "anyOf": [ - { - "$ref": "#/definitions/ThreadMetadataGitInfoUpdateParams" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadMemoryMode": { - "type": "string", - "enum": [ - "enabled", - "disabled" - ] - }, - "WindowsWorldWritableWarningNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WindowsWorldWritableWarningNotification", - "type": "object", - "required": [ - "extraCount", - "failedScan", - "samplePaths" - ], - "properties": { - "extraCount": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "failedScan": { - "type": "boolean" - }, - "samplePaths": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ThreadUnarchiveParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnarchiveParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadCompactStartParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadCompactStartParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadShellCommandParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadShellCommandParams", - "type": "object", - "required": [ - "command", - "threadId" - ], - "properties": { - "command": { - "description": "Shell command string evaluated by the thread's configured shell. Unlike `command/exec`, this intentionally preserves shell syntax such as pipes, redirects, and quoting. This runs unsandboxed with full access rather than inheriting the thread sandbox policy.", - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadApproveGuardianDeniedActionParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadApproveGuardianDeniedActionParams", - "type": "object", - "required": [ - "event", - "threadId" - ], - "properties": { - "event": { - "description": "Serialized `codex_protocol::protocol::GuardianAssessmentEvent`." - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRealtimeClosedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeClosedNotification", - "description": "EXPERIMENTAL - emitted when thread realtime transport closes.", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "reason": { - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRollbackParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRollbackParams", - "type": "object", - "required": [ - "numTurns", - "threadId" - ], - "properties": { - "numTurns": { - "description": "The number of turns to drop from the end of the thread. Must be >= 1.\n\nThis only modifies the thread's history and does not revert local file changes that have been made by the agent. Clients are responsible for reverting these changes.", - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "threadId": { - "type": "string" - } - } - }, - "SortDirection": { - "type": "string", - "enum": [ - "asc", - "desc" - ] - }, - "ThreadListCwdFilter": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string" - } - } - ] - }, - "ThreadSortKey": { - "type": "string", - "enum": [ - "created_at", - "updated_at" - ] - }, - "ThreadSourceKind": { - "type": "string", - "enum": [ - "cli", - "vscode", - "exec", - "appServer", - "subAgent", - "subAgentReview", - "subAgentCompact", - "subAgentThreadSpawn", - "subAgentOther", - "unknown" - ] - }, - "ThreadListParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadListParams", - "type": "object", - "properties": { - "archived": { - "description": "Optional archived filter; when set to true, only archived threads are returned. If false or null, only non-archived threads are returned.", - "type": [ - "boolean", - "null" - ] - }, - "cursor": { - "description": "Opaque pagination cursor returned by a previous call.", - "type": [ - "string", - "null" - ] - }, - "cwd": { - "description": "Optional cwd filter or filters; when set, only threads whose session cwd exactly matches one of these paths are returned.", - "anyOf": [ - { - "$ref": "#/definitions/ThreadListCwdFilter" - }, - { - "type": "null" - } - ] - }, - "limit": { - "description": "Optional page size; defaults to a reasonable server-side value.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "modelProviders": { - "description": "Optional provider filter; when set, only sessions recorded under these providers are returned. When present but empty, includes all providers.", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "searchTerm": { - "description": "Optional substring filter for the extracted thread title.", - "type": [ - "string", - "null" - ] - }, - "sortDirection": { - "description": "Optional sort direction; defaults to descending (newest first).", - "anyOf": [ - { - "$ref": "#/definitions/SortDirection" - }, - { - "type": "null" - } - ] - }, - "sortKey": { - "description": "Optional sort key; defaults to created_at.", - "anyOf": [ - { - "$ref": "#/definitions/ThreadSortKey" - }, - { - "type": "null" - } - ] - }, - "sourceKinds": { - "description": "Optional source filter; when set, only sessions from these source kinds are returned. When omitted or empty, defaults to interactive sources.", - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/ThreadSourceKind" - } - }, - "useStateDbOnly": { - "description": "If true, return from the state DB without scanning JSONL rollouts to repair thread metadata. Omitted or false preserves scan-and-repair behavior.", - "type": "boolean" - } - } - }, - "ThreadLoadedListParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadLoadedListParams", - "type": "object", - "properties": { - "cursor": { - "description": "Opaque pagination cursor returned by a previous call.", - "type": [ - "string", - "null" - ] - }, - "limit": { - "description": "Optional page size; defaults to no limit.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ThreadReadParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadReadParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "includeTurns": { - "description": "When true, include turns and their items from rollout history.", - "default": false, - "type": "boolean" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyViewLens": { - "type": "string", - "enum": [ - "scene", - "jobs", - "roles", - "planning", - "pressure", - "reorient", - "crrc", - "coordinator" - ] - }, - "ThreadRealtimeErrorNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeErrorNotification", - "description": "EXPERIMENTAL - emitted when thread realtime encounters an error.", - "type": "object", - "required": [ - "message", - "threadId" - ], - "properties": { - "message": { - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyRoleId": { - "type": "string", - "enum": [ - "implementation", - "imagination", - "research", - "modeling", - "verification", - "reorientation" - ] - }, - "ThreadRealtimeSdpNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeSdpNotification", - "description": "EXPERIMENTAL - emitted with the remote SDP for a WebRTC realtime session.", - "type": "object", - "required": [ - "sdp", - "threadId" - ], - "properties": { - "sdp": { - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRealtimeOutputAudioDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeOutputAudioDeltaNotification", - "description": "EXPERIMENTAL - streamed output audio emitted by thread realtime.", - "type": "object", - "required": [ - "audio", - "threadId" - ], - "properties": { - "audio": { - "$ref": "#/definitions/ThreadRealtimeAudioChunk" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRealtimeTranscriptDoneNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeTranscriptDoneNotification", - "description": "EXPERIMENTAL - final transcript text emitted when realtime completes a transcript part.", - "type": "object", - "required": [ - "role", - "text", - "threadId" - ], - "properties": { - "role": { - "type": "string" - }, - "text": { - "description": "Final complete text for the transcript part.", - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRealtimeTranscriptDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeTranscriptDeltaNotification", - "description": "EXPERIMENTAL - flat transcript delta emitted whenever realtime transcript text changes.", - "type": "object", - "required": [ - "delta", - "role", - "threadId" - ], - "properties": { - "delta": { - "description": "Live transcript delta from the realtime event.", - "type": "string" - }, - "role": { - "type": "string" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadRealtimeItemAddedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeItemAddedNotification", - "description": "EXPERIMENTAL - raw non-audio thread realtime item emitted by the backend.", - "type": "object", - "required": [ - "item", - "threadId" - ], - "properties": { - "item": true, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyGraphQuery": { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "depth": { - "description": "Defaults to 1 and is capped by the server.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "direction": { - "description": "Defaults to `both`.", - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanyGraphQueryDirection" - }, - { - "type": "null" - } - ] - }, - "edgeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "edgeKinds": { - "type": "array", - "items": { - "type": "string" - } - }, - "includeLinks": { - "description": "Defaults to true so neighborhood queries preserve dataflow/architecture joins.", - "type": [ - "boolean", - "null" - ] - }, - "kind": { - "$ref": "#/definitions/ThreadEpiphanyGraphQueryKind" - }, - "nodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "paths": { - "type": "array", - "items": { - "type": "string" - } - }, - "symbols": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ThreadEpiphanyGraphQueryDirection": { - "type": "string", - "enum": [ - "incoming", - "outgoing", - "both" - ] - }, - "ThreadEpiphanyGraphQueryKind": { - "type": "string", - "enum": [ - "node", - "path", - "frontierNeighborhood", - "neighbors" - ] - }, - "ThreadRealtimeStartedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeStartedNotification", - "description": "EXPERIMENTAL - emitted when thread realtime startup is accepted.", - "type": "object", - "required": [ - "threadId", - "version" - ], - "properties": { - "sessionId": { - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - }, - "version": { - "$ref": "#/definitions/RealtimeConversationVersion" - } - } - }, - "RealtimeConversationVersion": { - "type": "string", - "enum": [ - "v1", - "v2" - ] - }, - "ThreadEpiphanyJobsUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadEpiphanyJobsUpdatedNotification", - "type": "object", - "required": [ - "source", - "threadId" - ], - "properties": { - "jobs": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanyJob" - } - }, - "source": { - "$ref": "#/definitions/ThreadEpiphanyJobsUpdatedSource" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyJobsUpdatedSource": { - "type": "string", - "enum": [ - "runtimeProgress" - ] - }, - "ThreadEpiphanyStateUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadEpiphanyStateUpdatedNotification", - "type": "object", - "required": [ - "changedFields", - "epiphanyState", - "revision", - "source", - "threadId" - ], - "properties": { - "changedFields": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanyStateUpdatedField" - } - }, - "epiphanyState": { - "$ref": "#/definitions/EpiphanyThreadState" - }, - "revision": { - "type": "integer", - "format": "uint64", - "minimum": 0.0 - }, - "source": { - "$ref": "#/definitions/ThreadEpiphanyStateUpdatedSource" - }, - "threadId": { - "type": "string" - } - } - }, - "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], - "properties": { - "end_line": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "note": { - "type": [ - "string", - "null" - ] - }, - "path": { - "type": "string" - }, - "start_line": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "symbol": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanyStateUpdatedSource": { - "type": "string", - "enum": [ - "update", - "promote", - "jobLaunch", - "jobInterrupt", - "reorientAccept", - "roleAccept" - ] - }, - "ConfigWarningNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigWarningNotification", - "type": "object", - "required": [ - "summary" - ], - "properties": { - "details": { - "description": "Optional extra guidance or error details.", - "type": [ - "string", - "null" - ] - }, - "path": { - "description": "Optional path to the config file that triggered the warning.", - "type": [ - "string", - "null" - ] - }, - "range": { - "description": "Optional range for the error location inside the config file.", - "anyOf": [ - { - "$ref": "#/definitions/TextRange" - }, - { - "type": "null" - } - ] - }, - "summary": { - "description": "Concise summary of the warning.", - "type": "string" - } - } - }, - "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], - "properties": { - "accepted_at": { - "type": "string" - }, - "accepted_evidence_id": { - "type": [ - "string", - "null" - ] - }, - "accepted_observation_id": { - "type": [ - "string", - "null" - ] - }, - "binding_id": { - "type": "string" - }, - "id": { - "type": "string" - }, - "job_id": { - "type": "string" - }, - "result_id": { - "type": "string" - }, - "role_id": { - "type": "string" - }, - "status": { - "type": "string" - }, - "summary": { - "type": [ - "string", - "null" - ] - }, - "surface": { - "type": "string" - } - } - }, - "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], - "properties": { - "acceptance_sketch": { - "type": "array", - "items": { - "type": "string" - } - }, - "blockers": { - "type": "array", - "items": { - "type": "string" - } - }, - "confidence": { - "type": "string" - }, - "dependencies": { - "type": "array", - "items": { - "type": "string" - } - }, - "duplicate_of": { - "type": [ - "string", - "null" - ] - }, - "evidence_refs": { - "type": "array", - "items": { - "type": "string" - } - }, - "horizon": { - "type": "string" - }, - "id": { - "type": "string" - }, - "kind": { - "type": "string" - }, - "lane_hints": { - "type": "array", - "items": { - "type": "string" - } - }, - "priority": { - "$ref": "#/definitions/EpiphanyPlanningPriority" - }, - "product_area": { - "type": "string" - }, - "source_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } - }, - "status": { - "type": "string" - }, - "summary": { - "type": "string" - }, - "title": { - "type": "string" - }, - "updated_at": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], - "properties": { - "diff_pressure": { - "type": "string" - }, - "graph_freshness": { - "type": [ - "string", - "null" - ] - }, - "understanding_status": { - "type": "string" - }, - "unexplained_writes": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "warning": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], - "properties": { - "code_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyCodeRef" - } - }, - "id": { - "type": "string" - }, - "kind": { - "type": "string" - }, - "status": { - "type": "string" - }, - "summary": { - "type": "string" - } - } - }, - "EpiphanyGraph": { - "type": "object", - "properties": { - "edges": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyGraphEdge" - } - }, - "nodes": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyGraphNode" - } - } - } - }, - "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], - "properties": { - "checkpoint_id": { - "type": "string" - }, - "frontier_node_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "graph_revision": { - "type": "integer", - "format": "uint64", - "minimum": 0.0 - }, - "open_gap_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "open_question_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], - "properties": { - "code_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyCodeRef" - } - }, - "id": { - "type": [ - "string", - "null" - ] - }, - "kind": { - "type": "string" - }, - "label": { - "type": [ - "string", - "null" - ] - }, - "mechanism": { - "type": [ - "string", - "null" - ] - }, - "source_id": { - "type": "string" - }, - "target_id": { - "type": "string" - } - } - }, - "EpiphanyGraphFrontier": { - "type": "object", - "properties": { - "active_edge_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "active_node_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "dirty_paths": { - "type": "array", - "items": { - "type": "string" - } - }, - "open_gap_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "open_question_ids": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], - "properties": { - "architecture_node_id": { - "type": "string" - }, - "code_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyCodeRef" - } - }, - "dataflow_node_id": { - "type": "string" - }, - "relationship": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], - "properties": { - "code_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyCodeRef" - } - }, - "id": { - "type": "string" - }, - "mechanism": { - "type": [ - "string", - "null" - ] - }, - "metaphor": { - "type": [ - "string", - "null" - ] - }, - "purpose": { - "type": "string" - }, - "status": { - "type": [ - "string", - "null" - ] - }, - "title": { - "type": "string" - } - } - }, - "EpiphanyGraphs": { - "type": "object", - "properties": { - "architecture": { - "$ref": "#/definitions/EpiphanyGraph" - }, - "dataflow": { - "$ref": "#/definitions/EpiphanyGraph" - }, - "links": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyGraphLink" - } - } - } - }, - "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], - "properties": { - "description": { - "type": "string" - }, - "id": { - "type": "string" - }, - "rationale": { - "type": [ - "string", - "null" - ] - }, - "status": { - "type": "string" - } - } - }, - "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], - "properties": { - "captured_at_turn_id": { - "type": [ - "string", - "null" - ] - }, - "checkpoint_id": { - "type": "string" - }, - "code_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyCodeRef" - } - }, - "disposition": { - "$ref": "#/definitions/EpiphanyInvestigationDisposition" - }, - "evidence_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "focus": { - "type": "string" - }, - "kind": { - "type": "string" - }, - "next_action": { - "type": [ - "string", - "null" - ] - }, - "open_questions": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyInvestigationDisposition": { - "type": "string", - "enum": [ - "resume_ready", - "regather_required" - ] - }, - "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], - "properties": { - "authority_scope": { - "type": [ - "string", - "null" - ] - }, - "blocking_reason": { - "type": [ - "string", - "null" - ] - }, - "id": { - "type": "string" - }, - "kind": { - "$ref": "#/definitions/EpiphanyJobKind" - }, - "linked_graph_node_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "linked_subgoal_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "owner_role": { - "type": "string" - }, - "scope": { - "type": "string" - } - } - }, - "EpiphanyJobKind": { - "type": "string", - "enum": [ - "indexing", - "remap", - "verification", - "specialist" - ] - }, - "EpiphanyModeKind": { - "type": "string", - "enum": [ - "plan", - "default" - ] - }, - "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], - "properties": { - "kind": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyModeKind" - }, - { - "type": "null" - } - ] - }, - "name": { - "type": "string" - } - } - }, - "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "properties": { - "acceptance_criteria": { - "type": "array", - "items": { - "type": "string" - } - }, - "dependencies": { - "type": "array", - "items": { - "type": "string" - } - }, - "evidence_required": { - "type": "array", - "items": { - "type": "string" - } - }, - "id": { - "type": "string" - }, - "lane_plan": { - "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" - }, - "review_gates": { - "type": "array", - "items": { - "type": "string" - } - }, - "risks": { - "type": "array", - "items": { - "type": "string" - } - }, - "scope": { - "$ref": "#/definitions/EpiphanyObjectiveDraftScope" - }, - "source_item_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "status": { - "type": "string" - }, - "summary": { - "type": "string" - }, - "title": { - "type": "string" - } - } - }, - "EpiphanyObjectiveDraftLanePlan": { - "type": "object", - "properties": { - "body": { - "type": [ - "string", - "null" - ] - }, - "eyes": { - "type": [ - "string", - "null" - ] - }, - "hands": { - "type": [ - "string", - "null" - ] - }, - "imagination": { - "type": [ - "string", - "null" - ] - }, - "life": { - "type": [ - "string", - "null" - ] - }, - "soul": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyObjectiveDraftScope": { - "type": "object", - "properties": { - "excludes": { - "type": "array", - "items": { - "type": "string" - } - }, - "includes": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "properties": { - "code_refs": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyCodeRef" - } - }, - "evidence_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "id": { - "type": "string" - }, - "source_kind": { - "type": "string" - }, - "status": { - "type": "string" - }, - "summary": { - "type": "string" - } - } - }, - "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], - "properties": { - "body": { - "type": [ - "string", - "null" - ] - }, - "confidence": { - "type": "string" - }, - "created_at": { - "type": [ - "string", - "null" - ] - }, - "id": { - "type": "string" - }, - "source": { - "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "speaker": { - "type": [ - "string", - "null" - ] - }, - "status": { - "type": "string" - }, - "tags": { - "type": "array", - "items": { - "type": "string" - } - }, - "title": { - "type": "string" - }, - "updated_at": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], - "properties": { - "blocks": { - "type": "array", - "items": { - "type": "string" - } - }, - "confidence": { - "type": [ - "string", - "null" - ] - }, - "effort": { - "type": [ - "string", - "null" - ] - }, - "impact": { - "type": [ - "string", - "null" - ] - }, - "rationale": { - "type": "string" - }, - "reason": { - "type": [ - "string", - "null" - ] - }, - "unblocks": { - "type": "array", - "items": { - "type": "string" - } - }, - "urgency": { - "type": [ - "string", - "null" - ] - }, - "value": { - "type": "string" - } - } - }, - "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "assignees": { - "type": "array", - "items": { - "type": "string" - } - }, - "author": { - "type": [ - "string", - "null" - ] - }, - "closed_at": { - "type": [ - "string", - "null" - ] - }, - "created_at": { - "type": [ - "string", - "null" - ] - }, - "database_id": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "external_id": { - "type": [ - "string", - "null" - ] - }, - "imported_at": { - "type": [ - "string", - "null" - ] - }, - "is_pull_request": { - "type": [ - "boolean", - "null" - ] - }, - "issue_number": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "kind": { - "type": "string" - }, - "labels": { - "type": "array", - "items": { - "type": "string" - } - }, - "milestone": { - "type": [ - "string", - "null" - ] - }, - "node_id": { - "type": [ - "string", - "null" - ] - }, - "provider": { - "type": [ - "string", - "null" - ] - }, - "repo": { - "type": [ - "string", - "null" - ] - }, - "state": { - "type": [ - "string", - "null" - ] - }, - "updated_at": { - "type": [ - "string", - "null" - ] - }, - "uri": { - "type": [ - "string", - "null" - ] - }, - "url": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyPlanningState": { - "type": "object", - "properties": { - "backlog_items": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyBacklogItem" - } - }, - "captures": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyPlanningCapture" - } - }, - "objective_drafts": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyObjectiveDraft" - } - }, - "roadmap_streams": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyRoadmapStream" - } - }, - "workspace_root": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], - "properties": { - "blocked_by": { - "type": "array", - "items": { - "type": "string" - } - }, - "id": { - "type": "string" - }, - "item_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "near_term_focus": { - "type": [ - "string", - "null" - ] - }, - "purpose": { - "type": "string" - }, - "review_cadence": { - "type": [ - "string", - "null" - ] - }, - "status": { - "type": "string" - }, - "title": { - "type": "string" - } - } - }, - "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "properties": { - "authority_scope": { - "type": "string" - }, - "binding_id": { - "type": "string" - }, - "id": { - "type": "string" - }, - "linked_graph_node_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "linked_subgoal_ids": { - "type": "array", - "items": { - "type": "string" - } - }, - "role_id": { - "type": "string" - }, - "runtime_job_id": { - "type": "string" - }, - "runtime_result_id": { - "type": [ - "string", - "null" - ] - }, - "surface": { - "type": "string" - } - } - }, - "EpiphanyScratchPad": { - "type": "object", - "properties": { - "hypothesis": { - "type": [ - "string", - "null" - ] - }, - "next_probe": { - "type": [ - "string", - "null" - ] - }, - "notes": { - "type": "array", - "items": { - "type": "string" - } - }, - "summary": { - "type": [ - "string", - "null" - ] - } - } - }, - "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], - "properties": { - "id": { - "type": "string" - }, - "status": { - "type": "string" - }, - "summary": { - "type": [ - "string", - "null" - ] - }, - "title": { - "type": "string" - } - } - }, - "ThreadEpiphanyUpdatePatch": { - "type": "object", - "properties": { - "acceptanceReceipts": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } - }, - "activeSubgoalId": { - "type": [ - "string", - "null" - ] - }, - "churn": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyChurnState" - }, - { - "type": "null" - } - ] - }, - "evidence": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyEvidenceRecord" - } - }, - "graphCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphCheckpoint" - }, - { - "type": "null" - } - ] - }, - "graphFrontier": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphFrontier" - }, - { - "type": "null" - } - ] - }, - "graphs": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphs" - }, - { - "type": "null" - } - ] - }, - "invariants": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/EpiphanyInvariant" - } - }, - "investigationCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "jobBindings": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/EpiphanyJobBinding" - } - }, - "mode": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyModeState" - }, - { - "type": "null" - } - ] - }, - "objective": { - "type": [ - "string", - "null" - ] - }, - "observations": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyObservation" - } - }, - "planning": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyPlanningState" - }, - { - "type": "null" - } - ] - }, - "runtimeLinks": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyRuntimeLink" - } - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "subgoals": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/EpiphanySubgoal" - } - } - } - }, - "TextRange": { - "type": "object", - "required": [ - "end", - "start" - ], - "properties": { - "end": { - "$ref": "#/definitions/TextPosition" - }, - "start": { - "$ref": "#/definitions/TextPosition" - } - } - }, - "ThreadEpiphanyWorkerLaunchDocument": { - "oneOf": [ - { - "type": "object", - "required": [ - "documentKind", - "roleId", - "stateRevision", - "threadId" - ], - "properties": { - "activeGraphNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "activeSubgoalId": { - "type": [ - "string", - "null" - ] - }, - "activeSubgoals": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanySubgoal" - } - }, - "churn": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyChurnState" - }, - { - "type": "null" - } - ] - }, - "documentKind": { - "type": "string", - "enum": [ - "role" - ] - }, - "graphCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphCheckpoint" - }, - { - "type": "null" - } - ] - }, - "graphFrontier": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphFrontier" - }, - { - "type": "null" - } - ] - }, - "graphs": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphs" - }, - { - "type": "null" - } - ] - }, - "invariants": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyInvariant" - } - }, - "investigationCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "objective": { - "type": [ - "string", - "null" - ] - }, - "planning": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyPlanningState" - }, - { - "type": "null" - } - ] - }, - "recentEvidence": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyEvidenceRecord" - } - }, - "recentObservations": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyObservation" - } - }, - "roleId": { - "type": "string" - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "stateRevision": { - "type": "integer", - "format": "uint64", - "minimum": 0.0 - }, - "threadId": { - "type": "string" - } - } - }, - { - "type": "object", - "required": [ - "checkpointDisposition", - "checkpointId", - "checkpointKind", - "checkpointNextAction", - "decisionNote", - "documentKind", - "graphStatus", - "mode", - "pressureLevel", - "retrievalStatus", - "threadId", - "watcherStatus" - ], - "properties": { - "activeFrontierNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointChangedPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointCodeRefs": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyCodeRef" - } - }, - "checkpointDirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointDisposition": { - "type": "string" - }, - "checkpointEvidenceIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointFocus": { - "type": [ - "string", - "null" - ] - }, - "checkpointId": { - "type": "string" - }, - "checkpointKind": { - "type": "string" - }, - "checkpointNextAction": { - "type": "string" - }, - "checkpointOpenQuestions": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointSummary": { - "type": [ - "string", - "null" - ] - }, - "decisionNote": { - "type": "string" - }, - "decisionReasons": { - "type": "array", - "items": { - "type": "string" - } - }, - "documentKind": { - "type": "string", - "enum": [ - "reorient" - ] - }, - "graphStatus": { - "type": "string" - }, - "graphs": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphs" - }, - { - "type": "null" - } - ] - }, - "linkedGraphNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "linkedSubgoalIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "mode": { - "type": "string" - }, - "pressureLevel": { - "type": "string" - }, - "recentEvidence": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyEvidenceRecord" - } - }, - "recentObservations": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyObservation" - } - }, - "retrievalStatus": { - "type": "string" - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - }, - "watcherStatus": { - "type": "string" - } - } - } - ] - }, - "TextPosition": { - "type": "object", - "required": [ - "column", - "line" - ], - "properties": { - "column": { - "description": "1-based column number (in Unicode scalar values).", - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "line": { - "description": "1-based line number.", - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } - }, - "DeprecationNoticeNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeprecationNoticeNotification", - "type": "object", - "required": [ - "summary" - ], - "properties": { - "details": { - "description": "Optional extra guidance, such as migration steps or rationale.", - "type": [ - "string", - "null" - ] - }, - "summary": { - "description": "Concise summary of what is deprecated.", - "type": "string" - } - } - }, - "GuardianWarningNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "GuardianWarningNotification", - "type": "object", - "required": [ - "message", - "threadId" - ], - "properties": { - "message": { - "description": "Concise guardian warning message for the user.", - "type": "string" - }, - "threadId": { - "description": "Thread target for the guardian warning.", - "type": "string" - } - } - }, - "WarningNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WarningNotification", - "type": "object", - "required": [ - "message" - ], - "properties": { - "message": { - "description": "Concise warning message for the user.", - "type": "string" - }, - "threadId": { - "description": "Optional thread target when the warning applies to a specific thread.", - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadTurnsListParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadTurnsListParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "cursor": { - "description": "Opaque cursor to pass to the next call to continue after the last turn.", - "type": [ - "string", - "null" - ] - }, - "limit": { - "description": "Optional turn page size.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "sortDirection": { - "description": "Optional turn pagination direction; defaults to descending.", - "anyOf": [ - { - "$ref": "#/definitions/SortDirection" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadInjectItemsParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadInjectItemsParams", - "type": "object", - "required": [ - "items", - "threadId" - ], - "properties": { - "items": { - "description": "Raw Responses API items to append to the thread's model-visible history.", - "type": "array", - "items": true - }, - "threadId": { - "type": "string" - } - } - }, - "DeviceKeyProtectionPolicy": { - "description": "Protection policy for creating or loading a controller-local device key.", - "type": "string", - "enum": [ - "hardware_only", - "allow_os_protected_nonextractable" - ] - }, - "DeviceKeyCreateParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeyCreateParams", - "description": "Create a controller-local device key with a random key id.", - "type": "object", - "required": [ - "accountUserId", - "clientId" - ], - "properties": { - "accountUserId": { - "type": "string" - }, - "clientId": { - "type": "string" - }, - "protectionPolicy": { - "description": "Defaults to `hardware_only` when omitted.", - "anyOf": [ - { - "$ref": "#/definitions/DeviceKeyProtectionPolicy" - }, - { - "type": "null" - } - ] - } - } - }, - "DeviceKeyPublicParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeyPublicParams", - "description": "Fetch a controller-local device key public key by id.", - "type": "object", - "required": [ - "keyId" - ], - "properties": { - "keyId": { - "type": "string" - } - } - }, - "DeviceKeySignPayload": { - "description": "Structured payloads accepted by `device/key/sign`.", - "oneOf": [ - { - "description": "Payload bound to one remote-control controller websocket `/client` connection challenge.", - "type": "object", - "required": [ - "accountUserId", - "audience", - "clientId", - "nonce", - "scopes", - "sessionId", - "targetOrigin", - "targetPath", - "tokenExpiresAt", - "tokenSha256Base64url", - "type" - ], - "properties": { - "accountUserId": { - "type": "string" - }, - "audience": { - "$ref": "#/definitions/RemoteControlClientConnectionAudience" - }, - "clientId": { - "type": "string" - }, - "nonce": { - "type": "string" - }, - "scopes": { - "description": "Must contain exactly `remote_control_controller_websocket`.", - "type": "array", - "items": { - "type": "string" - } - }, - "sessionId": { - "description": "Backend-issued websocket session id that this proof authorizes.", - "type": "string" - }, - "targetOrigin": { - "description": "Origin of the backend endpoint that issued the challenge and will verify this proof.", - "type": "string" - }, - "targetPath": { - "description": "Websocket route path that this proof authorizes.", - "type": "string" - }, - "tokenExpiresAt": { - "description": "Remote-control token expiration as Unix seconds.", - "type": "integer", - "format": "int64" - }, - "tokenSha256Base64url": { - "description": "SHA-256 of the controller-scoped remote-control token, encoded as unpadded base64url.", - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "remoteControlClientConnection" - ], - "title": "RemoteControlClientConnectionDeviceKeySignPayloadType" - } - }, - "title": "RemoteControlClientConnectionDeviceKeySignPayload" - }, - { - "description": "Payload bound to a remote-control client `/client/enroll` ownership challenge.", - "type": "object", - "required": [ - "accountUserId", - "audience", - "challengeExpiresAt", - "challengeId", - "clientId", - "deviceIdentitySha256Base64url", - "nonce", - "targetOrigin", - "targetPath", - "type" - ], - "properties": { - "accountUserId": { - "type": "string" - }, - "audience": { - "$ref": "#/definitions/RemoteControlClientEnrollmentAudience" - }, - "challengeExpiresAt": { - "description": "Enrollment challenge expiration as Unix seconds.", - "type": "integer", - "format": "int64" - }, - "challengeId": { - "description": "Backend-issued enrollment challenge id that this proof authorizes.", - "type": "string" - }, - "clientId": { - "type": "string" - }, - "deviceIdentitySha256Base64url": { - "description": "SHA-256 of the requested device identity operation, encoded as unpadded base64url.", - "type": "string" - }, - "nonce": { - "type": "string" - }, - "targetOrigin": { - "description": "Origin of the backend endpoint that issued the challenge and will verify this proof.", - "type": "string" - }, - "targetPath": { - "description": "HTTP route path that this proof authorizes.", - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "remoteControlClientEnrollment" - ], - "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType" - } - }, - "title": "RemoteControlClientEnrollmentDeviceKeySignPayload" - } - ] - }, - "RemoteControlClientConnectionAudience": { - "description": "Audience for a remote-control client connection device-key proof.", - "type": "string", - "enum": [ - "remote_control_client_websocket" - ] - }, - "RemoteControlClientEnrollmentAudience": { - "description": "Audience for a remote-control client enrollment device-key proof.", - "type": "string", - "enum": [ - "remote_control_client_enrollment" - ] - }, - "DeviceKeySignParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeySignParams", - "description": "Sign an accepted structured payload with a controller-local device key.", - "type": "object", - "required": [ - "keyId", - "payload" - ], - "properties": { - "keyId": { - "type": "string" - }, - "payload": { - "$ref": "#/definitions/DeviceKeySignPayload" - } - } - }, - "FsReadFileParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsReadFileParams", - "description": "Read a file from the host filesystem.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Absolute path to read.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - } - } - }, - "FsWriteFileParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsWriteFileParams", - "description": "Write a file on the host filesystem.", - "type": "object", - "required": [ - "dataBase64", - "path" - ], - "properties": { - "dataBase64": { - "description": "File contents encoded as base64.", - "type": "string" - }, - "path": { - "description": "Absolute path to write.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - } - } - }, - "FsCreateDirectoryParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsCreateDirectoryParams", - "description": "Create a directory on the host filesystem.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Absolute directory path to create.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - }, - "recursive": { - "description": "Whether parent directories should also be created. Defaults to `true`.", - "type": [ - "boolean", - "null" - ] - } - } - }, - "FsGetMetadataParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsGetMetadataParams", - "description": "Request metadata for an absolute path.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Absolute path to inspect.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - } - } - }, - "FsReadDirectoryParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsReadDirectoryParams", - "description": "List direct child names for a directory.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Absolute directory path to read.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - } - } - }, - "FsRemoveParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsRemoveParams", - "description": "Remove a file or directory tree from the host filesystem.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "force": { - "description": "Whether missing paths should be ignored. Defaults to `true`.", - "type": [ - "boolean", - "null" - ] - }, - "path": { - "description": "Absolute path to remove.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - }, - "recursive": { - "description": "Whether directory removal should recurse. Defaults to `true`.", - "type": [ - "boolean", - "null" - ] - } - } - }, - "FsCopyParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsCopyParams", - "description": "Copy a file or directory tree on the host filesystem.", - "type": "object", - "required": [ - "destinationPath", - "sourcePath" - ], - "properties": { - "destinationPath": { - "description": "Absolute destination path.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - }, - "recursive": { - "description": "Required for directory copies; ignored for file copies.", - "type": "boolean" - }, - "sourcePath": { - "description": "Absolute source path.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - } - } - }, - "FsWatchParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsWatchParams", - "description": "Start filesystem watch notifications for an absolute path.", - "type": "object", - "required": [ - "path", - "watchId" - ], - "properties": { - "path": { - "description": "Absolute file or directory path to watch.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - }, - "watchId": { - "description": "Connection-scoped watch identifier used for `fs/unwatch` and `fs/changed`.", - "type": "string" - } - } - }, - "FsUnwatchParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsUnwatchParams", - "description": "Stop filesystem watch notifications for a prior `fs/watch`.", - "type": "object", - "required": [ - "watchId" - ], - "properties": { - "watchId": { - "description": "Watch identifier previously provided to `fs/watch`.", - "type": "string" - } - } - }, - "ByteRange": { - "type": "object", - "required": [ - "end", - "start" - ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } - }, - "CollaborationMode": { - "description": "Collaboration mode for a Codex session.", - "type": "object", - "required": [ - "mode", - "settings" - ], - "properties": { - "mode": { - "$ref": "#/definitions/ModeKind" - }, - "settings": { - "$ref": "#/definitions/Settings" - } - } - }, - "ModeKind": { - "description": "Initial collaboration mode to use when the TUI starts.", - "type": "string", - "enum": [ - "plan", - "default" - ] - }, - "NetworkAccess": { - "type": "string", - "enum": [ - "restricted", - "enabled" - ] - }, - "ReadOnlyAccess": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "includePlatformDefaults": { - "default": true, - "type": "boolean" - }, - "readableRoots": { - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "type": { - "type": "string", - "enum": [ - "restricted" - ], - "title": "RestrictedReadOnlyAccessType" - } - }, - "title": "RestrictedReadOnlyAccess" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "fullAccess" - ], - "title": "FullAccessReadOnlyAccessType" - } - }, - "title": "FullAccessReadOnlyAccess" - } - ] - }, - "ReasoningEffort": { - "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", - "enum": [ - "none", - "minimal", - "low", - "medium", - "high", - "xhigh" - ] - }, - "ReasoningSummary": { - "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries", - "oneOf": [ - { - "type": "string", - "enum": [ - "auto", - "concise", - "detailed" - ] - }, - { - "description": "Option to disable reasoning summaries.", - "type": "string", - "enum": [ - "none" - ] - } - ] - }, - "SandboxPolicy": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "dangerFullAccess" - ], - "title": "DangerFullAccessSandboxPolicyType" - } - }, - "title": "DangerFullAccessSandboxPolicy" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "access": { - "default": { - "type": "fullAccess" - }, - "allOf": [ - { - "$ref": "#/definitions/ReadOnlyAccess" - } - ] - }, - "networkAccess": { - "default": false, - "type": "boolean" - }, - "type": { - "type": "string", - "enum": [ - "readOnly" - ], - "title": "ReadOnlySandboxPolicyType" - } - }, - "title": "ReadOnlySandboxPolicy" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "networkAccess": { - "default": "restricted", - "allOf": [ - { - "$ref": "#/definitions/NetworkAccess" - } - ] - }, - "type": { - "type": "string", - "enum": [ - "externalSandbox" - ], - "title": "ExternalSandboxSandboxPolicyType" - } - }, - "title": "ExternalSandboxSandboxPolicy" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "excludeSlashTmp": { - "default": false, - "type": "boolean" - }, - "excludeTmpdirEnvVar": { - "default": false, - "type": "boolean" - }, - "networkAccess": { - "default": false, - "type": "boolean" - }, - "readOnlyAccess": { - "default": { - "type": "fullAccess" - }, - "allOf": [ - { - "$ref": "#/definitions/ReadOnlyAccess" - } - ] - }, - "type": { - "type": "string", - "enum": [ - "workspaceWrite" - ], - "title": "WorkspaceWriteSandboxPolicyType" - }, - "writableRoots": { - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - } - }, - "title": "WorkspaceWriteSandboxPolicy" - } - ] - }, - "Settings": { - "description": "Settings for a collaboration mode.", - "type": "object", - "required": [ - "model" - ], - "properties": { - "developer_instructions": { - "type": [ - "string", - "null" - ] - }, - "model": { - "type": "string" - }, - "reasoning_effort": { - "anyOf": [ - { - "$ref": "#/definitions/ReasoningEffort" - }, - { - "type": "null" - } - ] - } - } - }, - "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], - "properties": { - "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", - "allOf": [ - { - "$ref": "#/definitions/ByteRange" - } - ] - }, - "placeholder": { - "description": "Optional human-readable placeholder for the element, displayed in the UI.", - "type": [ - "string", - "null" - ] - } - } - }, - "TurnEnvironmentParams": { - "type": "object", - "required": [ - "cwd", - "environmentId" - ], - "properties": { - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "environmentId": { - "type": "string" - } - } - }, - "UserInput": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/TextElement" - } - }, - "type": { - "type": "string", - "enum": [ - "text" - ], - "title": "TextUserInputType" - } - }, - "title": "TextUserInput" - }, - { - "type": "object", - "required": [ - "type", - "url" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "image" - ], - "title": "ImageUserInputType" - }, - "url": { - "type": "string" - } - }, - "title": "ImageUserInput" - }, - { - "type": "object", - "required": [ - "path", - "type" - ], - "properties": { - "path": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "localImage" - ], - "title": "LocalImageUserInputType" - } - }, - "title": "LocalImageUserInput" - }, - { - "type": "object", - "required": [ - "name", - "path", - "type" - ], - "properties": { - "name": { - "type": "string" - }, - "path": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "mention" - ], - "title": "MentionUserInputType" - } - }, - "title": "MentionUserInput" - } - ] - }, - "TurnStartParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnStartParams", - "type": "object", - "required": [ - "input", - "threadId" - ], - "properties": { - "approvalPolicy": { - "description": "Override the approval policy for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/AskForApproval" - }, - { - "type": "null" - } - ] - }, - "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - }, - "cwd": { - "description": "Override the working directory for this turn and subsequent turns.", - "type": [ - "string", - "null" - ] - }, - "effort": { - "description": "Override the reasoning effort for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "summary": { - "description": "Override the reasoning summary for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ReasoningSummary" - }, - { - "type": "null" - } - ] - }, - "input": { - "type": "array", - "items": { - "$ref": "#/definitions/UserInput" - } - }, - "model": { - "description": "Override the model for this turn and subsequent turns.", - "type": [ - "string", - "null" - ] - }, - "outputSchema": { - "description": "Optional JSON Schema used to constrain the final assistant message for this turn." - }, - "permissionProfile": { - "description": "Override the full permissions profile for this turn and subsequent turns. Cannot be combined with `sandboxPolicy`.", - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "personality": { - "description": "Override the personality for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/Personality" - }, - { - "type": "null" - } - ] - }, - "serviceTier": { - "description": "Override the service tier for this turn and subsequent turns.", - "anyOf": [ - { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - { - "type": "null" - } - ] - }, - "sandboxPolicy": { - "description": "Override the sandbox policy for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/SandboxPolicy" - }, - { - "type": "null" - } - ] - } - } - }, - "TurnSteerParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnSteerParams", - "type": "object", - "required": [ - "expectedTurnId", - "input", - "threadId" - ], - "properties": { - "expectedTurnId": { - "description": "Required active turn id precondition. The request fails when it does not match the currently active turn.", - "type": "string" - }, - "input": { - "type": "array", - "items": { - "$ref": "#/definitions/UserInput" - } - }, - "threadId": { - "type": "string" - } - } - }, - "TurnInterruptParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnInterruptParams", - "type": "object", - "required": [ - "threadId", - "turnId" - ], - "properties": { - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "RealtimeOutputModality": { - "type": "string", - "enum": [ - "text", - "audio" - ] - }, - "RealtimeVoice": { - "type": "string", - "enum": [ - "alloy", - "arbor", - "ash", - "ballad", - "breeze", - "cedar", - "coral", - "cove", - "echo", - "ember", - "juniper", - "maple", - "marin", - "sage", - "shimmer", - "sol", - "spruce", - "vale", - "verse" - ] - }, - "ThreadRealtimeStartTransport": { - "description": "EXPERIMENTAL - transport used by thread realtime.", - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "websocket" - ], - "title": "WebsocketThreadRealtimeStartTransportType" - } - }, - "title": "WebsocketThreadRealtimeStartTransport" - }, - { - "type": "object", - "required": [ - "sdp", - "type" - ], - "properties": { - "sdp": { - "description": "SDP offer generated by a WebRTC RTCPeerConnection after configuring audio and the realtime events data channel.", - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "webrtc" - ], - "title": "WebrtcThreadRealtimeStartTransportType" - } - }, - "title": "WebrtcThreadRealtimeStartTransport" - } - ] - }, - "ModelReroutedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ModelReroutedNotification", - "type": "object", - "required": [ - "fromModel", - "reason", - "threadId", - "toModel", - "turnId" - ], - "properties": { - "fromModel": { - "type": "string" - }, - "reason": { - "$ref": "#/definitions/ModelRerouteReason" - }, - "threadId": { - "type": "string" - }, - "toModel": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ThreadRealtimeAudioChunk": { - "description": "EXPERIMENTAL - thread realtime audio chunk.", - "type": "object", - "required": [ - "data", - "numChannels", - "sampleRate" - ], - "properties": { - "data": { - "type": "string" - }, - "itemId": { - "type": [ - "string", - "null" - ] - }, - "numChannels": { - "type": "integer", - "format": "uint16", - "minimum": 0.0 - }, - "sampleRate": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "samplesPerChannel": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ModelRerouteReason": { - "type": "string", - "enum": [ - "highRiskCyberActivity" - ] - }, - "ContextCompactedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ContextCompactedNotification", - "description": "Deprecated: Use `ContextCompaction` item type instead.", - "type": "object", - "required": [ - "threadId", - "turnId" - ], - "properties": { - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ReasoningTextDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReasoningTextDeltaNotification", - "type": "object", - "required": [ - "contentIndex", - "delta", - "itemId", - "threadId", - "turnId" - ], - "properties": { - "contentIndex": { - "type": "integer", - "format": "int64" - }, - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ReasoningSummaryPartAddedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReasoningSummaryPartAddedNotification", - "type": "object", - "required": [ - "itemId", - "summaryIndex", - "threadId", - "turnId" - ], - "properties": { - "itemId": { - "type": "string" - }, - "summaryIndex": { - "type": "integer", - "format": "int64" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ReviewDelivery": { - "type": "string", - "enum": [ - "inline", - "detached" - ] - }, - "ReviewTarget": { - "oneOf": [ - { - "description": "Review the working tree: staged, unstaged, and untracked files.", - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "uncommittedChanges" - ], - "title": "UncommittedChangesReviewTargetType" - } - }, - "title": "UncommittedChangesReviewTarget" - }, - { - "description": "Review changes between the current branch and the given base branch.", - "type": "object", - "required": [ - "branch", - "type" - ], - "properties": { - "branch": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "baseBranch" - ], - "title": "BaseBranchReviewTargetType" - } - }, - "title": "BaseBranchReviewTarget" - }, - { - "description": "Review the changes introduced by a specific commit.", - "type": "object", - "required": [ - "sha", - "type" - ], - "properties": { - "sha": { - "type": "string" - }, - "title": { - "description": "Optional human-readable label (e.g., commit subject) for UIs.", - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "commit" - ], - "title": "CommitReviewTargetType" - } - }, - "title": "CommitReviewTarget" - }, - { - "description": "Arbitrary instructions, equivalent to the old free-form prompt.", - "type": "object", - "required": [ - "instructions", - "type" - ], - "properties": { - "instructions": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "custom" - ], - "title": "CustomReviewTargetType" - } - }, - "title": "CustomReviewTarget" - } - ] - }, - "ReviewStartParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReviewStartParams", - "type": "object", - "required": [ - "target", - "threadId" - ], - "properties": { - "delivery": { - "description": "Where to run the review: inline (default) on the current thread or detached on a new thread (returned in `reviewThreadId`).", - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/ReviewDelivery" - }, - { - "type": "null" - } - ] - }, - "target": { - "$ref": "#/definitions/ReviewTarget" - }, - "threadId": { - "type": "string" - } - } - }, - "ModelListParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ModelListParams", - "type": "object", - "properties": { - "cursor": { - "description": "Opaque pagination cursor returned by a previous call.", - "type": [ - "string", - "null" - ] - }, - "includeHidden": { - "description": "When true, include models that are hidden from the default picker list.", - "type": [ - "boolean", - "null" - ] - }, - "limit": { - "description": "Optional page size; defaults to a reasonable server-side value.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ExperimentalFeatureListParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExperimentalFeatureListParams", - "type": "object", - "properties": { - "cursor": { - "description": "Opaque pagination cursor returned by a previous call.", - "type": [ - "string", - "null" - ] - }, - "limit": { - "description": "Optional page size; defaults to a reasonable server-side value.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ExperimentalFeatureEnablementSetParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExperimentalFeatureEnablementSetParams", - "type": "object", - "required": [ - "enablement" - ], - "properties": { - "enablement": { - "description": "Process-wide runtime feature enablement keyed by canonical feature name.\n\nOnly named features are updated. Omitted features are left unchanged. Send an empty map for a no-op.", - "type": "object", - "additionalProperties": { - "type": "boolean" - } - } - } - }, - "ReasoningSummaryTextDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReasoningSummaryTextDeltaNotification", - "type": "object", - "required": [ - "delta", - "itemId", - "summaryIndex", - "threadId", - "turnId" - ], - "properties": { - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "summaryIndex": { - "type": "integer", - "format": "int64" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "FsChangedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsChangedNotification", - "description": "Filesystem watch notification emitted for `fs/watch` subscribers.", - "type": "object", - "required": [ - "changedPaths", - "watchId" - ], - "properties": { - "changedPaths": { - "description": "File or directory paths associated with this event.", - "type": "array", - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "watchId": { - "description": "Watch identifier previously provided to `fs/watch`.", - "type": "string" - } - } - }, - "McpServerOauthLoginParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerOauthLoginParams", - "type": "object", - "required": [ - "name" - ], - "properties": { - "name": { - "type": "string" - }, - "scopes": { - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "timeoutSecs": { - "type": [ - "integer", - "null" - ], - "format": "int64" - } - } - }, - "McpServerStatusDetail": { - "type": "string", - "enum": [ - "full", - "toolsAndAuthOnly" - ] - }, - "ListMcpServerStatusParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ListMcpServerStatusParams", - "type": "object", - "properties": { - "cursor": { - "description": "Opaque pagination cursor returned by a previous call.", - "type": [ - "string", - "null" - ] - }, - "detail": { - "description": "Controls how much MCP inventory data to fetch for each server. Defaults to `Full` when omitted.", - "anyOf": [ - { - "$ref": "#/definitions/McpServerStatusDetail" - }, - { - "type": "null" - } - ] - }, - "limit": { - "description": "Optional page size; defaults to a server-defined value.", - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - } - } - }, - "McpResourceReadParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpResourceReadParams", - "type": "object", - "required": [ - "server", - "uri" - ], - "properties": { - "server": { - "type": "string" - }, - "threadId": { - "type": [ - "string", - "null" - ] - }, - "uri": { - "type": "string" - } - } - }, - "McpServerToolCallParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerToolCallParams", - "type": "object", - "required": [ - "server", - "threadId", - "tool" - ], - "properties": { - "_meta": true, - "arguments": true, - "server": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "tool": { - "type": "string" - } - } - }, - "WindowsSandboxSetupMode": { - "type": "string", - "enum": [ - "elevated", - "unelevated" - ] - }, - "WindowsSandboxSetupStartParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WindowsSandboxSetupStartParams", - "type": "object", - "required": [ - "mode" - ], - "properties": { - "cwd": { - "anyOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - }, - { - "type": "null" - } - ] - }, - "mode": { - "$ref": "#/definitions/WindowsSandboxSetupMode" - } - } - }, - "LoginAccountParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "LoginAccountParams", - "oneOf": [ - { - "type": "object", - "required": [ - "apiKey", - "type" - ], - "properties": { - "apiKey": { - "type": "string" - }, - "type": { - "type": "string", "enum": [ "apiKey" ], - "title": "ApiKeyv2::LoginAccountParamsType" + "title": "ApiKeyAccountType", + "type": "string" } }, - "title": "ApiKeyv2::LoginAccountParams" - }, - { - "type": "object", "required": [ "type" ], + "title": "ApiKeyAccount", + "type": "object" + }, + { "properties": { + "email": { + "type": "string" + }, + "planType": { + "$ref": "#/definitions/PlanType" + }, "type": { - "type": "string", "enum": [ "chatgpt" ], - "title": "Chatgptv2::LoginAccountParamsType" + "title": "ChatgptAccountType", + "type": "string" } }, - "title": "Chatgptv2::LoginAccountParams" - }, - { - "type": "object", "required": [ + "email", + "planType", "type" ], - "properties": { - "type": { - "type": "string", - "enum": [ - "chatgptDeviceCode" - ], - "title": "ChatgptDeviceCodev2::LoginAccountParamsType" - } - }, - "title": "ChatgptDeviceCodev2::LoginAccountParams" - }, - { - "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE. The access token must contain the same scopes that Codex-managed ChatGPT auth tokens have.", - "type": "object", - "required": [ - "accessToken", - "chatgptAccountId", - "type" - ], - "properties": { - "accessToken": { - "description": "Access token (JWT) supplied by the client. This token is used for backend API requests and email extraction.", - "type": "string" - }, - "chatgptAccountId": { - "description": "Workspace/account identifier supplied by the client.", - "type": "string" - }, - "chatgptPlanType": { - "description": "Optional plan type supplied by the client.\n\nWhen `null`, Codex attempts to derive the plan type from access-token claims. If unavailable, the plan defaults to `unknown`.", - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "chatgptAuthTokens" - ], - "title": "ChatgptAuthTokensv2::LoginAccountParamsType" - } - }, - "title": "ChatgptAuthTokensv2::LoginAccountParams" + "title": "ChatgptAccount", + "type": "object" } ] }, - "CancelLoginAccountParams": { + "AccountLoginCompletedNotification": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CancelLoginAccountParams", - "type": "object", - "required": [ - "loginId" - ], "properties": { - "loginId": { - "type": "string" - } - } - }, - "AddCreditsNudgeCreditType": { - "type": "string", - "enum": [ - "credits", - "usage_limit" - ] - }, - "SendAddCreditsNudgeEmailParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "SendAddCreditsNudgeEmailParams", - "type": "object", - "required": [ - "creditType" - ], - "properties": { - "creditType": { - "$ref": "#/definitions/AddCreditsNudgeCreditType" - } - } - }, - "FeedbackUploadParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FeedbackUploadParams", - "type": "object", - "required": [ - "classification", - "includeLogs" - ], - "properties": { - "classification": { - "type": "string" - }, - "extraLogFiles": { - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "includeLogs": { - "type": "boolean" - }, - "reason": { - "type": [ - "string", - "null" - ] - }, - "tags": { - "type": [ - "object", - "null" - ], - "additionalProperties": { - "type": "string" - } - }, - "threadId": { - "type": [ - "string", - "null" - ] - } - } - }, - "CommandExecTerminalSize": { - "description": "PTY size in character cells for `command/exec` PTY sessions.", - "type": "object", - "required": [ - "cols", - "rows" - ], - "properties": { - "cols": { - "description": "Terminal width in character cells.", - "type": "integer", - "format": "uint16", - "minimum": 0.0 - }, - "rows": { - "description": "Terminal height in character cells.", - "type": "integer", - "format": "uint16", - "minimum": 0.0 - } - } - }, - "CommandExecParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecParams", - "description": "Run a standalone command (argv vector) in the server sandbox without creating a thread or turn.\n\nThe final `command/exec` response is deferred until the process exits and is sent only after all `command/exec/outputDelta` notifications for that connection have been emitted.", - "type": "object", - "required": [ - "command" - ], - "properties": { - "command": { - "description": "Command argv vector. Empty arrays are rejected.", - "type": "array", - "items": { - "type": "string" - } - }, - "cwd": { - "description": "Optional working directory. Defaults to the server cwd.", - "type": [ - "string", - "null" - ] - }, - "disableOutputCap": { - "description": "Disable stdout/stderr capture truncation for this request.\n\nCannot be combined with `outputBytesCap`.", - "type": "boolean" - }, - "disableTimeout": { - "description": "Disable the timeout entirely for this request.\n\nCannot be combined with `timeoutMs`.", - "type": "boolean" - }, - "env": { - "description": "Optional environment overrides merged into the server-computed environment.\n\nMatching names override inherited values. Set a key to `null` to unset an inherited variable.", - "type": [ - "object", - "null" - ], - "additionalProperties": { - "type": [ - "string", - "null" - ] - } - }, - "outputBytesCap": { - "description": "Optional per-stream stdout/stderr capture cap in bytes.\n\nWhen omitted, the server default applies. Cannot be combined with `disableOutputCap`.", - "type": [ - "integer", - "null" - ], - "format": "uint", - "minimum": 0.0 - }, - "processId": { - "description": "Optional client-supplied, connection-scoped process id.\n\nRequired for `tty`, `streamStdin`, `streamStdoutStderr`, and follow-up `command/exec/write`, `command/exec/resize`, and `command/exec/terminate` calls. When omitted, buffered execution gets an internal id that is not exposed to the client.", - "type": [ - "string", - "null" - ] - }, - "sandboxPolicy": { - "description": "Optional sandbox policy for this command.\n\nUses the same shape as thread/turn execution sandbox configuration and defaults to the user's configured policy when omitted.", - "anyOf": [ - { - "$ref": "#/definitions/SandboxPolicy" - }, - { - "type": "null" - } - ] - }, - "size": { - "description": "Optional initial PTY size in character cells. Only valid when `tty` is true.", - "anyOf": [ - { - "$ref": "#/definitions/CommandExecTerminalSize" - }, - { - "type": "null" - } - ] - }, - "streamStdin": { - "description": "Allow follow-up `command/exec/write` requests to write stdin bytes.\n\nRequires a client-supplied `processId`.", - "type": "boolean" - }, - "streamStdoutStderr": { - "description": "Stream stdout/stderr via `command/exec/outputDelta` notifications.\n\nStreamed bytes are not duplicated into the final response and require a client-supplied `processId`.", - "type": "boolean" - }, - "timeoutMs": { - "description": "Optional timeout in milliseconds.\n\nWhen omitted, the server default applies. Cannot be combined with `disableTimeout`.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "tty": { - "description": "Enable PTY mode.\n\nThis implies `streamStdin` and `streamStdoutStderr`.", - "type": "boolean" - } - } - }, - "CommandExecWriteParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecWriteParams", - "description": "Write stdin bytes to a running `command/exec` session, close stdin, or both.", - "type": "object", - "required": [ - "processId" - ], - "properties": { - "closeStdin": { - "description": "Close stdin after writing `deltaBase64`, if present.", - "type": "boolean" - }, - "deltaBase64": { - "description": "Optional base64-encoded stdin bytes to write.", - "type": [ - "string", - "null" - ] - }, - "processId": { - "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", - "type": "string" - } - } - }, - "CommandExecTerminateParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecTerminateParams", - "description": "Terminate a running `command/exec` session.", - "type": "object", - "required": [ - "processId" - ], - "properties": { - "processId": { - "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", - "type": "string" - } - } - }, - "CommandExecResizeParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecResizeParams", - "description": "Resize a running PTY-backed `command/exec` session.", - "type": "object", - "required": [ - "processId", - "size" - ], - "properties": { - "processId": { - "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", - "type": "string" - }, - "size": { - "description": "New PTY size in character cells.", - "allOf": [ - { - "$ref": "#/definitions/CommandExecTerminalSize" - } - ] - } - } - }, - "ConfigReadParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigReadParams", - "type": "object", - "properties": { - "cwd": { - "description": "Optional working directory to resolve project config layers. If specified, return the effective config as seen from that directory (i.e., including any project layers between `cwd` and the project/repo root).", - "type": [ - "string", - "null" - ] - }, - "includeLayers": { - "default": false, - "type": "boolean" - } - } - }, - "MergeStrategy": { - "type": "string", - "enum": [ - "replace", - "upsert" - ] - }, - "ConfigValueWriteParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigValueWriteParams", - "type": "object", - "required": [ - "keyPath", - "mergeStrategy", - "value" - ], - "properties": { - "expectedVersion": { - "type": [ - "string", - "null" - ] - }, - "filePath": { - "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.", - "type": [ - "string", - "null" - ] - }, - "keyPath": { - "type": "string" - }, - "mergeStrategy": { - "$ref": "#/definitions/MergeStrategy" - }, - "value": true - } - }, - "ConfigEdit": { - "type": "object", - "required": [ - "keyPath", - "mergeStrategy", - "value" - ], - "properties": { - "keyPath": { - "type": "string" - }, - "mergeStrategy": { - "$ref": "#/definitions/MergeStrategy" - }, - "value": true - } - }, - "ConfigBatchWriteParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigBatchWriteParams", - "type": "object", - "required": [ - "edits" - ], - "properties": { - "edits": { - "type": "array", - "items": { - "$ref": "#/definitions/ConfigEdit" - } - }, - "expectedVersion": { - "type": [ - "string", - "null" - ] - }, - "filePath": { - "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.", - "type": [ - "string", - "null" - ] - }, - "reloadUserConfig": { - "description": "When true, hot-reload the updated user config into all loaded threads after writing.", - "type": "boolean" - } - } - }, - "GetAccountParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "GetAccountParams", - "type": "object", - "properties": { - "refreshToken": { - "description": "When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.", - "default": false, - "type": "boolean" - } - } - }, - "AgentPath": { - "type": "string" - }, - "CodexErrorInfo": { - "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", - "oneOf": [ - { - "type": "string", - "enum": [ - "contextWindowExceeded", - "usageLimitExceeded", - "serverOverloaded", - "internalServerError", - "unauthorized", - "badRequest", - "threadRollbackFailed", - "sandboxError", - "other" - ] - }, - { - "type": "object", - "required": [ - "httpConnectionFailed" - ], - "properties": { - "httpConnectionFailed": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", - "required": [ - "responseStreamConnectionFailed" - ], - "properties": { - "responseStreamConnectionFailed": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", - "required": [ - "responseStreamDisconnected" - ], - "properties": { - "responseStreamDisconnected": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", - "required": [ - "responseTooManyFailedAttempts" - ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" - }, - { - "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], - "properties": { - "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], - "properties": { - "turnKind": { - "$ref": "#/definitions/NonSteerableTurnKind" - } - } - } - }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" - } - ] - }, - "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], - "properties": { - "message": { - "type": [ - "string", - "null" - ] - }, - "status": { - "$ref": "#/definitions/CollabAgentStatus" - } - } - }, - "CollabAgentStatus": { - "type": "string", - "enum": [ - "pendingInit", - "running", - "interrupted", - "completed", - "errored", - "shutdown", - "notFound" - ] - }, - "CollabAgentTool": { - "type": "string", - "enum": [ - "spawnAgent", - "sendInput", - "resumeAgent", - "wait", - "closeAgent" - ] - }, - "CollabAgentToolCallStatus": { - "type": "string", - "enum": [ - "inProgress", - "completed", - "failed" - ] - }, - "CommandAction": { - "oneOf": [ - { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], - "properties": { - "command": { - "type": "string" - }, - "name": { - "type": "string" - }, - "path": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": { - "type": "string", - "enum": [ - "read" - ], - "title": "ReadCommandActionType" - } - }, - "title": "ReadCommandAction" - }, - { - "type": "object", - "required": [ - "command", - "type" - ], - "properties": { - "command": { - "type": "string" - }, - "path": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "listFiles" - ], - "title": "ListFilesCommandActionType" - } - }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", - "required": [ - "command", - "type" - ], - "properties": { - "command": { - "type": "string" - }, - "path": { - "type": [ - "string", - "null" - ] - }, - "query": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "search" - ], - "title": "SearchCommandActionType" - } - }, - "title": "SearchCommandAction" - }, - { - "type": "object", - "required": [ - "command", - "type" - ], - "properties": { - "command": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "unknown" - ], - "title": "UnknownCommandActionType" - } - }, - "title": "UnknownCommandAction" - } - ] - }, - "CommandExecutionSource": { - "type": "string", - "enum": [ - "agent", - "userShell", - "unifiedExecStartup", - "unifiedExecInteraction" - ] - }, - "CommandExecutionStatus": { - "type": "string", - "enum": [ - "inProgress", - "completed", - "failed", - "declined" - ] - }, - "DynamicToolCallOutputContentItem": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "inputText" - ], - "title": "InputTextDynamicToolCallOutputContentItemType" - } - }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", - "required": [ - "imageUrl", - "type" - ], - "properties": { - "imageUrl": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "inputImage" - ], - "title": "InputImageDynamicToolCallOutputContentItemType" - } - }, - "title": "InputImageDynamicToolCallOutputContentItem" - } - ] - }, - "DynamicToolCallStatus": { - "type": "string", - "enum": [ - "inProgress", - "completed", - "failed" - ] - }, - "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], - "properties": { - "exact_available": { - "type": "boolean" - }, - "indexed_chunk_count": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "indexed_file_count": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "path_prefix": { - "type": "string" - }, - "semantic_available": { - "type": "boolean" - }, - "shard_id": { - "type": "string" - }, - "status": { - "default": "unavailable", - "allOf": [ - { - "$ref": "#/definitions/EpiphanyRetrievalStatus" - } - ] - } - } - }, - "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], - "properties": { - "dirty_paths": { - "type": "array", - "items": { - "type": "string" - } - }, - "index_revision": { - "type": [ - "string", - "null" - ] - }, - "indexed_chunk_count": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "indexed_file_count": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "last_indexed_at_unix_seconds": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "semantic_available": { - "type": "boolean" - }, - "shards": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyRetrievalShardSummary" - } - }, - "status": { - "default": "unavailable", - "allOf": [ - { - "$ref": "#/definitions/EpiphanyRetrievalStatus" - } - ] - }, - "workspace_root": { - "type": "string" - } - } - }, - "EpiphanyRetrievalStatus": { - "type": "string", - "enum": [ - "unavailable", - "ready", - "stale", - "indexing" - ] - }, - "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], - "properties": { - "acceptance_receipts": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } - }, - "active_subgoal_id": { - "type": [ - "string", - "null" - ] - }, - "churn": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyChurnState" - }, - { - "type": "null" - } - ] - }, - "graph_checkpoint": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphCheckpoint" - }, - { - "type": "null" - } - ] - }, - "graph_frontier": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphFrontier" - }, - { - "type": "null" - } - ] - }, - "graphs": { - "$ref": "#/definitions/EpiphanyGraphs" - }, - "invariants": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyInvariant" - } - }, - "investigation_checkpoint": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "job_bindings": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyJobBinding" - } - }, - "last_updated_turn_id": { - "type": [ - "string", - "null" - ] - }, - "mode": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyModeState" - }, - { - "type": "null" - } - ] - }, - "objective": { - "type": [ - "string", - "null" - ] - }, - "observations": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyObservation" - } - }, - "planning": { - "$ref": "#/definitions/EpiphanyPlanningState" - }, - "recent_evidence": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyEvidenceRecord" - } - }, - "retrieval": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyRetrievalState" - }, - { - "type": "null" - } - ] - }, - "revision": { - "type": "integer", - "format": "uint64", - "minimum": 0.0 - }, - "runtime_links": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyRuntimeLink" - } - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "subgoals": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanySubgoal" - } - } - } - }, - "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], - "properties": { - "diff": { - "type": "string" - }, - "kind": { - "$ref": "#/definitions/PatchChangeKind" - }, - "path": { - "type": "string" - } - } - }, - "GitInfo": { - "type": "object", - "properties": { - "branch": { - "type": [ - "string", - "null" - ] - }, - "originUrl": { - "type": [ - "string", - "null" - ] - }, - "sha": { - "type": [ - "string", - "null" - ] - } - } - }, - "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], - "properties": { - "hookRunId": { - "type": "string" - }, - "text": { - "type": "string" - } - } - }, - "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], - "properties": { - "message": { - "type": "string" - } - } - }, - "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], - "properties": { - "_meta": true, - "content": { - "type": "array", - "items": true - }, - "structuredContent": true - } - }, - "McpToolCallStatus": { - "type": "string", - "enum": [ - "inProgress", - "completed", - "failed" - ] - }, - "MemoryCitation": { - "type": "object", - "required": [ - "entries", - "threadIds" - ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], - "properties": { - "lineEnd": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "lineStart": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "note": { - "type": "string" - }, - "path": { - "type": "string" - } - } - }, - "NonSteerableTurnKind": { - "type": "string", - "enum": [ - "review", - "compact" - ] - }, - "PatchApplyStatus": { - "type": "string", - "enum": [ - "inProgress", - "completed", - "failed", - "declined" - ] - }, - "PatchChangeKind": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "add" - ], - "title": "AddPatchChangeKindType" - } - }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "delete" - ], - "title": "DeletePatchChangeKindType" - } - }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "move_path": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "update" - ], - "title": "UpdatePatchChangeKindType" - } - }, - "title": "UpdatePatchChangeKind" - } - ] - }, - "SessionSource": { - "oneOf": [ - { - "type": "string", - "enum": [ - "cli", - "vscode", - "exec", - "appServer", - "unknown" - ] - }, - { - "type": "object", - "required": [ - "custom" - ], - "properties": { - "custom": { - "type": "string" - } - }, - "additionalProperties": false, - "title": "CustomSessionSource" - }, - { - "type": "object", - "required": [ - "subAgent" - ], - "properties": { - "subAgent": { - "$ref": "#/definitions/SubAgentSource" - } - }, - "additionalProperties": false, - "title": "SubAgentSessionSource" - } - ] - }, - "SubAgentSource": { - "oneOf": [ - { - "type": "string", - "enum": [ - "review", - "compact", - "memory_consolidation" - ] - }, - { - "type": "object", - "required": [ - "thread_spawn" - ], - "properties": { - "thread_spawn": { - "type": "object", - "required": [ - "depth", - "parent_thread_id" - ], - "properties": { - "agent_nickname": { - "default": null, - "type": [ - "string", - "null" - ] - }, - "agent_path": { - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/AgentPath" - }, - { - "type": "null" - } - ] - }, - "agent_role": { - "default": null, - "type": [ - "string", - "null" - ] - }, - "depth": { - "type": "integer", - "format": "int32" - }, - "parent_thread_id": { - "$ref": "#/definitions/ThreadId" - } - } - } - }, - "additionalProperties": false, - "title": "ThreadSpawnSubAgentSource" - }, - { - "type": "object", - "required": [ - "other" - ], - "properties": { - "other": { - "type": "string" - } - }, - "additionalProperties": false, - "title": "OtherSubAgentSource" - } - ] - }, - "Thread": { - "type": "object", - "required": [ - "cliVersion", - "createdAt", - "cwd", - "ephemeral", - "id", - "modelProvider", - "preview", - "source", - "status", - "turns", - "updatedAt" - ], - "properties": { - "agentNickname": { - "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", - "type": [ - "string", - "null" - ] - }, - "agentRole": { - "description": "Optional role (agent_role) assigned to an AgentControl-spawned sub-agent.", - "type": [ - "string", - "null" - ] - }, - "cliVersion": { - "description": "Version of the CLI that created the thread.", - "type": "string" - }, - "createdAt": { - "description": "Unix timestamp (in seconds) when the thread was created.", - "type": "integer", - "format": "int64" - }, - "cwd": { - "description": "Working directory captured for the thread.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - }, - "ephemeral": { - "description": "Whether the thread is ephemeral and should not be materialized on disk.", - "type": "boolean" - }, - "epiphanyState": { - "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads.", - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyThreadState" - }, - { - "type": "null" - } - ] - }, - "forkedFromId": { - "description": "Source thread id when this thread was created by forking another thread.", - "type": [ - "string", - "null" - ] - }, - "gitInfo": { - "description": "Optional Git metadata captured when the thread was created.", - "anyOf": [ - { - "$ref": "#/definitions/GitInfo" - }, - { - "type": "null" - } - ] - }, - "id": { - "type": "string" - }, - "modelProvider": { - "description": "Model provider used for this thread (for example, 'openai').", - "type": "string" - }, - "name": { - "description": "Optional user-facing thread title.", - "type": [ - "string", - "null" - ] - }, - "path": { - "description": "[UNSTABLE] Path to the thread on disk.", - "type": [ - "string", - "null" - ] - }, - "preview": { - "description": "Usually the first user message in the thread, if available.", - "type": "string" - }, - "source": { - "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).", - "allOf": [ - { - "$ref": "#/definitions/SessionSource" - } - ] - }, - "status": { - "description": "Current runtime status for the thread.", - "allOf": [ - { - "$ref": "#/definitions/ThreadStatus" - } - ] - }, - "turns": { - "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", - "type": "array", - "items": { - "$ref": "#/definitions/Turn" - } - }, - "updatedAt": { - "description": "Unix timestamp (in seconds) when the thread was last updated.", - "type": "integer", - "format": "int64" - } - } - }, - "ThreadActiveFlag": { - "type": "string", - "enum": [ - "waitingOnApproval", - "waitingOnUserInput" - ] - }, - "ThreadId": { - "type": "string" - }, - "ThreadItem": { - "oneOf": [ - { - "type": "object", - "required": [ - "content", - "id", - "type" - ], - "properties": { - "content": { - "type": "array", - "items": { - "$ref": "#/definitions/UserInput" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType" - } - }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", - "required": [ - "fragments", - "id", - "type" - ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "text", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "memoryCitation": { - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/MemoryCitation" - }, - { - "type": "null" - } - ] - }, - "phase": { - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/MessagePhase" - }, - { - "type": "null" - } - ] - }, - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "agentMessage" - ], - "title": "AgentMessageThreadItemType" - } - }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", - "required": [ - "id", - "text", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "plan" - ], - "title": "PlanThreadItemType" - } - }, - "title": "PlanThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "type" - ], - "properties": { - "content": { - "default": [], - "type": "array", - "items": { - "type": "string" - } - }, - "id": { - "type": "string" - }, - "summary": { - "default": [], - "type": "array", - "items": { - "type": "string" - } - }, - "type": { - "type": "string", - "enum": [ - "reasoning" - ], - "title": "ReasoningThreadItemType" - } - }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", - "required": [ - "command", - "commandActions", - "cwd", - "id", - "status", - "type" - ], - "properties": { - "aggregatedOutput": { - "description": "The command's output, aggregated from stdout and stderr.", - "type": [ - "string", - "null" - ] - }, - "command": { - "description": "The command to be executed.", - "type": "string" - }, - "commandActions": { - "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", - "items": { - "$ref": "#/definitions/CommandAction" - } - }, - "cwd": { - "description": "The command's working directory.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - }, - "durationMs": { - "description": "The duration of the command execution in milliseconds.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "exitCode": { - "description": "The command's exit code.", - "type": [ - "integer", - "null" - ], - "format": "int32" - }, - "id": { - "type": "string" - }, - "processId": { - "description": "Identifier for the underlying PTY process (when available).", - "type": [ - "string", - "null" - ] - }, - "source": { - "default": "agent", - "allOf": [ - { - "$ref": "#/definitions/CommandExecutionSource" - } - ] - }, - "status": { - "$ref": "#/definitions/CommandExecutionStatus" - }, - "type": { - "type": "string", - "enum": [ - "commandExecution" - ], - "title": "CommandExecutionThreadItemType" - } - }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", - "required": [ - "changes", - "id", - "status", - "type" - ], - "properties": { - "changes": { - "type": "array", - "items": { - "$ref": "#/definitions/FileUpdateChange" - } - }, - "id": { - "type": "string" - }, - "status": { - "$ref": "#/definitions/PatchApplyStatus" - }, - "type": { - "type": "string", - "enum": [ - "fileChange" - ], - "title": "FileChangeThreadItemType" - } - }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", - "required": [ - "arguments", - "id", - "server", - "status", - "tool", - "type" - ], - "properties": { - "arguments": true, - "durationMs": { - "description": "The duration of the MCP tool call in milliseconds.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "error": { - "anyOf": [ - { - "$ref": "#/definitions/McpToolCallError" - }, - { - "type": "null" - } - ] - }, - "id": { - "type": "string" - }, - "mcpAppResourceUri": { - "type": [ - "string", - "null" - ] - }, - "result": { - "anyOf": [ - { - "$ref": "#/definitions/McpToolCallResult" - }, - { - "type": "null" - } - ] - }, - "server": { - "type": "string" - }, - "status": { - "$ref": "#/definitions/McpToolCallStatus" - }, - "tool": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "mcpToolCall" - ], - "title": "McpToolCallThreadItemType" - } - }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", - "required": [ - "arguments", - "id", - "status", - "tool", - "type" - ], - "properties": { - "arguments": true, - "contentItems": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } - }, - "durationMs": { - "description": "The duration of the dynamic tool call in milliseconds.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "id": { - "type": "string" - }, - "namespace": { - "type": [ - "string", - "null" - ] - }, - "status": { - "$ref": "#/definitions/DynamicToolCallStatus" - }, - "success": { - "type": [ - "boolean", - "null" - ] - }, - "tool": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "dynamicToolCall" - ], - "title": "DynamicToolCallThreadItemType" - } - }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "properties": { - "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/CollabAgentState" - } - }, - "id": { - "description": "Unique identifier for this collab tool call.", - "type": "string" - }, - "model": { - "description": "Model requested for the spawned agent, when applicable.", - "type": [ - "string", - "null" - ] - }, - "prompt": { - "description": "Prompt text sent as part of the collab tool call, when available.", - "type": [ - "string", - "null" - ] - }, - "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", - "anyOf": [ - { - "$ref": "#/definitions/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "receiverThreadIds": { - "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", - "items": { - "type": "string" - } - }, - "senderThreadId": { - "description": "Thread ID of the agent issuing the collab request.", - "type": "string" - }, - "status": { - "description": "Current status of the collab tool call.", - "allOf": [ - { - "$ref": "#/definitions/CollabAgentToolCallStatus" - } - ] - }, - "tool": { - "description": "Name of the collab tool that was invoked.", - "allOf": [ - { - "$ref": "#/definitions/CollabAgentTool" - } - ] - }, - "type": { - "type": "string", - "enum": [ - "collabAgentToolCall" - ], - "title": "CollabAgentToolCallThreadItemType" - } - }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "query", - "type" - ], - "properties": { - "action": { - "anyOf": [ - { - "$ref": "#/definitions/WebSearchAction" - }, - { - "type": "null" - } - ] - }, - "id": { - "type": "string" - }, - "query": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "webSearch" - ], - "title": "WebSearchThreadItemType" - } - }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "path", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "path": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": { - "type": "string", - "enum": [ - "imageView" - ], - "title": "ImageViewThreadItemType" - } - }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "result", - "status", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "result": { - "type": "string" - }, - "revisedPrompt": { - "type": [ - "string", - "null" - ] - }, - "savedPath": { - "anyOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - }, - { - "type": "null" - } - ] - }, - "status": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "imageGeneration" - ], - "title": "ImageGenerationThreadItemType" - } - }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "review", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "review": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "enteredReviewMode" - ], - "title": "EnteredReviewModeThreadItemType" - } - }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "review", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "review": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "exitedReviewMode" - ], - "title": "ExitedReviewModeThreadItemType" - } - }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", - "required": [ - "id", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "contextCompaction" - ], - "title": "ContextCompactionThreadItemType" - } - }, - "title": "ContextCompactionThreadItem" - } - ] - }, - "ThreadStatus": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "notLoaded" - ], - "title": "NotLoadedThreadStatusType" - } - }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "idle" - ], - "title": "IdleThreadStatusType" - } - }, - "title": "IdleThreadStatus" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "systemError" - ], - "title": "SystemErrorThreadStatusType" - } - }, - "title": "SystemErrorThreadStatus" - }, - { - "type": "object", - "required": [ - "activeFlags", - "type" - ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" - } - ] - }, - "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], - "properties": { - "completedAt": { - "description": "Unix timestamp (in seconds) when the turn completed.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "durationMs": { - "description": "Duration between turn start and completion in milliseconds, if known.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, "error": { - "description": "Only populated when the Turn's status is failed.", - "anyOf": [ - { - "$ref": "#/definitions/TurnError" - }, - { - "type": "null" - } - ] - }, - "id": { - "type": "string" - }, - "items": { - "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", - "items": { - "$ref": "#/definitions/ThreadItem" - } - }, - "startedAt": { - "description": "Unix timestamp (in seconds) when the turn started.", - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "status": { - "$ref": "#/definitions/TurnStatus" - } - } - }, - "TurnError": { - "type": "object", - "required": [ - "message" - ], - "properties": { - "additionalDetails": { - "default": null, "type": [ "string", "null" ] }, - "codexErrorInfo": { - "anyOf": [ - { - "$ref": "#/definitions/CodexErrorInfo" - }, - { - "type": "null" - } + "loginId": { + "type": [ + "string", + "null" ] }, - "message": { - "type": "string" + "success": { + "type": "boolean" } - } - }, - "TurnStatus": { - "type": "string", - "enum": [ - "completed", - "interrupted", - "failed", - "inProgress" - ] - }, - "WebSearchAction": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "queries": { - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "query": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "search" - ], - "title": "SearchWebSearchActionType" - } - }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "openPage" - ], - "title": "OpenPageWebSearchActionType" - }, - "url": { - "type": [ - "string", - "null" - ] - } - }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "pattern": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "findInPage" - ], - "title": "FindInPageWebSearchActionType" - }, - "url": { - "type": [ - "string", - "null" - ] - } - }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "other" - ], - "title": "OtherWebSearchActionType" - } - }, - "title": "OtherWebSearchAction" - } - ] - }, - "ThreadStartResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadStartResponse", - "type": "object", + }, "required": [ - "approvalPolicy", - "approvalsReviewer", - "cwd", - "model", - "modelProvider", - "sandbox", - "thread" + "success" ], - "properties": { - "approvalPolicy": { - "$ref": "#/definitions/AskForApproval" - }, - "approvalsReviewer": { - "description": "Reviewer currently used for approval requests on this thread.", - "allOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - } - ] - }, - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "instructionSources": { - "description": "Instruction source files currently loaded for this thread.", - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "model": { - "type": "string" - }, - "modelProvider": { - "type": "string" - }, - "permissionProfile": { - "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`.", - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "reasoningEffort": { - "anyOf": [ - { - "$ref": "#/definitions/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "sandbox": { - "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view.", - "allOf": [ - { - "$ref": "#/definitions/SandboxPolicy" - } - ] - }, - "serviceTier": { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - "thread": { - "$ref": "#/definitions/Thread" - } - } - }, - "ThreadResumeResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadResumeResponse", - "type": "object", - "required": [ - "approvalPolicy", - "approvalsReviewer", - "cwd", - "model", - "modelProvider", - "sandbox", - "thread" - ], - "properties": { - "approvalPolicy": { - "$ref": "#/definitions/AskForApproval" - }, - "approvalsReviewer": { - "description": "Reviewer currently used for approval requests on this thread.", - "allOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - } - ] - }, - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "instructionSources": { - "description": "Instruction source files currently loaded for this thread.", - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "model": { - "type": "string" - }, - "modelProvider": { - "type": "string" - }, - "permissionProfile": { - "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`.", - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "reasoningEffort": { - "anyOf": [ - { - "$ref": "#/definitions/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "sandbox": { - "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view.", - "allOf": [ - { - "$ref": "#/definitions/SandboxPolicy" - } - ] - }, - "serviceTier": { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - "thread": { - "$ref": "#/definitions/Thread" - } - } - }, - "ThreadForkResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadForkResponse", - "type": "object", - "required": [ - "approvalPolicy", - "approvalsReviewer", - "cwd", - "model", - "modelProvider", - "sandbox", - "thread" - ], - "properties": { - "approvalPolicy": { - "$ref": "#/definitions/AskForApproval" - }, - "approvalsReviewer": { - "description": "Reviewer currently used for approval requests on this thread.", - "allOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - } - ] - }, - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "instructionSources": { - "description": "Instruction source files currently loaded for this thread.", - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "model": { - "type": "string" - }, - "modelProvider": { - "type": "string" - }, - "permissionProfile": { - "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`.", - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "reasoningEffort": { - "anyOf": [ - { - "$ref": "#/definitions/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "sandbox": { - "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view.", - "allOf": [ - { - "$ref": "#/definitions/SandboxPolicy" - } - ] - }, - "serviceTier": { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - "thread": { - "$ref": "#/definitions/Thread" - } - } - }, - "ThreadArchiveResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadArchiveResponse", + "title": "AccountLoginCompletedNotification", "type": "object" }, - "ThreadUnsubscribeStatus": { - "type": "string", - "enum": [ - "notLoaded", - "notSubscribed", - "unsubscribed" - ] - }, - "ThreadUnsubscribeResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnsubscribeResponse", - "type": "object", - "required": [ - "status" - ], - "properties": { - "status": { - "$ref": "#/definitions/ThreadUnsubscribeStatus" - } - } - }, "AccountRateLimitsUpdatedNotification": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "AccountRateLimitsUpdatedNotification", - "type": "object", - "required": [ - "rateLimits" - ], "properties": { "rateLimits": { "$ref": "#/definitions/RateLimitSnapshot" } - } + }, + "required": [ + "rateLimits" + ], + "title": "AccountRateLimitsUpdatedNotification", + "type": "object" }, "AccountUpdatedNotification": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "AccountUpdatedNotification", - "type": "object", "properties": { "authMode": { "anyOf": [ @@ -8796,3450 +110,1909 @@ } ] } - } - }, - "ThreadSetNameResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadSetNameResponse", + }, + "title": "AccountUpdatedNotification", "type": "object" }, - "ThreadMetadataUpdateResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadMetadataUpdateResponse", - "type": "object", - "required": [ - "thread" + "AddCreditsNudgeCreditType": { + "enum": [ + "credits", + "usage_limit" ], + "type": "string" + }, + "AddCreditsNudgeEmailStatus": { + "enum": [ + "sent", + "cooldown_active" + ], + "type": "string" + }, + "AdditionalFileSystemPermissions": { "properties": { - "thread": { - "$ref": "#/definitions/Thread" + "entries": { + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + }, + "type": [ + "array", + "null" + ] + }, + "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, + "type": [ + "integer", + "null" + ] + }, + "read": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": [ + "array", + "null" + ] + }, + "write": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": [ + "array", + "null" + ] } - } + }, + "type": "object" + }, + "AdditionalNetworkPermissions": { + "properties": { + "enabled": { + "type": [ + "boolean", + "null" + ] + } + }, + "type": "object" + }, + "AgentMessageDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "AgentMessageDeltaNotification", + "type": "object" + }, + "AgentPath": { + "type": "string" + }, + "AnalyticsConfig": { + "additionalProperties": true, + "properties": { + "enabled": { + "type": [ + "boolean", + "null" + ] + } + }, + "type": "object" + }, + "ApprovalsReviewer": { + "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", + "enum": [ + "user", + "auto_review", + "guardian_subagent" + ], + "type": "string" + }, + "AskForApproval": { + "oneOf": [ + { + "enum": [ + "untrusted", + "on-failure", + "on-request", + "never" + ], + "type": "string" + }, + { + "additionalProperties": false, + "properties": { + "granular": { + "properties": { + "mcp_elicitations": { + "type": "boolean" + }, + "request_permissions": { + "default": false, + "type": "boolean" + }, + "rules": { + "type": "boolean" + }, + "sandbox_approval": { + "type": "boolean" + } + }, + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], + "type": "object" + } + }, + "required": [ + "granular" + ], + "title": "GranularAskForApproval", + "type": "object" + } + ] }, "AuthMode": { "description": "Authentication mode for OpenAI-backed providers.", "oneOf": [ { "description": "OpenAI API key provided by the caller and stored by Codex.", - "type": "string", "enum": [ "apikey" - ] + ], + "type": "string" }, { "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).", - "type": "string", "enum": [ "chatgpt" - ] + ], + "type": "string" }, { "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE.\n\nChatGPT auth tokens are supplied by an external host app and are only stored in memory. Token refresh must be handled by the external host app.", - "type": "string", "enum": [ "chatgptAuthTokens" - ] + ], + "type": "string" }, { "description": "Programmatic Codex auth backed by a registered Agent Identity.", - "type": "string", "enum": [ "agentIdentity" - ] - } - ] - }, - "McpServerStatusUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerStatusUpdatedNotification", - "type": "object", - "required": [ - "name", - "status" - ], - "properties": { - "error": { - "type": [ - "string", - "null" - ] - }, - "name": { - "type": "string" - }, - "status": { - "$ref": "#/definitions/McpServerStartupState" - } - } - }, - "ThreadUnarchiveResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnarchiveResponse", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "$ref": "#/definitions/Thread" - } - } - }, - "ThreadCompactStartResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadCompactStartResponse", - "type": "object" - }, - "ThreadShellCommandResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadShellCommandResponse", - "type": "object" - }, - "ThreadApproveGuardianDeniedActionResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadApproveGuardianDeniedActionResponse", - "type": "object" - }, - "McpServerStartupState": { - "type": "string", - "enum": [ - "starting", - "ready", - "failed", - "cancelled" - ] - }, - "ThreadRollbackResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRollbackResponse", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "description": "The updated thread after applying the rollback, with `turns` populated.\n\nThe ThreadItems stored in each Turn are lossy since we explicitly do not persist all agent interactions, such as command executions. This is the same behavior as `thread/resume`.", - "allOf": [ - { - "$ref": "#/definitions/Thread" - } - ] - } - } - }, - "ThreadListResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadListResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "backwardsCursor": { - "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one thread. Use it with the opposite `sortDirection`; for timestamp sorts it anchors at the start of the page timestamp so same-second updates are not skipped.", - "type": [ - "string", - "null" - ] - }, - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/Thread" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadLoadedListResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadLoadedListResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "data": { - "description": "Thread ids for sessions currently loaded in memory.", - "type": "array", - "items": { - "type": "string" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadReadResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadReadResponse", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "$ref": "#/definitions/Thread" - } - } - }, - "ThreadEpiphanyContextSource": { - "type": "string", - "enum": [ - "stored", - "live" - ] - }, - "ThreadEpiphanyContextStateStatus": { - "type": "string", - "enum": [ - "missing", - "ready" - ] - }, - "ThreadEpiphanyCoordinatorAction": { - "type": "string", - "enum": [ - "prepareCheckpoint", - "compactRehydrateReorient", - "launchReorientWorker", - "waitForReorientWorker", - "reviewReorientResult", - "regatherManually", - "launchResearch", - "reviewResearchResult", - "launchModeling", - "reviewModelingResult", - "launchVerification", - "reviewVerificationResult", - "continueImplementation" - ] - }, - "ThreadEpiphanyCoordinatorSignals": { - "type": "object", - "required": [ - "crrcAction", - "modelingResultStatus", - "pressureLevel", - "researchResultStatus", - "reorientAction", - "reorientResultStatus", - "shouldPrepareCompaction", - "verificationResultStatus" - ], - "properties": { - "crrcAction": { - "$ref": "#/definitions/ThreadEpiphanyCrrcAction" - }, - "modelingResultStatus": { - "$ref": "#/definitions/ThreadEpiphanyRoleResultStatus" - }, - "pressureLevel": { - "$ref": "#/definitions/ThreadEpiphanyPressureLevel" - }, - "researchResultStatus": { - "$ref": "#/definitions/ThreadEpiphanyRoleResultStatus" - }, - "reorientAction": { - "$ref": "#/definitions/ThreadEpiphanyReorientAction" - }, - "reorientResultStatus": { - "$ref": "#/definitions/ThreadEpiphanyReorientResultStatus" - }, - "shouldPrepareCompaction": { - "type": "boolean" - }, - "verificationResultStatus": { - "$ref": "#/definitions/ThreadEpiphanyRoleResultStatus" - } - } - }, - "ThreadEpiphanyCrrcAction": { - "type": "string", - "enum": [ - "continue", - "prepareCheckpoint", - "launchReorientWorker", - "waitForReorientWorker", - "reviewReorientResult", - "acceptReorientResult", - "regatherManually" - ] - }, - "ThreadEpiphanyCrrcRecommendation": { - "type": "object", - "required": [ - "action", - "reason" - ], - "properties": { - "action": { - "$ref": "#/definitions/ThreadEpiphanyCrrcAction" - }, - "reason": { - "type": "string" - }, - "recommendedSceneAction": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanySceneAction" - }, - { - "type": "null" - } - ] - } - } - }, - "ThreadEpiphanyGraphFreshnessStatus": { - "type": "string", - "enum": [ - "missing", - "ready", - "stale" - ] - }, - "ThreadEpiphanyInvalidationStatus": { - "type": "string", - "enum": [ - "unavailable", - "clean", - "changed" - ] - }, - "ThreadEpiphanyJob": { - "type": "object", - "required": [ - "id", - "kind", - "ownerRole", - "scope", - "status" - ], - "properties": { - "activeThreadIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "authorityScope": { - "type": [ - "string", - "null" - ] - }, - "backendJobId": { - "type": [ - "string", - "null" - ] - }, - "blockingReason": { - "type": [ - "string", - "null" - ] - }, - "id": { - "type": "string" - }, - "itemsProcessed": { - "type": [ - "integer", - "null" ], - "format": "uint32", - "minimum": 0.0 - }, - "itemsTotal": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "kind": { - "$ref": "#/definitions/ThreadEpiphanyJobKind" - }, - "lastCheckpointAtUnixSeconds": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "launcherJobId": { - "type": [ - "string", - "null" - ] - }, - "linkedGraphNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "linkedSubgoalIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "ownerRole": { "type": "string" - }, - "progressNote": { - "type": [ - "string", - "null" - ] - }, - "scope": { - "type": "string" - }, - "status": { - "$ref": "#/definitions/ThreadEpiphanyJobStatus" - } - } - }, - "ThreadEpiphanyJobKind": { - "type": "string", - "enum": [ - "indexing", - "remap", - "verification", - "specialist" - ] - }, - "ThreadEpiphanyJobStatus": { - "type": "string", - "enum": [ - "idle", - "needed", - "pending", - "running", - "completed", - "failed", - "cancelled", - "blocked", - "unavailable" - ] - }, - "ThreadEpiphanyPlanningSummary": { - "type": "object", - "required": [ - "backlogItemCount", - "captureCount", - "draftObjectiveCount", - "githubIssueCaptureCount", - "note", - "objectiveDraftCount", - "pendingCaptureCount", - "readyBacklogItemCount", - "roadmapStreamCount" - ], - "properties": { - "activeObjective": { - "type": [ - "string", - "null" - ] - }, - "backlogItemCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "captureCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "draftObjectiveCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "githubIssueCaptureCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "note": { - "type": "string" - }, - "objectiveDraftCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "pendingCaptureCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "readyBacklogItemCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "roadmapStreamCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ThreadEpiphanyPressure": { - "type": "object", - "required": [ - "basis", - "level", - "note", - "shouldPrepareCompaction", - "status" - ], - "properties": { - "basis": { - "$ref": "#/definitions/ThreadEpiphanyPressureBasis" - }, - "level": { - "$ref": "#/definitions/ThreadEpiphanyPressureLevel" - }, - "modelAutoCompactTokenLimit": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "modelContextWindow": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "note": { - "type": "string" - }, - "ratioPerMille": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "remainingTokens": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "shouldPrepareCompaction": { - "type": "boolean" - }, - "status": { - "$ref": "#/definitions/ThreadEpiphanyPressureStatus" - }, - "usedTokens": { - "type": [ - "integer", - "null" - ], - "format": "int64" - } - } - }, - "ThreadEpiphanyPressureBasis": { - "type": "string", - "enum": [ - "unknown", - "autoCompactLimit", - "modelContextWindow" - ] - }, - "ThreadEpiphanyPressureLevel": { - "type": "string", - "enum": [ - "unknown", - "low", - "elevated", - "high", - "critical" - ] - }, - "ThreadEpiphanyPressureStatus": { - "type": "string", - "enum": [ - "unknown", - "ready" - ] - }, - "ThreadEpiphanyReorientAction": { - "type": "string", - "enum": [ - "resume", - "regather" - ] - }, - "ThreadEpiphanyReorientCheckpointStatus": { - "type": "string", - "enum": [ - "missing", - "resumeReady", - "regatherRequired" - ] - }, - "ThreadEpiphanyReorientDecision": { - "type": "object", - "required": [ - "action", - "checkpointStatus", - "graphStatus", - "nextAction", - "note", - "pressureLevel", - "retrievalStatus", - "watcherStatus" - ], - "properties": { - "action": { - "$ref": "#/definitions/ThreadEpiphanyReorientAction" - }, - "activeFrontierNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointChangedPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointDirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointId": { - "type": [ - "string", - "null" - ] - }, - "checkpointStatus": { - "$ref": "#/definitions/ThreadEpiphanyReorientCheckpointStatus" - }, - "graphStatus": { - "$ref": "#/definitions/ThreadEpiphanyGraphFreshnessStatus" - }, - "nextAction": { - "type": "string" - }, - "note": { - "type": "string" - }, - "pressureLevel": { - "$ref": "#/definitions/ThreadEpiphanyPressureLevel" - }, - "reasons": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanyReorientReason" - } - }, - "retrievalStatus": { - "$ref": "#/definitions/ThreadEpiphanyRetrievalFreshnessStatus" - }, - "watcherStatus": { - "$ref": "#/definitions/ThreadEpiphanyInvalidationStatus" - } - } - }, - "ThreadEpiphanyReorientFinding": { - "type": "object", - "properties": { - "artifactRefs": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointStillValid": { - "type": [ - "boolean", - "null" - ] - }, - "evidenceIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "filesInspected": { - "type": "array", - "items": { - "type": "string" - } - }, - "frontierNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "itemError": { - "type": [ - "string", - "null" - ] - }, - "jobError": { - "type": [ - "string", - "null" - ] - }, - "mode": { - "type": [ - "string", - "null" - ] - }, - "nextSafeMove": { - "type": [ - "string", - "null" - ] - }, - "runtimeJobId": { - "type": [ - "string", - "null" - ] - }, - "runtimeResultId": { - "type": [ - "string", - "null" - ] - }, - "summary": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanyReorientReason": { - "type": "string", - "enum": [ - "missingState", - "missingCheckpoint", - "checkpointRequestedRegather", - "checkpointPathsDirty", - "checkpointPathsChanged", - "frontierChanged", - "unanchoredCheckpointWhileStateStale", - "checkpointReady" - ] - }, - "ThreadEpiphanyReorientResultStatus": { - "type": "string", - "enum": [ - "missingState", - "missingBinding", - "backendUnavailable", - "backendMissing", - "pending", - "running", - "completed", - "failed", - "cancelled" - ] - }, - "ThreadEpiphanyReorientSource": { - "type": "string", - "enum": [ - "stored", - "live" - ] - }, - "ThreadEpiphanyReorientStateStatus": { - "type": "string", - "enum": [ - "missing", - "ready" - ] - }, - "ThreadEpiphanyRetrievalFreshnessStatus": { - "type": "string", - "enum": [ - "missing", - "ready", - "stale", - "indexing", - "unavailable" - ] - }, - "ThreadEpiphanyRoleLane": { - "type": "object", - "required": [ - "id", - "note", - "ownerRole", - "status", - "title" - ], - "properties": { - "authorityScopes": { - "type": "array", - "items": { - "type": "string" - } - }, - "id": { - "$ref": "#/definitions/ThreadEpiphanyRoleId" - }, - "jobs": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanyJob" - } - }, - "note": { - "type": "string" - }, - "ownerRole": { - "type": "string" - }, - "recommendedAction": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanySceneAction" - }, - { - "type": "null" - } - ] - }, - "status": { - "$ref": "#/definitions/ThreadEpiphanyRoleStatus" - }, - "title": { - "type": "string" - } - } - }, - "ThreadEpiphanyRoleResultStatus": { - "type": "string", - "enum": [ - "missingState", - "missingBinding", - "backendUnavailable", - "backendMissing", - "pending", - "running", - "completed", - "failed", - "cancelled" - ] - }, - "ThreadEpiphanyRoleStatus": { - "type": "string", - "enum": [ - "ready", - "needed", - "blocked", - "running", - "completed", - "waiting", - "review", - "unavailable" - ] - }, - "ThreadEpiphanyRolesSource": { - "type": "string", - "enum": [ - "stored", - "live" - ] - }, - "ThreadEpiphanyScene": { - "type": "object", - "required": [ - "evidence", - "graph", - "observations", - "source", - "stateStatus" - ], - "properties": { - "activeSubgoal": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanySceneSubgoal" - }, - { - "type": "null" - } - ] - }, - "availableActions": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanySceneAction" - } - }, - "churn": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanySceneChurn" - }, - { - "type": "null" - } - ] - }, - "evidence": { - "$ref": "#/definitions/ThreadEpiphanySceneRecords" - }, - "graph": { - "$ref": "#/definitions/ThreadEpiphanySceneGraph" - }, - "invariantStatusCounts": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanySceneStatusCount" - } - }, - "investigationCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanySceneInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "objective": { - "type": [ - "string", - "null" - ] - }, - "observations": { - "$ref": "#/definitions/ThreadEpiphanySceneRecords" - }, - "retrieval": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanySceneRetrieval" - }, - { - "type": "null" - } - ] - }, - "revision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "source": { - "$ref": "#/definitions/ThreadEpiphanySceneSource" - }, - "stateStatus": { - "$ref": "#/definitions/ThreadEpiphanySceneStateStatus" - }, - "subgoals": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanySceneSubgoal" - } - } - } - }, - "ThreadEpiphanySceneAction": { - "type": "string", - "enum": [ - "index", - "retrieve", - "distill", - "context", - "planning", - "graphQuery", - "jobs", - "roles", - "coordinator", - "roleLaunch", - "roleResult", - "roleAccept", - "jobLaunch", - "jobInterrupt", - "freshness", - "pressure", - "reorient", - "crrc", - "reorientLaunch", - "reorientResult", - "reorientAccept", - "propose", - "promote", - "update" - ] - }, - "ThreadEpiphanySceneChurn": { - "type": "object", - "required": [ - "diffPressure", - "understandingStatus" - ], - "properties": { - "diffPressure": { - "type": "string" - }, - "graphFreshness": { - "type": [ - "string", - "null" - ] - }, - "understandingStatus": { - "type": "string" - }, - "unexplainedWrites": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "warning": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanySceneGraph": { - "type": "object", - "required": [ - "architectureEdgeCount", - "architectureNodeCount", - "dataflowEdgeCount", - "dataflowNodeCount", - "linkCount", - "openGapCount", - "openQuestionCount" - ], - "properties": { - "activeEdgeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "activeNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "architectureEdgeCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "architectureNodeCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "checkpointId": { - "type": [ - "string", - "null" - ] - }, - "checkpointSummary": { - "type": [ - "string", - "null" - ] - }, - "dataflowEdgeCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "dataflowNodeCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "dirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "linkCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "openGapCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "openQuestionCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ThreadEpiphanySceneInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpointId", - "codeRefCount", - "disposition", - "evidenceCount", - "focus", - "kind", - "openQuestionCount" - ], - "properties": { - "capturedAtTurnId": { - "type": [ - "string", - "null" - ] - }, - "checkpointId": { - "type": "string" - }, - "codeRefCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "disposition": { - "$ref": "#/definitions/EpiphanyInvestigationDisposition" - }, - "evidenceCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "focus": { - "type": "string" - }, - "kind": { - "type": "string" - }, - "nextAction": { - "type": [ - "string", - "null" - ] - }, - "openQuestionCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "summary": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanySceneRecord": { - "type": "object", - "required": [ - "codeRefCount", - "id", - "kind", - "status", - "summary" - ], - "properties": { - "codeRefCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "id": { - "type": "string" - }, - "kind": { - "type": "string" - }, - "status": { - "type": "string" - }, - "summary": { - "type": "string" - } - } - }, - "ThreadEpiphanySceneRecords": { - "type": "object", - "required": [ - "totalCount" - ], - "properties": { - "latest": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanySceneRecord" - } - }, - "totalCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - } - } - }, - "ThreadEpiphanySceneRetrieval": { - "type": "object", - "required": [ - "dirtyPathCount", - "semanticAvailable", - "shardCount", - "status", - "workspaceRoot" - ], - "properties": { - "dirtyPathCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "indexRevision": { - "type": [ - "string", - "null" - ] - }, - "indexedChunkCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "indexedFileCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "semanticAvailable": { - "type": "boolean" - }, - "shardCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "status": { - "$ref": "#/definitions/EpiphanyRetrievalStatus" - }, - "workspaceRoot": { - "type": "string" - } - } - }, - "ThreadEpiphanySceneSource": { - "type": "string", - "enum": [ - "stored", - "live" - ] - }, - "ThreadEpiphanySceneStateStatus": { - "type": "string", - "enum": [ - "missing", - "ready" - ] - }, - "ThreadEpiphanySceneStatusCount": { - "type": "object", - "required": [ - "count", - "status" - ], - "properties": { - "count": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "status": { - "type": "string" - } - } - }, - "ThreadEpiphanySceneSubgoal": { - "type": "object", - "required": [ - "active", - "id", - "status", - "title" - ], - "properties": { - "active": { - "type": "boolean" - }, - "id": { - "type": "string" - }, - "status": { - "type": "string" - }, - "summary": { - "type": [ - "string", - "null" - ] - }, - "title": { - "type": "string" - } - } - }, - "ThreadEpiphanyViewCoordinator": { - "type": "object", - "required": [ - "action", - "canAutoRun", - "note", - "reason", - "requiresReview", - "roles", - "source", - "sourceSignals", - "stateStatus", - "threadId" - ], - "properties": { - "action": { - "$ref": "#/definitions/ThreadEpiphanyCoordinatorAction" - }, - "canAutoRun": { - "type": "boolean" - }, - "note": { - "type": "string" - }, - "reason": { - "type": "string" - }, - "recommendedSceneAction": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanySceneAction" - }, - { - "type": "null" - } - ] - }, - "requiresReview": { - "type": "boolean" - }, - "roles": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanyRoleLane" - } - }, - "source": { - "$ref": "#/definitions/ThreadEpiphanyRolesSource" - }, - "sourceSignals": { - "$ref": "#/definitions/ThreadEpiphanyCoordinatorSignals" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "stateStatus": { - "$ref": "#/definitions/ThreadEpiphanyReorientStateStatus" - }, - "targetRole": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanyRoleId" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyViewCrrc": { - "type": "object", - "required": [ - "decision", - "note", - "pressure", - "recommendation", - "reorientBindingId", - "reorientResultStatus", - "source", - "stateStatus", - "threadId" - ], - "properties": { - "availableActions": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanySceneAction" - } - }, - "decision": { - "$ref": "#/definitions/ThreadEpiphanyReorientDecision" - }, - "note": { - "type": "string" - }, - "pressure": { - "$ref": "#/definitions/ThreadEpiphanyPressure" - }, - "recommendation": { - "$ref": "#/definitions/ThreadEpiphanyCrrcRecommendation" - }, - "reorientBindingId": { - "type": "string" - }, - "reorientFinding": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanyReorientFinding" - }, - { - "type": "null" - } - ] - }, - "reorientJob": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanyJob" - }, - { - "type": "null" - } - ] - }, - "reorientResultStatus": { - "$ref": "#/definitions/ThreadEpiphanyReorientResultStatus" - }, - "source": { - "$ref": "#/definitions/ThreadEpiphanyReorientSource" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "stateStatus": { - "$ref": "#/definitions/ThreadEpiphanyReorientStateStatus" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyViewPlanning": { - "type": "object", - "required": [ - "planning", - "source", - "stateStatus", - "summary", - "threadId" - ], - "properties": { - "planning": { - "$ref": "#/definitions/EpiphanyPlanningState" - }, - "source": { - "$ref": "#/definitions/ThreadEpiphanyContextSource" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "stateStatus": { - "$ref": "#/definitions/ThreadEpiphanyContextStateStatus" - }, - "summary": { - "$ref": "#/definitions/ThreadEpiphanyPlanningSummary" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyViewReorient": { - "type": "object", - "required": [ - "decision", - "source", - "stateStatus", - "threadId" - ], - "properties": { - "decision": { - "$ref": "#/definitions/ThreadEpiphanyReorientDecision" - }, - "source": { - "$ref": "#/definitions/ThreadEpiphanyReorientSource" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "stateStatus": { - "$ref": "#/definitions/ThreadEpiphanyReorientStateStatus" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadEpiphanyViewRoles": { - "type": "object", - "required": [ - "note", - "roles", - "source", - "stateStatus", - "threadId" - ], - "properties": { - "note": { - "type": "string" - }, - "roles": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanyRoleLane" - } - }, - "source": { - "$ref": "#/definitions/ThreadEpiphanyRolesSource" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "stateStatus": { - "$ref": "#/definitions/ThreadEpiphanyReorientStateStatus" - }, - "threadId": { - "type": "string" - } - } - }, - "McpServerOauthLoginCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerOauthLoginCompletedNotification", - "type": "object", - "required": [ - "name", - "success" - ], - "properties": { - "error": { - "type": [ - "string", - "null" - ] - }, - "name": { - "type": "string" - }, - "success": { - "type": "boolean" - } - } - }, - "ThreadEpiphanyStateUpdatedField": { - "type": "string", - "enum": [ - "objective", - "activeSubgoalId", - "subgoals", - "invariants", - "graphs", - "graphFrontier", - "graphCheckpoint", - "scratch", - "investigationCheckpoint", - "jobBindings", - "acceptanceReceipts", - "runtimeLinks", - "observations", - "evidence", - "churn", - "mode", - "planning" - ] - }, - "McpToolCallProgressNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpToolCallProgressNotification", - "type": "object", - "required": [ - "itemId", - "message", - "threadId", - "turnId" - ], - "properties": { - "itemId": { - "type": "string" - }, - "message": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ThreadEpiphanyRoleFinding": { - "type": "object", - "required": [ - "roleId" - ], - "properties": { - "artifactRefs": { - "type": "array", - "items": { - "type": "string" - } - }, - "checkpointSummary": { - "type": [ - "string", - "null" - ] - }, - "evidenceGaps": { - "type": "array", - "items": { - "type": "string" - } - }, - "evidenceIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "filesInspected": { - "type": "array", - "items": { - "type": "string" - } - }, - "frontierNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "itemError": { - "type": [ - "string", - "null" - ] - }, - "jobError": { - "type": [ - "string", - "null" - ] - }, - "nextSafeMove": { - "type": [ - "string", - "null" - ] - }, - "openQuestions": { - "type": "array", - "items": { - "type": "string" - } - }, - "risks": { - "type": "array", - "items": { - "type": "string" - } - }, - "roleId": { - "$ref": "#/definitions/ThreadEpiphanyRoleId" - }, - "runtimeJobId": { - "type": [ - "string", - "null" - ] - }, - "runtimeResultId": { - "type": [ - "string", - "null" - ] - }, - "scratchSummary": { - "type": [ - "string", - "null" - ] - }, - "selfPatch": true, - "selfPersistence": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanyRoleSelfPersistenceReview" - }, - { - "type": "null" - } - ] - }, - "statePatch": { - "anyOf": [ - { - "$ref": "#/definitions/ThreadEpiphanyUpdatePatch" - }, - { - "type": "null" - } - ] - }, - "summary": { - "type": [ - "string", - "null" - ] - }, - "verdict": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanyRoleSelfPersistenceReview": { - "type": "object", - "required": [ - "status" - ], - "properties": { - "reasons": { - "type": "array", - "items": { - "type": "string" - } - }, - "status": { - "$ref": "#/definitions/ThreadEpiphanyRoleSelfPersistenceStatus" - }, - "targetAgentId": { - "type": [ - "string", - "null" - ] - }, - "targetPath": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanyRoleSelfPersistenceStatus": { - "type": "string", - "enum": [ - "missing", - "accepted", - "rejected" - ] - }, - "ServerRequestResolvedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ServerRequestResolvedNotification", - "type": "object", - "required": [ - "requestId", - "threadId" - ], - "properties": { - "requestId": { - "$ref": "#/definitions/RequestId" - }, - "threadId": { - "type": "string" - } - } - }, - "RequestId": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "integer", - "format": "int64" } ] }, - "ThreadEpiphanyFreshnessSource": { - "type": "string", - "enum": [ - "stored", - "live" - ] - }, - "ThreadEpiphanyGraphFreshness": { - "type": "object", - "required": [ - "dirtyPathCount", - "note", - "openGapCount", - "openQuestionCount", - "status" - ], - "properties": { - "checkpointId": { - "type": [ - "string", - "null" - ] - }, - "dirtyPathCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "dirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "graphFreshness": { - "type": [ - "string", - "null" - ] - }, - "note": { - "type": "string" - }, - "openGapCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "openQuestionCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "status": { - "$ref": "#/definitions/ThreadEpiphanyGraphFreshnessStatus" - } - } - }, - "ThreadEpiphanyInvalidationInput": { - "type": "object", - "required": [ - "changedPathCount", - "note", - "status" - ], - "properties": { - "activeFrontierNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "changedPathCount": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - }, - "changedPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "graphNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "note": { - "type": "string" - }, - "observedAtUnixSeconds": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "status": { - "$ref": "#/definitions/ThreadEpiphanyInvalidationStatus" - }, - "watchedRoot": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadEpiphanyRetrievalFreshness": { - "type": "object", - "required": [ - "note", - "status" - ], - "properties": { - "dirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "indexedChunkCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "indexedFileCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "lastIndexedAtUnixSeconds": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "note": { - "type": "string" - }, - "semanticAvailable": { - "type": [ - "boolean", - "null" - ] - }, - "status": { - "$ref": "#/definitions/ThreadEpiphanyRetrievalFreshnessStatus" - } - } - }, - "FileChangePatchUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FileChangePatchUpdatedNotification", - "type": "object", - "required": [ - "changes", - "itemId", - "threadId", - "turnId" - ], - "properties": { - "changes": { - "type": "array", - "items": { - "$ref": "#/definitions/FileUpdateChange" - } - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ThreadEpiphanyContext": { - "type": "object", - "required": [ - "graph" - ], - "properties": { - "checkpoint": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphCheckpoint" - }, - { - "type": "null" - } - ] - }, - "evidence": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyEvidenceRecord" - } - }, - "frontier": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphFrontier" - }, - { - "type": "null" - } - ] - }, - "graph": { - "$ref": "#/definitions/ThreadEpiphanyGraphContext" - }, - "investigationCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "observations": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyObservation" - } - } - } - }, - "ThreadEpiphanyContextMissing": { - "type": "object", - "properties": { - "evidenceIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "graphEdgeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "graphNodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "observationIds": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ThreadEpiphanyGraphContext": { - "type": "object", - "properties": { - "architectureEdges": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyGraphEdge" - } - }, - "architectureNodes": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyGraphNode" - } - }, - "dataflowEdges": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyGraphEdge" - } - }, - "dataflowNodes": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyGraphNode" - } - }, - "links": { - "type": "array", - "items": { - "$ref": "#/definitions/EpiphanyGraphLink" - } - } - } - }, - "FileChangeOutputDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FileChangeOutputDeltaNotification", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], - "properties": { - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ThreadEpiphanyGraphQueryMatched": { - "type": "object", - "properties": { - "edgeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "edgeKinds": { - "type": "array", - "items": { - "type": "string" - } - }, - "nodeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "paths": { - "type": "array", - "items": { - "type": "string" - } - }, - "symbols": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ThreadEpiphanyGraphQueryMissing": { - "type": "object", - "properties": { - "edgeIds": { - "type": "array", - "items": { - "type": "string" - } - }, - "nodeIds": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "TerminalInteractionNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TerminalInteractionNotification", - "type": "object", - "required": [ - "itemId", - "processId", - "stdin", - "threadId", - "turnId" - ], - "properties": { - "itemId": { - "type": "string" - }, - "processId": { - "type": "string" - }, - "stdin": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "CommandExecutionOutputDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecutionOutputDeltaNotification", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], - "properties": { - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "CommandExecOutputDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecOutputDeltaNotification", - "description": "Base64-encoded output chunk emitted for a streaming `command/exec` request.\n\nThese notifications are connection-scoped. If the originating connection closes, the server terminates the process.", - "type": "object", - "required": [ - "capReached", - "deltaBase64", - "processId", - "stream" - ], - "properties": { - "capReached": { - "description": "`true` on the final streamed chunk for a stream when `outputBytesCap` truncated later output on that stream.", - "type": "boolean" - }, - "deltaBase64": { - "description": "Base64-encoded output bytes.", - "type": "string" - }, - "processId": { - "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", - "type": "string" - }, - "stream": { - "description": "Output stream for this chunk.", - "allOf": [ - { - "$ref": "#/definitions/CommandExecOutputStream" - } - ] - } - } - }, - "CommandExecOutputStream": { - "description": "Stream label for `command/exec/outputDelta` notifications.", - "oneOf": [ - { - "description": "stdout stream. PTY mode multiplexes terminal output here.", - "type": "string", - "enum": [ - "stdout" - ] - }, - { - "description": "stderr stream.", - "type": "string", - "enum": [ - "stderr" - ] - } - ] - }, - "ThreadEpiphanyRetrieveIndexSummary": { - "type": "object", - "required": [ - "dirtyPaths", - "semanticAvailable", - "shards", - "status", - "workspaceRoot" - ], - "properties": { - "dirtyPaths": { - "type": "array", - "items": { - "type": "string" - } - }, - "indexRevision": { - "type": [ - "string", - "null" - ] - }, - "indexedChunkCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "indexedFileCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "lastIndexedAtUnixSeconds": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "semanticAvailable": { - "type": "boolean" - }, - "shards": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanyRetrieveShardSummary" - } - }, - "status": { - "$ref": "#/definitions/EpiphanyRetrievalStatus" - }, - "workspaceRoot": { - "$ref": "#/definitions/AbsolutePathBuf" - } - } - }, - "ThreadEpiphanyRetrieveShardSummary": { - "type": "object", - "required": [ - "exactAvailable", - "pathPrefix", - "semanticAvailable", - "shardId", - "status" - ], - "properties": { - "exactAvailable": { - "type": "boolean" - }, - "indexedChunkCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "indexedFileCount": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "pathPrefix": { - "type": "string" - }, - "semanticAvailable": { - "type": "boolean" - }, - "shardId": { - "type": "string" - }, - "status": { - "$ref": "#/definitions/EpiphanyRetrievalStatus" - } - } - }, - "PlanDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "PlanDeltaNotification", - "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items. Clients should not assume concatenated deltas match the completed plan item content.", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], - "properties": { - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "AgentMessageDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "AgentMessageDeltaNotification", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], - "properties": { - "delta": { - "type": "string" - }, - "itemId": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "RawResponseItemCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "RawResponseItemCompletedNotification", - "type": "object", - "required": [ - "item", - "threadId", - "turnId" - ], - "properties": { - "item": { - "$ref": "#/definitions/ResponseItem" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ItemCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ItemCompletedNotification", - "type": "object", - "required": [ - "item", - "threadId", - "turnId" - ], - "properties": { - "item": { - "$ref": "#/definitions/ThreadItem" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ItemGuardianApprovalReviewCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ItemGuardianApprovalReviewCompletedNotification", - "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", - "type": "object", - "required": [ - "action", - "decisionSource", - "review", - "reviewId", - "threadId", - "turnId" - ], - "properties": { - "action": { - "$ref": "#/definitions/GuardianApprovalReviewAction" - }, - "decisionSource": { - "$ref": "#/definitions/AutoReviewDecisionSource" - }, - "review": { - "$ref": "#/definitions/GuardianApprovalReview" - }, - "reviewId": { - "description": "Stable identifier for this review.", - "type": "string" - }, - "targetItemId": { - "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, "AutoReviewDecisionSource": { "description": "[UNSTABLE] Source that produced a terminal approval auto-review decision.", - "type": "string", "enum": [ "agent" - ] - }, - "ItemGuardianApprovalReviewStartedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ItemGuardianApprovalReviewStartedNotification", - "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", - "type": "object", - "required": [ - "action", - "review", - "reviewId", - "threadId", - "turnId" ], - "properties": { - "action": { - "$ref": "#/definitions/GuardianApprovalReviewAction" - }, - "review": { - "$ref": "#/definitions/GuardianApprovalReview" - }, - "reviewId": { - "description": "Stable identifier for this review.", - "type": "string" - }, - "targetItemId": { - "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } + "type": "string" }, - "ThreadEpiphanyRetrieveResult": { - "type": "object", - "required": [ - "kind", - "path", - "score" - ], + "ByteRange": { "properties": { - "excerpt": { - "type": [ - "string", - "null" - ] + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" }, - "kind": { - "$ref": "#/definitions/ThreadEpiphanyRetrieveResultKind" - }, - "lineEnd": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "lineStart": { - "type": [ - "integer", - "null" - ], - "format": "uint32", - "minimum": 0.0 - }, - "path": { - "type": "string" - }, - "score": { - "type": "number", - "format": "float" - } - } - }, - "ThreadEpiphanyRetrieveResultKind": { - "type": "string", - "enum": [ - "exactFile", - "exactDirectory", - "semanticChunk" - ] - }, - "RequestPermissionProfile": { - "type": "object", - "properties": { - "fileSystem": { - "anyOf": [ - { - "$ref": "#/definitions/AdditionalFileSystemPermissions" - }, - { - "type": "null" - } - ] - }, - "network": { - "anyOf": [ - { - "$ref": "#/definitions/AdditionalNetworkPermissions" - }, - { - "type": "null" - } - ] + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" } }, - "additionalProperties": false - }, - "ThreadTurnsListResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadTurnsListResponse", - "type": "object", "required": [ - "data" + "end", + "start" ], + "type": "object" + }, + "CancelLoginAccountParams": { + "$schema": "http://json-schema.org/draft-07/schema#", "properties": { - "backwardsCursor": { - "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one turn. Use it with the opposite `sortDirection` to include the anchor turn again and catch updates to that turn.", + "loginId": { + "type": "string" + } + }, + "required": [ + "loginId" + ], + "title": "CancelLoginAccountParams", + "type": "object" + }, + "CancelLoginAccountResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "status": { + "$ref": "#/definitions/CancelLoginAccountStatus" + } + }, + "required": [ + "status" + ], + "title": "CancelLoginAccountResponse", + "type": "object" + }, + "CancelLoginAccountStatus": { + "enum": [ + "canceled", + "notFound" + ], + "type": "string" + }, + "ClientInfo": { + "properties": { + "name": { + "type": "string" + }, + "title": { "type": [ "string", "null" ] }, - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/Turn" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last turn. if None, there are no more turns to return.", - "type": [ - "string", - "null" - ] + "version": { + "type": "string" } - } - }, - "ThreadInjectItemsResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadInjectItemsResponse", + }, + "required": [ + "name", + "version" + ], "type": "object" }, - "DeviceKeyAlgorithm": { - "description": "Device-key algorithm reported at enrollment and signing boundaries.", - "type": "string", - "enum": [ - "ecdsa_p256_sha256" - ] - }, - "DeviceKeyProtectionClass": { - "description": "Platform protection class for a controller-local device key.", - "type": "string", - "enum": [ - "hardware_secure_enclave", - "hardware_tpm", - "os_protected_nonextractable" - ] - }, - "DeviceKeyCreateResponse": { + "ClientRequest": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeyCreateResponse", - "description": "Device-key metadata and public key returned by create/public APIs.", - "type": "object", - "required": [ - "algorithm", - "keyId", - "protectionClass", - "publicKeySpkiDerBase64" - ], - "properties": { - "algorithm": { - "$ref": "#/definitions/DeviceKeyAlgorithm" - }, - "keyId": { - "type": "string" - }, - "protectionClass": { - "$ref": "#/definitions/DeviceKeyProtectionClass" - }, - "publicKeySpkiDerBase64": { - "description": "SubjectPublicKeyInfo DER encoded as base64.", - "type": "string" - } - } - }, - "DeviceKeyPublicResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeyPublicResponse", - "description": "Device-key public metadata returned by `device/key/public`.", - "type": "object", - "required": [ - "algorithm", - "keyId", - "protectionClass", - "publicKeySpkiDerBase64" - ], - "properties": { - "algorithm": { - "$ref": "#/definitions/DeviceKeyAlgorithm" - }, - "keyId": { - "type": "string" - }, - "protectionClass": { - "$ref": "#/definitions/DeviceKeyProtectionClass" - }, - "publicKeySpkiDerBase64": { - "description": "SubjectPublicKeyInfo DER encoded as base64.", - "type": "string" - } - } - }, - "DeviceKeySignResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeySignResponse", - "description": "ASN.1 DER signature returned by `device/key/sign`.", - "type": "object", - "required": [ - "algorithm", - "signatureDerBase64", - "signedPayloadBase64" - ], - "properties": { - "algorithm": { - "$ref": "#/definitions/DeviceKeyAlgorithm" - }, - "signatureDerBase64": { - "description": "ECDSA signature DER encoded as base64.", - "type": "string" - }, - "signedPayloadBase64": { - "description": "Exact bytes signed by the device key, encoded as base64. Verifiers must verify this byte string directly and must not reserialize `payload`.", - "type": "string" - } - } - }, - "FsReadFileResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsReadFileResponse", - "description": "Base64-encoded file contents returned by `fs/readFile`.", - "type": "object", - "required": [ - "dataBase64" - ], - "properties": { - "dataBase64": { - "description": "File contents encoded as base64.", - "type": "string" - } - } - }, - "FsWriteFileResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsWriteFileResponse", - "description": "Successful response for `fs/writeFile`.", - "type": "object" - }, - "FsCreateDirectoryResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsCreateDirectoryResponse", - "description": "Successful response for `fs/createDirectory`.", - "type": "object" - }, - "FsGetMetadataResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsGetMetadataResponse", - "description": "Metadata returned by `fs/getMetadata`.", - "type": "object", - "required": [ - "createdAtMs", - "isDirectory", - "isFile", - "isSymlink", - "modifiedAtMs" - ], - "properties": { - "createdAtMs": { - "description": "File creation time in Unix milliseconds when available, otherwise `0`.", - "type": "integer", - "format": "int64" - }, - "isDirectory": { - "description": "Whether the path resolves to a directory.", - "type": "boolean" - }, - "isFile": { - "description": "Whether the path resolves to a regular file.", - "type": "boolean" - }, - "isSymlink": { - "description": "Whether the path itself is a symbolic link.", - "type": "boolean" - }, - "modifiedAtMs": { - "description": "File modification time in Unix milliseconds when available, otherwise `0`.", - "type": "integer", - "format": "int64" - } - } - }, - "FsReadDirectoryEntry": { - "description": "A directory entry returned by `fs/readDirectory`.", - "type": "object", - "required": [ - "fileName", - "isDirectory", - "isFile" - ], - "properties": { - "fileName": { - "description": "Direct child entry name only, not an absolute or relative path.", - "type": "string" - }, - "isDirectory": { - "description": "Whether this entry resolves to a directory.", - "type": "boolean" - }, - "isFile": { - "description": "Whether this entry resolves to a regular file.", - "type": "boolean" - } - } - }, - "FsReadDirectoryResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsReadDirectoryResponse", - "description": "Directory entries returned by `fs/readDirectory`.", - "type": "object", - "required": [ - "entries" - ], - "properties": { - "entries": { - "description": "Direct child entries in the requested directory.", - "type": "array", - "items": { - "$ref": "#/definitions/FsReadDirectoryEntry" - } - } - } - }, - "FsRemoveResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsRemoveResponse", - "description": "Successful response for `fs/remove`.", - "type": "object" - }, - "FsCopyResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsCopyResponse", - "description": "Successful response for `fs/copy`.", - "type": "object" - }, - "FsWatchResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsWatchResponse", - "description": "Successful response for `fs/watch`.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Canonicalized path associated with the watch.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - } - } - }, - "FsUnwatchResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsUnwatchResponse", - "description": "Successful response for `fs/unwatch`.", - "type": "object" - }, - "TurnStartResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnStartResponse", - "type": "object", - "required": [ - "turn" - ], - "properties": { - "turn": { - "$ref": "#/definitions/Turn" - } - } - }, - "TurnSteerResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnSteerResponse", - "type": "object", - "required": [ - "turnId" - ], - "properties": { - "turnId": { - "type": "string" - } - } - }, - "TurnInterruptResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnInterruptResponse", - "type": "object" - }, - "NetworkApprovalProtocol": { - "type": "string", - "enum": [ - "http", - "https", - "socks5Tcp", - "socks5Udp" - ] - }, - "GuardianUserAuthorization": { - "description": "[UNSTABLE] Authorization level assigned by approval auto-review.", - "type": "string", - "enum": [ - "unknown", - "low", - "medium", - "high" - ] - }, - "GuardianRiskLevel": { - "description": "[UNSTABLE] Risk level assigned by approval auto-review.", - "type": "string", - "enum": [ - "low", - "medium", - "high", - "critical" - ] - }, - "GuardianCommandSource": { - "type": "string", - "enum": [ - "shell", - "unifiedExec" - ] - }, - "RealtimeVoicesList": { - "type": "object", - "required": [ - "defaultV1", - "defaultV2", - "v1", - "v2" - ], - "properties": { - "defaultV1": { - "$ref": "#/definitions/RealtimeVoice" - }, - "defaultV2": { - "$ref": "#/definitions/RealtimeVoice" - }, - "v1": { - "type": "array", - "items": { - "$ref": "#/definitions/RealtimeVoice" - } - }, - "v2": { - "type": "array", - "items": { - "$ref": "#/definitions/RealtimeVoice" - } - } - } - }, - "GuardianApprovalReviewStatus": { - "description": "[UNSTABLE] Lifecycle state for an approval auto-review.", - "type": "string", - "enum": [ - "inProgress", - "approved", - "denied", - "timedOut", - "aborted" - ] - }, - "ReviewStartResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReviewStartResponse", - "type": "object", - "required": [ - "reviewThreadId", - "turn" - ], - "properties": { - "reviewThreadId": { - "description": "Identifies the thread where the review runs.\n\nFor inline reviews, this is the original thread id. For detached reviews, this is the id of the new review thread.", - "type": "string" - }, - "turn": { - "$ref": "#/definitions/Turn" - } - } - }, - "InputModality": { - "description": "Canonical user-input modality tags advertised by a model.", + "description": "Request from the client to the server.", "oneOf": [ { - "description": "Plain text turns and tool payloads.", - "type": "string", - "enum": [ - "text" - ] + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "initialize" + ], + "title": "InitializeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/InitializeParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "InitializeRequest", + "type": "object" }, { - "description": "Image attachments included in user turns.", - "type": "string", + "description": "NEW APIs", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/start" + ], + "title": "Thread/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/resume" + ], + "title": "Thread/resumeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadResumeParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/resumeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/fork" + ], + "title": "Thread/forkRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadForkParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/forkRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/archive" + ], + "title": "Thread/archiveRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadArchiveParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/archiveRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/unsubscribe" + ], + "title": "Thread/unsubscribeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadUnsubscribeParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/unsubscribeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/name/set" + ], + "title": "Thread/name/setRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadSetNameParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/name/setRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/metadata/update" + ], + "title": "Thread/metadata/updateRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadMetadataUpdateParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/metadata/updateRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/unarchive" + ], + "title": "Thread/unarchiveRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadUnarchiveParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/unarchiveRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/compact/start" + ], + "title": "Thread/compact/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadCompactStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/compact/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/shellCommand" + ], + "title": "Thread/shellCommandRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadShellCommandParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/shellCommandRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/approveGuardianDeniedAction" + ], + "title": "Thread/approveGuardianDeniedActionRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadApproveGuardianDeniedActionParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/approveGuardianDeniedActionRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/rollback" + ], + "title": "Thread/rollbackRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRollbackParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/rollbackRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/list" + ], + "title": "Thread/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/loaded/list" + ], + "title": "Thread/loaded/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadLoadedListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/loaded/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/read" + ], + "title": "Thread/readRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadReadParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/turns/list" + ], + "title": "Thread/turns/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadTurnsListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/turns/listRequest", + "type": "object" + }, + { + "description": "Append raw Responses API items to the thread history without starting a user turn.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "thread/inject_items" + ], + "title": "Thread/injectItemsRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadInjectItemsParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Thread/injectItemsRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "device/key/create" + ], + "title": "Device/key/createRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/DeviceKeyCreateParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Device/key/createRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "device/key/public" + ], + "title": "Device/key/publicRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/DeviceKeyPublicParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Device/key/publicRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "device/key/sign" + ], + "title": "Device/key/signRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/DeviceKeySignParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Device/key/signRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/readFile" + ], + "title": "Fs/readFileRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsReadFileParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/readFileRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/writeFile" + ], + "title": "Fs/writeFileRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsWriteFileParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/writeFileRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/createDirectory" + ], + "title": "Fs/createDirectoryRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsCreateDirectoryParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/createDirectoryRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/getMetadata" + ], + "title": "Fs/getMetadataRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsGetMetadataParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/getMetadataRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/readDirectory" + ], + "title": "Fs/readDirectoryRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsReadDirectoryParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/readDirectoryRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/remove" + ], + "title": "Fs/removeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsRemoveParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/removeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/copy" + ], + "title": "Fs/copyRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsCopyParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/copyRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/watch" + ], + "title": "Fs/watchRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsWatchParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/watchRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fs/unwatch" + ], + "title": "Fs/unwatchRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsUnwatchParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Fs/unwatchRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "turn/start" + ], + "title": "Turn/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Turn/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "turn/steer" + ], + "title": "Turn/steerRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnSteerParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Turn/steerRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "turn/interrupt" + ], + "title": "Turn/interruptRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnInterruptParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Turn/interruptRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "review/start" + ], + "title": "Review/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ReviewStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Review/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "model/list" + ], + "title": "Model/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ModelListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Model/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "experimentalFeature/list" + ], + "title": "ExperimentalFeature/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ExperimentalFeatureListParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "ExperimentalFeature/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "experimentalFeature/enablement/set" + ], + "title": "ExperimentalFeature/enablement/setRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ExperimentalFeatureEnablementSetParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "ExperimentalFeature/enablement/setRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "mcpServer/oauth/login" + ], + "title": "McpServer/oauth/loginRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpServerOauthLoginParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServer/oauth/loginRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "config/mcpServer/reload" + ], + "title": "Config/mcpServer/reloadRequestMethod", + "type": "string" + }, + "params": { + "type": "null" + } + }, + "required": [ + "id", + "method" + ], + "title": "Config/mcpServer/reloadRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "mcpServerStatus/list" + ], + "title": "McpServerStatus/listRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ListMcpServerStatusParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServerStatus/listRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "mcpServer/resource/read" + ], + "title": "McpServer/resource/readRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpResourceReadParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServer/resource/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "mcpServer/tool/call" + ], + "title": "McpServer/tool/callRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpServerToolCallParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "McpServer/tool/callRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "windowsSandbox/setupStart" + ], + "title": "WindowsSandbox/setupStartRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/WindowsSandboxSetupStartParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "WindowsSandbox/setupStartRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/login/start" + ], + "title": "Account/login/startRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/LoginAccountParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/login/startRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/login/cancel" + ], + "title": "Account/login/cancelRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CancelLoginAccountParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/login/cancelRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/logout" + ], + "title": "Account/logoutRequestMethod", + "type": "string" + }, + "params": { + "type": "null" + } + }, + "required": [ + "id", + "method" + ], + "title": "Account/logoutRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/rateLimits/read" + ], + "title": "Account/rateLimits/readRequestMethod", + "type": "string" + }, + "params": { + "type": "null" + } + }, + "required": [ + "id", + "method" + ], + "title": "Account/rateLimits/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/sendAddCreditsNudgeEmail" + ], + "title": "Account/sendAddCreditsNudgeEmailRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/SendAddCreditsNudgeEmailParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/sendAddCreditsNudgeEmailRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "feedback/upload" + ], + "title": "Feedback/uploadRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FeedbackUploadParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Feedback/uploadRequest", + "type": "object" + }, + { + "description": "Execute a standalone command (argv vector) under the server's sandbox.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "command/exec" + ], + "title": "Command/execRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Command/execRequest", + "type": "object" + }, + { + "description": "Write stdin bytes to a running `command/exec` session or close stdin.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "command/exec/write" + ], + "title": "Command/exec/writeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecWriteParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Command/exec/writeRequest", + "type": "object" + }, + { + "description": "Terminate a running `command/exec` session by client-supplied `processId`.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "command/exec/terminate" + ], + "title": "Command/exec/terminateRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecTerminateParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Command/exec/terminateRequest", + "type": "object" + }, + { + "description": "Resize a running PTY-backed `command/exec` session by client-supplied `processId`.", + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "command/exec/resize" + ], + "title": "Command/exec/resizeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecResizeParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Command/exec/resizeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "config/read" + ], + "title": "Config/readRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ConfigReadParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Config/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "config/value/write" + ], + "title": "Config/value/writeRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ConfigValueWriteParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Config/value/writeRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "config/batchWrite" + ], + "title": "Config/batchWriteRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ConfigBatchWriteParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Config/batchWriteRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "configRequirements/read" + ], + "title": "ConfigRequirements/readRequestMethod", + "type": "string" + }, + "params": { + "type": "null" + } + }, + "required": [ + "id", + "method" + ], + "title": "ConfigRequirements/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "account/read" + ], + "title": "Account/readRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/GetAccountParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "Account/readRequest", + "type": "object" + }, + { + "properties": { + "id": { + "$ref": "#/definitions/RequestId" + }, + "method": { + "enum": [ + "fuzzyFileSearch" + ], + "title": "FuzzyFileSearchRequestMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FuzzyFileSearchParams" + } + }, + "required": [ + "id", + "method", + "params" + ], + "title": "FuzzyFileSearchRequest", + "type": "object" + } + ], + "title": "ClientRequest" + }, + "CodexErrorInfo": { + "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", + "oneOf": [ + { "enum": [ - "image" - ] + "contextWindowExceeded", + "usageLimitExceeded", + "serverOverloaded", + "internalServerError", + "unauthorized", + "badRequest", + "threadRollbackFailed", + "sandboxError", + "other" + ], + "type": "string" + }, + { + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, + "required": [ + "httpConnectionFailed" + ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", + "properties": { + "responseStreamConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, + "required": [ + "responseStreamConnectionFailed" + ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", + "properties": { + "responseStreamDisconnected": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, + "required": [ + "responseStreamDisconnected" + ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", + "properties": { + "responseTooManyFailedAttempts": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, + "required": [ + "responseTooManyFailedAttempts" + ], + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", + "properties": { + "activeTurnNotSteerable": { + "properties": { + "turnKind": { + "$ref": "#/definitions/NonSteerableTurnKind" + } + }, + "required": [ + "turnKind" + ], + "type": "object" + } + }, + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, - "Model": { - "type": "object", - "required": [ - "defaultReasoningEffort", - "description", - "displayName", - "hidden", - "id", - "isDefault", - "model", - "supportedReasoningEfforts" - ], - "properties": { - "additionalSpeedTiers": { - "default": [], - "type": "array", - "items": { - "type": "string" - } - }, - "availabilityNux": { - "anyOf": [ - { - "$ref": "#/definitions/ModelAvailabilityNux" - }, - { - "type": "null" - } - ] - }, - "defaultReasoningEffort": { - "$ref": "#/definitions/ReasoningEffort" - }, - "description": { - "type": "string" - }, - "displayName": { - "type": "string" - }, - "hidden": { - "type": "boolean" - }, - "id": { - "type": "string" - }, - "inputModalities": { - "default": [ - "text", - "image" - ], - "type": "array", - "items": { - "$ref": "#/definitions/InputModality" - } - }, - "isDefault": { - "type": "boolean" - }, - "model": { - "type": "string" - }, - "supportedReasoningEfforts": { - "type": "array", - "items": { - "$ref": "#/definitions/ReasoningEffortOption" - } - }, - "supportsPersonality": { - "default": false, - "type": "boolean" - }, - "upgrade": { - "type": [ - "string", - "null" - ] - }, - "upgradeInfo": { - "anyOf": [ - { - "$ref": "#/definitions/ModelUpgradeInfo" - }, - { - "type": "null" - } - ] - } - } - }, - "ModelAvailabilityNux": { - "type": "object", - "required": [ - "message" - ], + "CollabAgentState": { "properties": { "message": { - "type": "string" + "type": [ + "string", + "null" + ] + }, + "status": { + "$ref": "#/definitions/CollabAgentStatus" } - } - }, - "ModelUpgradeInfo": { - "type": "object", + }, "required": [ - "model" + "status" ], - "properties": { - "migrationMarkdown": { - "type": [ - "string", - "null" - ] - }, - "model": { - "type": "string" - }, - "modelLink": { - "type": [ - "string", - "null" - ] - }, - "upgradeCopy": { - "type": [ - "string", - "null" - ] - } - } + "type": "object" }, - "ReasoningEffortOption": { - "type": "object", + "CollabAgentStatus": { + "enum": [ + "pendingInit", + "running", + "interrupted", + "completed", + "errored", + "shutdown", + "notFound" + ], + "type": "string" + }, + "CollabAgentTool": { + "enum": [ + "spawnAgent", + "sendInput", + "resumeAgent", + "wait", + "closeAgent" + ], + "type": "string" + }, + "CollabAgentToolCallStatus": { + "enum": [ + "inProgress", + "completed", + "failed" + ], + "type": "string" + }, + "CollaborationMode": { + "description": "Collaboration mode for a Codex session.", + "properties": { + "mode": { + "$ref": "#/definitions/ModeKind" + }, + "settings": { + "$ref": "#/definitions/Settings" + } + }, "required": [ - "description", - "reasoningEffort" + "mode", + "settings" ], - "properties": { - "description": { - "type": "string" - }, - "reasoningEffort": { - "$ref": "#/definitions/ReasoningEffort" - } - } - }, - "ModelListResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ModelListResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/Model" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - } - }, - "ExperimentalFeature": { - "type": "object", - "required": [ - "defaultEnabled", - "enabled", - "name", - "stage" - ], - "properties": { - "announcement": { - "description": "Announcement copy shown to users when the feature is introduced. Null when this feature is not in beta.", - "type": [ - "string", - "null" - ] - }, - "defaultEnabled": { - "description": "Whether this feature is enabled by default.", - "type": "boolean" - }, - "description": { - "description": "Short summary describing what the feature does. Null when this feature is not in beta.", - "type": [ - "string", - "null" - ] - }, - "displayName": { - "description": "User-facing display name shown in the experimental features UI. Null when this feature is not in beta.", - "type": [ - "string", - "null" - ] - }, - "enabled": { - "description": "Whether this feature is currently enabled in the loaded config.", - "type": "boolean" - }, - "name": { - "description": "Stable key used in config.toml and CLI flag toggles.", - "type": "string" - }, - "stage": { - "description": "Lifecycle stage of this feature flag.", - "allOf": [ - { - "$ref": "#/definitions/ExperimentalFeatureStage" - } - ] - } - } - }, - "ExperimentalFeatureStage": { - "oneOf": [ - { - "description": "Feature is available for user testing and feedback.", - "type": "string", - "enum": [ - "beta" - ] - }, - { - "description": "Feature is still being built and not ready for broad use.", - "type": "string", - "enum": [ - "underDevelopment" - ] - }, - { - "description": "Feature is production-ready.", - "type": "string", - "enum": [ - "stable" - ] - }, - { - "description": "Feature is deprecated and should be avoided.", - "type": "string", - "enum": [ - "deprecated" - ] - }, - { - "description": "Feature flag is retained only for backwards compatibility.", - "type": "string", - "enum": [ - "removed" - ] - } - ] - }, - "ExperimentalFeatureListResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExperimentalFeatureListResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/ExperimentalFeature" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - } - }, - "ExperimentalFeatureEnablementSetResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExperimentalFeatureEnablementSetResponse", - "type": "object", - "required": [ - "enablement" - ], - "properties": { - "enablement": { - "description": "Feature enablement entries updated by this request.", - "type": "object", - "additionalProperties": { - "type": "boolean" - } - } - } + "type": "object" }, "CollaborationModeMask": { "description": "EXPERIMENTAL - collaboration mode preset metadata for clients.", - "type": "object", - "required": [ - "name" - ], "properties": { "mode": { "anyOf": [ @@ -12277,886 +2050,317 @@ } ] } - } + }, + "required": [ + "name" + ], + "type": "object" }, - "GuardianApprovalReviewAction": { + "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "cwd", - "source", - "type" - ], "properties": { "command": { "type": "string" }, - "cwd": { + "name": { + "type": "string" + }, + "path": { "$ref": "#/definitions/AbsolutePathBuf" }, - "source": { - "$ref": "#/definitions/GuardianCommandSource" - }, "type": { - "type": "string", "enum": [ - "command" + "read" ], - "title": "CommandGuardianApprovalReviewActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "CommandGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "argv", - "cwd", - "program", - "source", + "command", + "name", + "path", "type" ], - "properties": { - "argv": { - "type": "array", - "items": { - "type": "string" - } - }, - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "program": { - "type": "string" - }, - "source": { - "$ref": "#/definitions/GuardianCommandSource" - }, - "type": { - "type": "string", - "enum": [ - "execve" - ], - "title": "ExecveGuardianApprovalReviewActionType" - } - }, - "title": "ExecveGuardianApprovalReviewAction" + "title": "ReadCommandAction", + "type": "object" }, { - "type": "object", - "required": [ - "cwd", - "files", - "type" - ], "properties": { - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "files": { - "type": "array", - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "type": { - "type": "string", - "enum": [ - "applyPatch" - ], - "title": "ApplyPatchGuardianApprovalReviewActionType" - } - }, - "title": "ApplyPatchGuardianApprovalReviewAction" - }, - { - "type": "object", - "required": [ - "host", - "port", - "protocol", - "target", - "type" - ], - "properties": { - "host": { + "command": { "type": "string" }, - "port": { - "type": "integer", - "format": "uint16", - "minimum": 0.0 - }, - "protocol": { - "$ref": "#/definitions/NetworkApprovalProtocol" - }, - "target": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "networkAccess" - ], - "title": "NetworkAccessGuardianApprovalReviewActionType" - } - }, - "title": "NetworkAccessGuardianApprovalReviewAction" - }, - { - "type": "object", - "required": [ - "server", - "toolName", - "type" - ], - "properties": { - "connectorId": { - "type": [ - "string", - "null" - ] - }, - "connectorName": { - "type": [ - "string", - "null" - ] - }, - "server": { - "type": "string" - }, - "toolName": { - "type": "string" - }, - "toolTitle": { + "path": { "type": [ "string", "null" ] }, "type": { - "type": "string", "enum": [ - "mcpToolCall" + "listFiles" ], - "title": "McpToolCallGuardianApprovalReviewActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "McpToolCallGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "permissions", + "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { - "permissions": { - "$ref": "#/definitions/RequestPermissionProfile" + "command": { + "type": "string" }, - "reason": { + "path": { + "type": [ + "string", + "null" + ] + }, + "query": { "type": [ "string", "null" ] }, "type": { - "type": "string", "enum": [ - "requestPermissions" + "search" ], - "title": "RequestPermissionsGuardianApprovalReviewActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "RequestPermissionsGuardianApprovalReviewAction" + "required": [ + "command", + "type" + ], + "title": "SearchCommandAction", + "type": "object" + }, + { + "properties": { + "command": { + "type": "string" + }, + "type": { + "enum": [ + "unknown" + ], + "title": "UnknownCommandActionType", + "type": "string" + } + }, + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, - "GuardianApprovalReview": { - "description": "[UNSTABLE] Temporary approval auto-review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.", - "type": "object", - "required": [ - "status" - ], - "properties": { - "rationale": { - "type": [ - "string", - "null" - ] - }, - "riskLevel": { - "anyOf": [ - { - "$ref": "#/definitions/GuardianRiskLevel" - }, - { - "type": "null" - } - ] - }, - "status": { - "$ref": "#/definitions/GuardianApprovalReviewStatus" - }, - "userAuthorization": { - "anyOf": [ - { - "$ref": "#/definitions/GuardianUserAuthorization" - }, - { - "type": "null" - } - ] - } - } - }, - "McpServerOauthLoginResponse": { + "CommandExecOutputDeltaNotification": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerOauthLoginResponse", - "type": "object", - "required": [ - "authorizationUrl" - ], + "description": "Base64-encoded output chunk emitted for a streaming `command/exec` request.\n\nThese notifications are connection-scoped. If the originating connection closes, the server terminates the process.", "properties": { - "authorizationUrl": { - "type": "string" - } - } - }, - "McpServerRefreshResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerRefreshResponse", - "type": "object" - }, - "McpAuthStatus": { - "type": "string", - "enum": [ - "unsupported", - "notLoggedIn", - "bearerToken", - "oAuth" - ] - }, - "McpServerStatus": { - "type": "object", - "required": [ - "authStatus", - "name", - "resourceTemplates", - "resources", - "tools" - ], - "properties": { - "authStatus": { - "$ref": "#/definitions/McpAuthStatus" - }, - "name": { - "type": "string" - }, - "resourceTemplates": { - "type": "array", - "items": { - "$ref": "#/definitions/ResourceTemplate" - } - }, - "resources": { - "type": "array", - "items": { - "$ref": "#/definitions/Resource" - } - }, - "tools": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/Tool" - } - } - } - }, - "Resource": { - "description": "A known resource that the server is capable of reading.", - "type": "object", - "required": [ - "name", - "uri" - ], - "properties": { - "_meta": true, - "annotations": true, - "description": { - "type": [ - "string", - "null" - ] - }, - "icons": { - "type": [ - "array", - "null" - ], - "items": true - }, - "mimeType": { - "type": [ - "string", - "null" - ] - }, - "name": { - "type": "string" - }, - "size": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "title": { - "type": [ - "string", - "null" - ] - }, - "uri": { - "type": "string" - } - } - }, - "ResourceTemplate": { - "description": "A template description for resources available on the server.", - "type": "object", - "required": [ - "name", - "uriTemplate" - ], - "properties": { - "annotations": true, - "description": { - "type": [ - "string", - "null" - ] - }, - "mimeType": { - "type": [ - "string", - "null" - ] - }, - "name": { - "type": "string" - }, - "title": { - "type": [ - "string", - "null" - ] - }, - "uriTemplate": { - "type": "string" - } - } - }, - "Tool": { - "description": "Definition for a tool the client can call.", - "type": "object", - "required": [ - "inputSchema", - "name" - ], - "properties": { - "_meta": true, - "annotations": true, - "description": { - "type": [ - "string", - "null" - ] - }, - "icons": { - "type": [ - "array", - "null" - ], - "items": true - }, - "inputSchema": true, - "name": { - "type": "string" - }, - "outputSchema": true, - "title": { - "type": [ - "string", - "null" - ] - } - } - }, - "ListMcpServerStatusResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ListMcpServerStatusResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/McpServerStatus" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - } - }, - "ResourceContent": { - "description": "Contents returned when reading a resource from an MCP server.", - "anyOf": [ - { - "type": "object", - "required": [ - "text", - "uri" - ], - "properties": { - "_meta": true, - "mimeType": { - "type": [ - "string", - "null" - ] - }, - "text": { - "type": "string" - }, - "uri": { - "description": "The URI of this resource.", - "type": "string" - } - } - }, - { - "type": "object", - "required": [ - "blob", - "uri" - ], - "properties": { - "_meta": true, - "blob": { - "type": "string" - }, - "mimeType": { - "type": [ - "string", - "null" - ] - }, - "uri": { - "description": "The URI of this resource.", - "type": "string" - } - } - } - ] - }, - "McpResourceReadResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpResourceReadResponse", - "type": "object", - "required": [ - "contents" - ], - "properties": { - "contents": { - "type": "array", - "items": { - "$ref": "#/definitions/ResourceContent" - } - } - } - }, - "McpServerToolCallResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerToolCallResponse", - "type": "object", - "required": [ - "content" - ], - "properties": { - "_meta": true, - "content": { - "type": "array", - "items": true - }, - "isError": { - "type": [ - "boolean", - "null" - ] - }, - "structuredContent": true - } - }, - "WindowsSandboxSetupStartResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WindowsSandboxSetupStartResponse", - "type": "object", - "required": [ - "started" - ], - "properties": { - "started": { - "type": "boolean" - } - } - }, - "LoginAccountResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "LoginAccountResponse", - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "apiKey" - ], - "title": "ApiKeyv2::LoginAccountResponseType" - } - }, - "title": "ApiKeyv2::LoginAccountResponse" - }, - { - "type": "object", - "required": [ - "authUrl", - "loginId", - "type" - ], - "properties": { - "authUrl": { - "description": "URL the client should open in a browser to initiate the OAuth flow.", - "type": "string" - }, - "loginId": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "chatgpt" - ], - "title": "Chatgptv2::LoginAccountResponseType" - } - }, - "title": "Chatgptv2::LoginAccountResponse" - }, - { - "type": "object", - "required": [ - "loginId", - "type", - "userCode", - "verificationUrl" - ], - "properties": { - "loginId": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "chatgptDeviceCode" - ], - "title": "ChatgptDeviceCodev2::LoginAccountResponseType" - }, - "userCode": { - "description": "One-time code the user must enter after signing in.", - "type": "string" - }, - "verificationUrl": { - "description": "URL the client should open in a browser to complete device code authorization.", - "type": "string" - } - }, - "title": "ChatgptDeviceCodev2::LoginAccountResponse" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "chatgptAuthTokens" - ], - "title": "ChatgptAuthTokensv2::LoginAccountResponseType" - } - }, - "title": "ChatgptAuthTokensv2::LoginAccountResponse" - } - ] - }, - "CancelLoginAccountStatus": { - "type": "string", - "enum": [ - "canceled", - "notFound" - ] - }, - "CancelLoginAccountResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CancelLoginAccountResponse", - "type": "object", - "required": [ - "status" - ], - "properties": { - "status": { - "$ref": "#/definitions/CancelLoginAccountStatus" - } - } - }, - "LogoutAccountResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "LogoutAccountResponse", - "type": "object" - }, - "CreditsSnapshot": { - "type": "object", - "required": [ - "hasCredits", - "unlimited" - ], - "properties": { - "balance": { - "type": [ - "string", - "null" - ] - }, - "hasCredits": { + "capReached": { + "description": "`true` on the final streamed chunk for a stream when `outputBytesCap` truncated later output on that stream.", "type": "boolean" }, - "unlimited": { - "type": "boolean" - } - } - }, - "PlanType": { - "type": "string", - "enum": [ - "free", - "go", - "plus", - "pro", - "prolite", - "team", - "self_serve_business_usage_based", - "business", - "enterprise_cbp_usage_based", - "enterprise", - "edu", - "unknown" - ] - }, - "RateLimitReachedType": { - "type": "string", - "enum": [ - "rate_limit_reached", - "workspace_owner_credits_depleted", - "workspace_member_credits_depleted", - "workspace_owner_usage_limit_reached", - "workspace_member_usage_limit_reached" - ] - }, - "RateLimitSnapshot": { - "type": "object", - "properties": { - "credits": { - "anyOf": [ - { - "$ref": "#/definitions/CreditsSnapshot" - }, - { - "type": "null" - } - ] + "deltaBase64": { + "description": "Base64-encoded output bytes.", + "type": "string" }, - "limitId": { - "type": [ - "string", - "null" - ] + "processId": { + "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", + "type": "string" }, - "limitName": { - "type": [ - "string", - "null" - ] - }, - "planType": { - "anyOf": [ - { - "$ref": "#/definitions/PlanType" - }, - { - "type": "null" - } - ] - }, - "primary": { - "anyOf": [ - { - "$ref": "#/definitions/RateLimitWindow" - }, - { - "type": "null" - } - ] - }, - "rateLimitReachedType": { - "anyOf": [ - { - "$ref": "#/definitions/RateLimitReachedType" - }, - { - "type": "null" - } - ] - }, - "secondary": { - "anyOf": [ - { - "$ref": "#/definitions/RateLimitWindow" - }, - { - "type": "null" - } - ] - } - } - }, - "RateLimitWindow": { - "type": "object", - "required": [ - "usedPercent" - ], - "properties": { - "resetsAt": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "usedPercent": { - "type": "integer", - "format": "int32" - }, - "windowDurationMins": { - "type": [ - "integer", - "null" - ], - "format": "int64" - } - } - }, - "GetAccountRateLimitsResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "GetAccountRateLimitsResponse", - "type": "object", - "required": [ - "rateLimits" - ], - "properties": { - "rateLimits": { - "description": "Backward-compatible single-bucket view; mirrors the historical payload.", + "stream": { "allOf": [ { - "$ref": "#/definitions/RateLimitSnapshot" + "$ref": "#/definitions/CommandExecOutputStream" } + ], + "description": "Output stream for this chunk." + } + }, + "required": [ + "capReached", + "deltaBase64", + "processId", + "stream" + ], + "title": "CommandExecOutputDeltaNotification", + "type": "object" + }, + "CommandExecOutputStream": { + "description": "Stream label for `command/exec/outputDelta` notifications.", + "oneOf": [ + { + "description": "stdout stream. PTY mode multiplexes terminal output here.", + "enum": [ + "stdout" + ], + "type": "string" + }, + { + "description": "stderr stream.", + "enum": [ + "stderr" + ], + "type": "string" + } + ] + }, + "CommandExecParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Run a standalone command (argv vector) in the server sandbox without creating a thread or turn.\n\nThe final `command/exec` response is deferred until the process exits and is sent only after all `command/exec/outputDelta` notifications for that connection have been emitted.", + "properties": { + "command": { + "description": "Command argv vector. Empty arrays are rejected.", + "items": { + "type": "string" + }, + "type": "array" + }, + "cwd": { + "description": "Optional working directory. Defaults to the server cwd.", + "type": [ + "string", + "null" ] }, - "rateLimitsByLimitId": { - "description": "Multi-bucket view keyed by metered `limit_id` (for example, `codex`).", + "disableOutputCap": { + "description": "Disable stdout/stderr capture truncation for this request.\n\nCannot be combined with `outputBytesCap`.", + "type": "boolean" + }, + "disableTimeout": { + "description": "Disable the timeout entirely for this request.\n\nCannot be combined with `timeoutMs`.", + "type": "boolean" + }, + "env": { + "additionalProperties": { + "type": [ + "string", + "null" + ] + }, + "description": "Optional environment overrides merged into the server-computed environment.\n\nMatching names override inherited values. Set a key to `null` to unset an inherited variable.", "type": [ "object", "null" + ] + }, + "outputBytesCap": { + "description": "Optional per-stream stdout/stderr capture cap in bytes.\n\nWhen omitted, the server default applies. Cannot be combined with `disableOutputCap`.", + "format": "uint", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "processId": { + "description": "Optional client-supplied, connection-scoped process id.\n\nRequired for `tty`, `streamStdin`, `streamStdoutStderr`, and follow-up `command/exec/write`, `command/exec/resize`, and `command/exec/terminate` calls. When omitted, buffered execution gets an internal id that is not exposed to the client.", + "type": [ + "string", + "null" + ] + }, + "sandboxPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/SandboxPolicy" + }, + { + "type": "null" + } ], - "additionalProperties": { - "$ref": "#/definitions/RateLimitSnapshot" - } + "description": "Optional sandbox policy for this command.\n\nUses the same shape as thread/turn execution sandbox configuration and defaults to the user's configured policy when omitted." + }, + "size": { + "anyOf": [ + { + "$ref": "#/definitions/CommandExecTerminalSize" + }, + { + "type": "null" + } + ], + "description": "Optional initial PTY size in character cells. Only valid when `tty` is true." + }, + "streamStdin": { + "description": "Allow follow-up `command/exec/write` requests to write stdin bytes.\n\nRequires a client-supplied `processId`.", + "type": "boolean" + }, + "streamStdoutStderr": { + "description": "Stream stdout/stderr via `command/exec/outputDelta` notifications.\n\nStreamed bytes are not duplicated into the final response and require a client-supplied `processId`.", + "type": "boolean" + }, + "timeoutMs": { + "description": "Optional timeout in milliseconds.\n\nWhen omitted, the server default applies. Cannot be combined with `disableTimeout`.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "tty": { + "description": "Enable PTY mode.\n\nThis implies `streamStdin` and `streamStdoutStderr`.", + "type": "boolean" } - } - }, - "AddCreditsNudgeEmailStatus": { - "type": "string", - "enum": [ - "sent", - "cooldown_active" - ] - }, - "SendAddCreditsNudgeEmailResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "SendAddCreditsNudgeEmailResponse", - "type": "object", + }, "required": [ - "status" + "command" ], - "properties": { - "status": { - "$ref": "#/definitions/AddCreditsNudgeEmailStatus" - } - } + "title": "CommandExecParams", + "type": "object" }, - "FeedbackUploadResponse": { + "CommandExecResizeParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FeedbackUploadResponse", - "type": "object", - "required": [ - "threadId" - ], + "description": "Resize a running PTY-backed `command/exec` session.", "properties": { - "threadId": { + "processId": { + "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", "type": "string" + }, + "size": { + "allOf": [ + { + "$ref": "#/definitions/CommandExecTerminalSize" + } + ], + "description": "New PTY size in character cells." } - } + }, + "required": [ + "processId", + "size" + ], + "title": "CommandExecResizeParams", + "type": "object" + }, + "CommandExecResizeResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Empty success response for `command/exec/resize`.", + "title": "CommandExecResizeResponse", + "type": "object" }, "CommandExecResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecResponse", "description": "Final buffered result for `command/exec`.", - "type": "object", - "required": [ - "exitCode", - "stderr", - "stdout" - ], "properties": { "exitCode": { "description": "Process exit code.", - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "stderr": { "description": "Buffered stderr capture.\n\nEmpty when stderr was streamed via `command/exec/outputDelta`.", @@ -13166,40 +2370,135 @@ "description": "Buffered stdout capture.\n\nEmpty when stdout was streamed via `command/exec/outputDelta`.", "type": "string" } - } + }, + "required": [ + "exitCode", + "stderr", + "stdout" + ], + "title": "CommandExecResponse", + "type": "object" }, - "CommandExecWriteResponse": { + "CommandExecTerminalSize": { + "description": "PTY size in character cells for `command/exec` PTY sessions.", + "properties": { + "cols": { + "description": "Terminal width in character cells.", + "format": "uint16", + "minimum": 0.0, + "type": "integer" + }, + "rows": { + "description": "Terminal height in character cells.", + "format": "uint16", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "cols", + "rows" + ], + "type": "object" + }, + "CommandExecTerminateParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecWriteResponse", - "description": "Empty success response for `command/exec/write`.", + "description": "Terminate a running `command/exec` session.", + "properties": { + "processId": { + "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", + "type": "string" + } + }, + "required": [ + "processId" + ], + "title": "CommandExecTerminateParams", "type": "object" }, "CommandExecTerminateResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecTerminateResponse", "description": "Empty success response for `command/exec/terminate`.", + "title": "CommandExecTerminateResponse", "type": "object" }, - "CommandExecResizeResponse": { + "CommandExecWriteParams": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecResizeResponse", - "description": "Empty success response for `command/exec/resize`.", - "type": "object" - }, - "AnalyticsConfig": { - "type": "object", + "description": "Write stdin bytes to a running `command/exec` session, close stdin, or both.", "properties": { - "enabled": { + "closeStdin": { + "description": "Close stdin after writing `deltaBase64`, if present.", + "type": "boolean" + }, + "deltaBase64": { + "description": "Optional base64-encoded stdin bytes to write.", "type": [ - "boolean", + "string", "null" ] + }, + "processId": { + "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", + "type": "string" } }, - "additionalProperties": true + "required": [ + "processId" + ], + "title": "CommandExecWriteParams", + "type": "object" + }, + "CommandExecWriteResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Empty success response for `command/exec/write`.", + "title": "CommandExecWriteResponse", + "type": "object" + }, + "CommandExecutionOutputDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "CommandExecutionOutputDeltaNotification", + "type": "object" + }, + "CommandExecutionSource": { + "enum": [ + "agent", + "userShell", + "unifiedExecStartup", + "unifiedExecInteraction" + ], + "type": "string" + }, + "CommandExecutionStatus": { + "enum": [ + "inProgress", + "completed", + "failed", + "declined" + ], + "type": "string" }, "Config": { - "type": "object", + "additionalProperties": true, "properties": { "analytics": { "anyOf": [ @@ -13222,7 +2521,6 @@ ] }, "approvals_reviewer": { - "description": "[UNSTABLE] Optional default for where approval requests are routed for review.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -13230,7 +2528,8 @@ { "type": "null" } - ] + ], + "description": "[UNSTABLE] Optional default for where approval requests are routed for review." }, "compact_prompt": { "type": [ @@ -13273,18 +2572,18 @@ ] }, "model_auto_compact_token_limit": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "model_context_window": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "model_provider": { "type": [ @@ -13329,11 +2628,11 @@ ] }, "profiles": { - "default": {}, - "type": "object", "additionalProperties": { "$ref": "#/definitions/ProfileV2" - } + }, + "default": {}, + "type": "object" }, "review_model": { "type": [ @@ -13392,15 +2691,59 @@ ] } }, - "additionalProperties": true + "type": "object" + }, + "ConfigBatchWriteParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "edits": { + "items": { + "$ref": "#/definitions/ConfigEdit" + }, + "type": "array" + }, + "expectedVersion": { + "type": [ + "string", + "null" + ] + }, + "filePath": { + "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.", + "type": [ + "string", + "null" + ] + }, + "reloadUserConfig": { + "description": "When true, hot-reload the updated user config into all loaded threads after writing.", + "type": "boolean" + } + }, + "required": [ + "edits" + ], + "title": "ConfigBatchWriteParams", + "type": "object" + }, + "ConfigEdit": { + "properties": { + "keyPath": { + "type": "string" + }, + "mergeStrategy": { + "$ref": "#/definitions/MergeStrategy" + }, + "value": true + }, + "required": [ + "keyPath", + "mergeStrategy", + "value" + ], + "type": "object" }, "ConfigLayer": { - "type": "object", - "required": [ - "config", - "name", - "version" - ], "properties": { "config": true, "disabledReason": { @@ -13415,14 +2758,15 @@ "version": { "type": "string" } - } - }, - "ConfigLayerMetadata": { - "type": "object", + }, "required": [ + "config", "name", "version" ], + "type": "object" + }, + "ConfigLayerMetadata": { "properties": { "name": { "$ref": "#/definitions/ConfigLayerSource" @@ -13430,18 +2774,17 @@ "version": { "type": "string" } - } + }, + "required": [ + "name", + "version" + ], + "type": "object" }, "ConfigLayerSource": { "oneOf": [ { "description": "Managed preferences layer delivered by MDM (macOS only).", - "type": "object", - "required": [ - "domain", - "key", - "type" - ], "properties": { "domain": { "type": "string" @@ -13450,153 +2793,5547 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mdm" ], - "title": "MdmConfigLayerSourceType" + "title": "MdmConfigLayerSourceType", + "type": "string" } }, - "title": "MdmConfigLayerSource" + "required": [ + "domain", + "key", + "type" + ], + "title": "MdmConfigLayerSource", + "type": "object" }, { "description": "Managed config layer from a file (usually `managed_config.toml`).", - "type": "object", - "required": [ - "file", - "type" - ], "properties": { "file": { - "description": "This is the path to the system config.toml file, though it is not guaranteed to exist.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "This is the path to the system config.toml file, though it is not guaranteed to exist." }, "type": { - "type": "string", "enum": [ "system" ], - "title": "SystemConfigLayerSourceType" + "title": "SystemConfigLayerSourceType", + "type": "string" } }, - "title": "SystemConfigLayerSource" - }, - { - "description": "User config layer from $CODEX_HOME/config.toml. This layer is special in that it is expected to be: - writable by the user - generally outside the workspace directory", - "type": "object", "required": [ "file", "type" ], + "title": "SystemConfigLayerSource", + "type": "object" + }, + { + "description": "User config layer from $CODEX_HOME/config.toml. This layer is special in that it is expected to be: - writable by the user - generally outside the workspace directory", "properties": { "file": { - "description": "This is the path to the user's config.toml file, though it is not guaranteed to exist.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "This is the path to the user's config.toml file, though it is not guaranteed to exist." }, "type": { - "type": "string", "enum": [ "user" ], - "title": "UserConfigLayerSourceType" + "title": "UserConfigLayerSourceType", + "type": "string" } }, - "title": "UserConfigLayerSource" + "required": [ + "file", + "type" + ], + "title": "UserConfigLayerSource", + "type": "object" }, { "description": "Path to a .codex/ folder within a project. There could be multiple of these between `cwd` and the project/repo root.", - "type": "object", - "required": [ - "dotCodexFolder", - "type" - ], "properties": { "dotCodexFolder": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "project" ], - "title": "ProjectConfigLayerSourceType" + "title": "ProjectConfigLayerSourceType", + "type": "string" } }, - "title": "ProjectConfigLayerSource" + "required": [ + "dotCodexFolder", + "type" + ], + "title": "ProjectConfigLayerSource", + "type": "object" }, { "description": "Session-layer overrides supplied via `-c`/`--config`.", - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "sessionFlags" ], - "title": "SessionFlagsConfigLayerSourceType" + "title": "SessionFlagsConfigLayerSourceType", + "type": "string" } }, - "title": "SessionFlagsConfigLayerSource" + "required": [ + "type" + ], + "title": "SessionFlagsConfigLayerSource", + "type": "object" }, { "description": "`managed_config.toml` was designed to be a config that was loaded as the last layer on top of everything else. This scheme did not quite work out as intended, but we keep this variant as a \"best effort\" while we phase out `managed_config.toml` in favor of `requirements.toml`.", - "type": "object", - "required": [ - "file", - "type" - ], "properties": { "file": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "legacyManagedConfigTomlFromFile" ], - "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType" + "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType", + "type": "string" } }, - "title": "LegacyManagedConfigTomlFromFileConfigLayerSource" - }, - { - "type": "object", "required": [ + "file", "type" ], + "title": "LegacyManagedConfigTomlFromFileConfigLayerSource", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "legacyManagedConfigTomlFromMdm" ], - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType" + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType", + "type": "string" } }, - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource" + "required": [ + "type" + ], + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource", + "type": "object" } ] }, + "ConfigReadParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cwd": { + "description": "Optional working directory to resolve project config layers. If specified, return the effective config as seen from that directory (i.e., including any project layers between `cwd` and the project/repo root).", + "type": [ + "string", + "null" + ] + }, + "includeLayers": { + "default": false, + "type": "boolean" + } + }, + "title": "ConfigReadParams", + "type": "object" + }, + "ConfigReadResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "config": { + "$ref": "#/definitions/Config" + }, + "layers": { + "items": { + "$ref": "#/definitions/ConfigLayer" + }, + "type": [ + "array", + "null" + ] + }, + "origins": { + "additionalProperties": { + "$ref": "#/definitions/ConfigLayerMetadata" + }, + "type": "object" + } + }, + "required": [ + "config", + "origins" + ], + "title": "ConfigReadResponse", + "type": "object" + }, + "ConfigRequirements": { + "properties": { + "allowedApprovalPolicies": { + "items": { + "$ref": "#/definitions/AskForApproval" + }, + "type": [ + "array", + "null" + ] + }, + "allowedSandboxModes": { + "items": { + "$ref": "#/definitions/SandboxMode" + }, + "type": [ + "array", + "null" + ] + }, + "allowedWebSearchModes": { + "items": { + "$ref": "#/definitions/WebSearchMode" + }, + "type": [ + "array", + "null" + ] + }, + "enforceResidency": { + "anyOf": [ + { + "$ref": "#/definitions/ResidencyRequirement" + }, + { + "type": "null" + } + ] + }, + "featureRequirements": { + "additionalProperties": { + "type": "boolean" + }, + "type": [ + "object", + "null" + ] + } + }, + "type": "object" + }, + "ConfigRequirementsReadResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "requirements": { + "anyOf": [ + { + "$ref": "#/definitions/ConfigRequirements" + }, + { + "type": "null" + } + ], + "description": "Null if no requirements are configured (e.g. no requirements.toml/MDM entries)." + } + }, + "title": "ConfigRequirementsReadResponse", + "type": "object" + }, + "ConfigValueWriteParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "expectedVersion": { + "type": [ + "string", + "null" + ] + }, + "filePath": { + "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.", + "type": [ + "string", + "null" + ] + }, + "keyPath": { + "type": "string" + }, + "mergeStrategy": { + "$ref": "#/definitions/MergeStrategy" + }, + "value": true + }, + "required": [ + "keyPath", + "mergeStrategy", + "value" + ], + "title": "ConfigValueWriteParams", + "type": "object" + }, + "ConfigWarningNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "details": { + "description": "Optional extra guidance or error details.", + "type": [ + "string", + "null" + ] + }, + "path": { + "description": "Optional path to the config file that triggered the warning.", + "type": [ + "string", + "null" + ] + }, + "range": { + "anyOf": [ + { + "$ref": "#/definitions/TextRange" + }, + { + "type": "null" + } + ], + "description": "Optional range for the error location inside the config file." + }, + "summary": { + "description": "Concise summary of the warning.", + "type": "string" + } + }, + "required": [ + "summary" + ], + "title": "ConfigWarningNotification", + "type": "object" + }, + "ConfigWriteResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "filePath": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Canonical path to the config file that was written." + }, + "overriddenMetadata": { + "anyOf": [ + { + "$ref": "#/definitions/OverriddenMetadata" + }, + { + "type": "null" + } + ] + }, + "status": { + "$ref": "#/definitions/WriteStatus" + }, + "version": { + "type": "string" + } + }, + "required": [ + "filePath", + "status", + "version" + ], + "title": "ConfigWriteResponse", + "type": "object" + }, + "ContentItem": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "input_text" + ], + "title": "InputTextContentItemType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "InputTextContentItem", + "type": "object" + }, + { + "properties": { + "detail": { + "anyOf": [ + { + "$ref": "#/definitions/ImageDetail" + }, + { + "type": "null" + } + ] + }, + "image_url": { + "type": "string" + }, + "type": { + "enum": [ + "input_image" + ], + "title": "InputImageContentItemType", + "type": "string" + } + }, + "required": [ + "image_url", + "type" + ], + "title": "InputImageContentItem", + "type": "object" + }, + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "output_text" + ], + "title": "OutputTextContentItemType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "OutputTextContentItem", + "type": "object" + } + ] + }, + "ContextCompactedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Deprecated: Use `ContextCompaction` item type instead.", + "properties": { + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "threadId", + "turnId" + ], + "title": "ContextCompactedNotification", + "type": "object" + }, + "CreditsSnapshot": { + "properties": { + "balance": { + "type": [ + "string", + "null" + ] + }, + "hasCredits": { + "type": "boolean" + }, + "unlimited": { + "type": "boolean" + } + }, + "required": [ + "hasCredits", + "unlimited" + ], + "type": "object" + }, + "DeprecationNoticeNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "details": { + "description": "Optional extra guidance, such as migration steps or rationale.", + "type": [ + "string", + "null" + ] + }, + "summary": { + "description": "Concise summary of what is deprecated.", + "type": "string" + } + }, + "required": [ + "summary" + ], + "title": "DeprecationNoticeNotification", + "type": "object" + }, + "DeviceKeyAlgorithm": { + "description": "Device-key algorithm reported at enrollment and signing boundaries.", + "enum": [ + "ecdsa_p256_sha256" + ], + "type": "string" + }, + "DeviceKeyCreateParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Create a controller-local device key with a random key id.", + "properties": { + "accountUserId": { + "type": "string" + }, + "clientId": { + "type": "string" + }, + "protectionPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/DeviceKeyProtectionPolicy" + }, + { + "type": "null" + } + ], + "description": "Defaults to `hardware_only` when omitted." + } + }, + "required": [ + "accountUserId", + "clientId" + ], + "title": "DeviceKeyCreateParams", + "type": "object" + }, + "DeviceKeyCreateResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Device-key metadata and public key returned by create/public APIs.", + "properties": { + "algorithm": { + "$ref": "#/definitions/DeviceKeyAlgorithm" + }, + "keyId": { + "type": "string" + }, + "protectionClass": { + "$ref": "#/definitions/DeviceKeyProtectionClass" + }, + "publicKeySpkiDerBase64": { + "description": "SubjectPublicKeyInfo DER encoded as base64.", + "type": "string" + } + }, + "required": [ + "algorithm", + "keyId", + "protectionClass", + "publicKeySpkiDerBase64" + ], + "title": "DeviceKeyCreateResponse", + "type": "object" + }, + "DeviceKeyProtectionClass": { + "description": "Platform protection class for a controller-local device key.", + "enum": [ + "hardware_secure_enclave", + "hardware_tpm", + "os_protected_nonextractable" + ], + "type": "string" + }, + "DeviceKeyProtectionPolicy": { + "description": "Protection policy for creating or loading a controller-local device key.", + "enum": [ + "hardware_only", + "allow_os_protected_nonextractable" + ], + "type": "string" + }, + "DeviceKeyPublicParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Fetch a controller-local device key public key by id.", + "properties": { + "keyId": { + "type": "string" + } + }, + "required": [ + "keyId" + ], + "title": "DeviceKeyPublicParams", + "type": "object" + }, + "DeviceKeyPublicResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Device-key public metadata returned by `device/key/public`.", + "properties": { + "algorithm": { + "$ref": "#/definitions/DeviceKeyAlgorithm" + }, + "keyId": { + "type": "string" + }, + "protectionClass": { + "$ref": "#/definitions/DeviceKeyProtectionClass" + }, + "publicKeySpkiDerBase64": { + "description": "SubjectPublicKeyInfo DER encoded as base64.", + "type": "string" + } + }, + "required": [ + "algorithm", + "keyId", + "protectionClass", + "publicKeySpkiDerBase64" + ], + "title": "DeviceKeyPublicResponse", + "type": "object" + }, + "DeviceKeySignParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Sign an accepted structured payload with a controller-local device key.", + "properties": { + "keyId": { + "type": "string" + }, + "payload": { + "$ref": "#/definitions/DeviceKeySignPayload" + } + }, + "required": [ + "keyId", + "payload" + ], + "title": "DeviceKeySignParams", + "type": "object" + }, + "DeviceKeySignPayload": { + "description": "Structured payloads accepted by `device/key/sign`.", + "oneOf": [ + { + "description": "Payload bound to one remote-control controller websocket `/client` connection challenge.", + "properties": { + "accountUserId": { + "type": "string" + }, + "audience": { + "$ref": "#/definitions/RemoteControlClientConnectionAudience" + }, + "clientId": { + "type": "string" + }, + "nonce": { + "type": "string" + }, + "scopes": { + "description": "Must contain exactly `remote_control_controller_websocket`.", + "items": { + "type": "string" + }, + "type": "array" + }, + "sessionId": { + "description": "Backend-issued websocket session id that this proof authorizes.", + "type": "string" + }, + "targetOrigin": { + "description": "Origin of the backend endpoint that issued the challenge and will verify this proof.", + "type": "string" + }, + "targetPath": { + "description": "Websocket route path that this proof authorizes.", + "type": "string" + }, + "tokenExpiresAt": { + "description": "Remote-control token expiration as Unix seconds.", + "format": "int64", + "type": "integer" + }, + "tokenSha256Base64url": { + "description": "SHA-256 of the controller-scoped remote-control token, encoded as unpadded base64url.", + "type": "string" + }, + "type": { + "enum": [ + "remoteControlClientConnection" + ], + "title": "RemoteControlClientConnectionDeviceKeySignPayloadType", + "type": "string" + } + }, + "required": [ + "accountUserId", + "audience", + "clientId", + "nonce", + "scopes", + "sessionId", + "targetOrigin", + "targetPath", + "tokenExpiresAt", + "tokenSha256Base64url", + "type" + ], + "title": "RemoteControlClientConnectionDeviceKeySignPayload", + "type": "object" + }, + { + "description": "Payload bound to a remote-control client `/client/enroll` ownership challenge.", + "properties": { + "accountUserId": { + "type": "string" + }, + "audience": { + "$ref": "#/definitions/RemoteControlClientEnrollmentAudience" + }, + "challengeExpiresAt": { + "description": "Enrollment challenge expiration as Unix seconds.", + "format": "int64", + "type": "integer" + }, + "challengeId": { + "description": "Backend-issued enrollment challenge id that this proof authorizes.", + "type": "string" + }, + "clientId": { + "type": "string" + }, + "deviceIdentitySha256Base64url": { + "description": "SHA-256 of the requested device identity operation, encoded as unpadded base64url.", + "type": "string" + }, + "nonce": { + "type": "string" + }, + "targetOrigin": { + "description": "Origin of the backend endpoint that issued the challenge and will verify this proof.", + "type": "string" + }, + "targetPath": { + "description": "HTTP route path that this proof authorizes.", + "type": "string" + }, + "type": { + "enum": [ + "remoteControlClientEnrollment" + ], + "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType", + "type": "string" + } + }, + "required": [ + "accountUserId", + "audience", + "challengeExpiresAt", + "challengeId", + "clientId", + "deviceIdentitySha256Base64url", + "nonce", + "targetOrigin", + "targetPath", + "type" + ], + "title": "RemoteControlClientEnrollmentDeviceKeySignPayload", + "type": "object" + } + ] + }, + "DeviceKeySignResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "ASN.1 DER signature returned by `device/key/sign`.", + "properties": { + "algorithm": { + "$ref": "#/definitions/DeviceKeyAlgorithm" + }, + "signatureDerBase64": { + "description": "ECDSA signature DER encoded as base64.", + "type": "string" + }, + "signedPayloadBase64": { + "description": "Exact bytes signed by the device key, encoded as base64. Verifiers must verify this byte string directly and must not reserialize `payload`.", + "type": "string" + } + }, + "required": [ + "algorithm", + "signatureDerBase64", + "signedPayloadBase64" + ], + "title": "DeviceKeySignResponse", + "type": "object" + }, + "DynamicToolCallOutputContentItem": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "inputText" + ], + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { + "properties": { + "imageUrl": { + "type": "string" + }, + "type": { + "enum": [ + "inputImage" + ], + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" + } + }, + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" + } + ] + }, + "DynamicToolCallStatus": { + "enum": [ + "inProgress", + "completed", + "failed" + ], + "type": "string" + }, + "DynamicToolSpec": { + "properties": { + "deferLoading": { + "type": "boolean" + }, + "description": { + "type": "string" + }, + "inputSchema": true, + "name": { + "type": "string" + }, + "namespace": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "description", + "inputSchema", + "name" + ], + "type": "object" + }, + "EpiphanyAcceptanceReceipt": { + "properties": { + "accepted_at": { + "type": "string" + }, + "accepted_evidence_id": { + "type": [ + "string", + "null" + ] + }, + "accepted_observation_id": { + "type": [ + "string", + "null" + ] + }, + "binding_id": { + "type": "string" + }, + "id": { + "type": "string" + }, + "job_id": { + "type": "string" + }, + "result_id": { + "type": "string" + }, + "role_id": { + "type": "string" + }, + "status": { + "type": "string" + }, + "summary": { + "type": [ + "string", + "null" + ] + }, + "surface": { + "type": "string" + } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" + }, + "EpiphanyBacklogItem": { + "properties": { + "acceptance_sketch": { + "items": { + "type": "string" + }, + "type": "array" + }, + "blockers": { + "items": { + "type": "string" + }, + "type": "array" + }, + "confidence": { + "type": "string" + }, + "dependencies": { + "items": { + "type": "string" + }, + "type": "array" + }, + "duplicate_of": { + "type": [ + "string", + "null" + ] + }, + "evidence_refs": { + "items": { + "type": "string" + }, + "type": "array" + }, + "horizon": { + "type": "string" + }, + "id": { + "type": "string" + }, + "kind": { + "type": "string" + }, + "lane_hints": { + "items": { + "type": "string" + }, + "type": "array" + }, + "priority": { + "$ref": "#/definitions/EpiphanyPlanningPriority" + }, + "product_area": { + "type": "string" + }, + "source_refs": { + "items": { + "$ref": "#/definitions/EpiphanyPlanningSourceRef" + }, + "type": "array" + }, + "status": { + "type": "string" + }, + "summary": { + "type": "string" + }, + "title": { + "type": "string" + }, + "updated_at": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" + }, + "EpiphanyChurnState": { + "properties": { + "diff_pressure": { + "type": "string" + }, + "graph_freshness": { + "type": [ + "string", + "null" + ] + }, + "understanding_status": { + "type": "string" + }, + "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "warning": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" + }, + "EpiphanyCodeRef": { + "properties": { + "end_line": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "note": { + "type": [ + "string", + "null" + ] + }, + "path": { + "type": "string" + }, + "start_line": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "symbol": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "path" + ], + "type": "object" + }, + "EpiphanyEvidenceRecord": { + "properties": { + "code_refs": { + "items": { + "$ref": "#/definitions/EpiphanyCodeRef" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "kind": { + "type": "string" + }, + "status": { + "type": "string" + }, + "summary": { + "type": "string" + } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" + }, + "EpiphanyGraph": { + "properties": { + "edges": { + "items": { + "$ref": "#/definitions/EpiphanyGraphEdge" + }, + "type": "array" + }, + "nodes": { + "items": { + "$ref": "#/definitions/EpiphanyGraphNode" + }, + "type": "array" + } + }, + "type": "object" + }, + "EpiphanyGraphCheckpoint": { + "properties": { + "checkpoint_id": { + "type": "string" + }, + "frontier_node_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "graph_revision": { + "format": "uint64", + "minimum": 0.0, + "type": "integer" + }, + "open_gap_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "open_question_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "summary": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" + }, + "EpiphanyGraphEdge": { + "properties": { + "code_refs": { + "items": { + "$ref": "#/definitions/EpiphanyCodeRef" + }, + "type": "array" + }, + "id": { + "type": [ + "string", + "null" + ] + }, + "kind": { + "type": "string" + }, + "label": { + "type": [ + "string", + "null" + ] + }, + "mechanism": { + "type": [ + "string", + "null" + ] + }, + "source_id": { + "type": "string" + }, + "target_id": { + "type": "string" + } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" + }, + "EpiphanyGraphFrontier": { + "properties": { + "active_edge_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "active_node_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "dirty_paths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "open_gap_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "open_question_ids": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "EpiphanyGraphLink": { + "properties": { + "architecture_node_id": { + "type": "string" + }, + "code_refs": { + "items": { + "$ref": "#/definitions/EpiphanyCodeRef" + }, + "type": "array" + }, + "dataflow_node_id": { + "type": "string" + }, + "relationship": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" + }, + "EpiphanyGraphNode": { + "properties": { + "code_refs": { + "items": { + "$ref": "#/definitions/EpiphanyCodeRef" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "mechanism": { + "type": [ + "string", + "null" + ] + }, + "metaphor": { + "type": [ + "string", + "null" + ] + }, + "purpose": { + "type": "string" + }, + "status": { + "type": [ + "string", + "null" + ] + }, + "title": { + "type": "string" + } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" + }, + "EpiphanyGraphs": { + "properties": { + "architecture": { + "$ref": "#/definitions/EpiphanyGraph" + }, + "dataflow": { + "$ref": "#/definitions/EpiphanyGraph" + }, + "links": { + "items": { + "$ref": "#/definitions/EpiphanyGraphLink" + }, + "type": "array" + } + }, + "type": "object" + }, + "EpiphanyInvariant": { + "properties": { + "description": { + "type": "string" + }, + "id": { + "type": "string" + }, + "rationale": { + "type": [ + "string", + "null" + ] + }, + "status": { + "type": "string" + } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" + }, + "EpiphanyInvestigationCheckpoint": { + "properties": { + "captured_at_turn_id": { + "type": [ + "string", + "null" + ] + }, + "checkpoint_id": { + "type": "string" + }, + "code_refs": { + "items": { + "$ref": "#/definitions/EpiphanyCodeRef" + }, + "type": "array" + }, + "disposition": { + "$ref": "#/definitions/EpiphanyInvestigationDisposition" + }, + "evidence_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "focus": { + "type": "string" + }, + "kind": { + "type": "string" + }, + "next_action": { + "type": [ + "string", + "null" + ] + }, + "open_questions": { + "items": { + "type": "string" + }, + "type": "array" + }, + "summary": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" + }, + "EpiphanyInvestigationDisposition": { + "enum": [ + "resume_ready", + "regather_required" + ], + "type": "string" + }, + "EpiphanyJobBinding": { + "properties": { + "authority_scope": { + "type": [ + "string", + "null" + ] + }, + "blocking_reason": { + "type": [ + "string", + "null" + ] + }, + "id": { + "type": "string" + }, + "kind": { + "$ref": "#/definitions/EpiphanyJobKind" + }, + "linked_graph_node_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "linked_subgoal_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "owner_role": { + "type": "string" + }, + "scope": { + "type": "string" + } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" + }, + "EpiphanyJobKind": { + "enum": [ + "indexing", + "remap", + "verification", + "specialist" + ], + "type": "string" + }, + "EpiphanyModeKind": { + "enum": [ + "plan", + "default" + ], + "type": "string" + }, + "EpiphanyModeState": { + "properties": { + "kind": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyModeKind" + }, + { + "type": "null" + } + ] + }, + "name": { + "type": "string" + } + }, + "required": [ + "name" + ], + "type": "object" + }, + "EpiphanyObjectiveDraft": { + "properties": { + "acceptance_criteria": { + "items": { + "type": "string" + }, + "type": "array" + }, + "dependencies": { + "items": { + "type": "string" + }, + "type": "array" + }, + "evidence_required": { + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "lane_plan": { + "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" + }, + "review_gates": { + "items": { + "type": "string" + }, + "type": "array" + }, + "risks": { + "items": { + "type": "string" + }, + "type": "array" + }, + "scope": { + "$ref": "#/definitions/EpiphanyObjectiveDraftScope" + }, + "source_item_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "status": { + "type": "string" + }, + "summary": { + "type": "string" + }, + "title": { + "type": "string" + } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" + }, + "EpiphanyObjectiveDraftLanePlan": { + "properties": { + "body": { + "type": [ + "string", + "null" + ] + }, + "eyes": { + "type": [ + "string", + "null" + ] + }, + "hands": { + "type": [ + "string", + "null" + ] + }, + "imagination": { + "type": [ + "string", + "null" + ] + }, + "life": { + "type": [ + "string", + "null" + ] + }, + "soul": { + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "EpiphanyObjectiveDraftScope": { + "properties": { + "excludes": { + "items": { + "type": "string" + }, + "type": "array" + }, + "includes": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "EpiphanyObservation": { + "properties": { + "code_refs": { + "items": { + "$ref": "#/definitions/EpiphanyCodeRef" + }, + "type": "array" + }, + "evidence_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "source_kind": { + "type": "string" + }, + "status": { + "type": "string" + }, + "summary": { + "type": "string" + } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" + }, + "EpiphanyPlanningCapture": { + "properties": { + "body": { + "type": [ + "string", + "null" + ] + }, + "confidence": { + "type": "string" + }, + "created_at": { + "type": [ + "string", + "null" + ] + }, + "id": { + "type": "string" + }, + "source": { + "$ref": "#/definitions/EpiphanyPlanningSourceRef" + }, + "speaker": { + "type": [ + "string", + "null" + ] + }, + "status": { + "type": "string" + }, + "tags": { + "items": { + "type": "string" + }, + "type": "array" + }, + "title": { + "type": "string" + }, + "updated_at": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" + }, + "EpiphanyPlanningPriority": { + "properties": { + "blocks": { + "items": { + "type": "string" + }, + "type": "array" + }, + "confidence": { + "type": [ + "string", + "null" + ] + }, + "effort": { + "type": [ + "string", + "null" + ] + }, + "impact": { + "type": [ + "string", + "null" + ] + }, + "rationale": { + "type": "string" + }, + "reason": { + "type": [ + "string", + "null" + ] + }, + "unblocks": { + "items": { + "type": "string" + }, + "type": "array" + }, + "urgency": { + "type": [ + "string", + "null" + ] + }, + "value": { + "type": "string" + } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" + }, + "EpiphanyPlanningSourceRef": { + "properties": { + "assignees": { + "items": { + "type": "string" + }, + "type": "array" + }, + "author": { + "type": [ + "string", + "null" + ] + }, + "closed_at": { + "type": [ + "string", + "null" + ] + }, + "created_at": { + "type": [ + "string", + "null" + ] + }, + "database_id": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "external_id": { + "type": [ + "string", + "null" + ] + }, + "imported_at": { + "type": [ + "string", + "null" + ] + }, + "is_pull_request": { + "type": [ + "boolean", + "null" + ] + }, + "issue_number": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "kind": { + "type": "string" + }, + "labels": { + "items": { + "type": "string" + }, + "type": "array" + }, + "milestone": { + "type": [ + "string", + "null" + ] + }, + "node_id": { + "type": [ + "string", + "null" + ] + }, + "provider": { + "type": [ + "string", + "null" + ] + }, + "repo": { + "type": [ + "string", + "null" + ] + }, + "state": { + "type": [ + "string", + "null" + ] + }, + "updated_at": { + "type": [ + "string", + "null" + ] + }, + "uri": { + "type": [ + "string", + "null" + ] + }, + "url": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind" + ], + "type": "object" + }, + "EpiphanyPlanningState": { + "properties": { + "backlog_items": { + "items": { + "$ref": "#/definitions/EpiphanyBacklogItem" + }, + "type": "array" + }, + "captures": { + "items": { + "$ref": "#/definitions/EpiphanyPlanningCapture" + }, + "type": "array" + }, + "objective_drafts": { + "items": { + "$ref": "#/definitions/EpiphanyObjectiveDraft" + }, + "type": "array" + }, + "roadmap_streams": { + "items": { + "$ref": "#/definitions/EpiphanyRoadmapStream" + }, + "type": "array" + }, + "workspace_root": { + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "EpiphanyRetrievalShardSummary": { + "properties": { + "exact_available": { + "type": "boolean" + }, + "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "path_prefix": { + "type": "string" + }, + "semantic_available": { + "type": "boolean" + }, + "shard_id": { + "type": "string" + }, + "status": { + "allOf": [ + { + "$ref": "#/definitions/EpiphanyRetrievalStatus" + } + ], + "default": "unavailable" + } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" + }, + "EpiphanyRetrievalState": { + "properties": { + "dirty_paths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "index_revision": { + "type": [ + "string", + "null" + ] + }, + "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "last_indexed_at_unix_seconds": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "semantic_available": { + "type": "boolean" + }, + "shards": { + "items": { + "$ref": "#/definitions/EpiphanyRetrievalShardSummary" + }, + "type": "array" + }, + "status": { + "allOf": [ + { + "$ref": "#/definitions/EpiphanyRetrievalStatus" + } + ], + "default": "unavailable" + }, + "workspace_root": { + "type": "string" + } + }, + "required": [ + "workspace_root" + ], + "type": "object" + }, + "EpiphanyRetrievalStatus": { + "enum": [ + "unavailable", + "ready", + "stale", + "indexing" + ], + "type": "string" + }, + "EpiphanyRoadmapStream": { + "properties": { + "blocked_by": { + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "item_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "near_term_focus": { + "type": [ + "string", + "null" + ] + }, + "purpose": { + "type": "string" + }, + "review_cadence": { + "type": [ + "string", + "null" + ] + }, + "status": { + "type": "string" + }, + "title": { + "type": "string" + } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" + }, + "EpiphanyRuntimeLink": { + "properties": { + "authority_scope": { + "type": "string" + }, + "binding_id": { + "type": "string" + }, + "id": { + "type": "string" + }, + "linked_graph_node_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "linked_subgoal_ids": { + "items": { + "type": "string" + }, + "type": "array" + }, + "role_id": { + "type": "string" + }, + "runtime_job_id": { + "type": "string" + }, + "runtime_result_id": { + "type": [ + "string", + "null" + ] + }, + "surface": { + "type": "string" + } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" + }, + "EpiphanyScratchPad": { + "properties": { + "hypothesis": { + "type": [ + "string", + "null" + ] + }, + "next_probe": { + "type": [ + "string", + "null" + ] + }, + "notes": { + "items": { + "type": "string" + }, + "type": "array" + }, + "summary": { + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "EpiphanySubgoal": { + "properties": { + "id": { + "type": "string" + }, + "status": { + "type": "string" + }, + "summary": { + "type": [ + "string", + "null" + ] + }, + "title": { + "type": "string" + } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" + }, + "EpiphanyThreadState": { + "properties": { + "acceptance_receipts": { + "items": { + "$ref": "#/definitions/EpiphanyAcceptanceReceipt" + }, + "type": "array" + }, + "active_subgoal_id": { + "type": [ + "string", + "null" + ] + }, + "churn": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyChurnState" + }, + { + "type": "null" + } + ] + }, + "graph_checkpoint": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyGraphCheckpoint" + }, + { + "type": "null" + } + ] + }, + "graph_frontier": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyGraphFrontier" + }, + { + "type": "null" + } + ] + }, + "graphs": { + "$ref": "#/definitions/EpiphanyGraphs" + }, + "invariants": { + "items": { + "$ref": "#/definitions/EpiphanyInvariant" + }, + "type": "array" + }, + "investigation_checkpoint": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyInvestigationCheckpoint" + }, + { + "type": "null" + } + ] + }, + "job_bindings": { + "items": { + "$ref": "#/definitions/EpiphanyJobBinding" + }, + "type": "array" + }, + "last_updated_turn_id": { + "type": [ + "string", + "null" + ] + }, + "mode": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyModeState" + }, + { + "type": "null" + } + ] + }, + "objective": { + "type": [ + "string", + "null" + ] + }, + "observations": { + "items": { + "$ref": "#/definitions/EpiphanyObservation" + }, + "type": "array" + }, + "planning": { + "$ref": "#/definitions/EpiphanyPlanningState" + }, + "recent_evidence": { + "items": { + "$ref": "#/definitions/EpiphanyEvidenceRecord" + }, + "type": "array" + }, + "retrieval": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyRetrievalState" + }, + { + "type": "null" + } + ] + }, + "revision": { + "format": "uint64", + "minimum": 0.0, + "type": "integer" + }, + "runtime_links": { + "items": { + "$ref": "#/definitions/EpiphanyRuntimeLink" + }, + "type": "array" + }, + "scratch": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyScratchPad" + }, + { + "type": "null" + } + ] + }, + "subgoals": { + "items": { + "$ref": "#/definitions/EpiphanySubgoal" + }, + "type": "array" + } + }, + "required": [ + "revision" + ], + "type": "object" + }, + "ErrorNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "error": { + "$ref": "#/definitions/TurnError" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + }, + "willRetry": { + "type": "boolean" + } + }, + "required": [ + "error", + "threadId", + "turnId", + "willRetry" + ], + "title": "ErrorNotification", + "type": "object" + }, + "ExperimentalFeature": { + "properties": { + "announcement": { + "description": "Announcement copy shown to users when the feature is introduced. Null when this feature is not in beta.", + "type": [ + "string", + "null" + ] + }, + "defaultEnabled": { + "description": "Whether this feature is enabled by default.", + "type": "boolean" + }, + "description": { + "description": "Short summary describing what the feature does. Null when this feature is not in beta.", + "type": [ + "string", + "null" + ] + }, + "displayName": { + "description": "User-facing display name shown in the experimental features UI. Null when this feature is not in beta.", + "type": [ + "string", + "null" + ] + }, + "enabled": { + "description": "Whether this feature is currently enabled in the loaded config.", + "type": "boolean" + }, + "name": { + "description": "Stable key used in config.toml and CLI flag toggles.", + "type": "string" + }, + "stage": { + "allOf": [ + { + "$ref": "#/definitions/ExperimentalFeatureStage" + } + ], + "description": "Lifecycle stage of this feature flag." + } + }, + "required": [ + "defaultEnabled", + "enabled", + "name", + "stage" + ], + "type": "object" + }, + "ExperimentalFeatureEnablementSetParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "enablement": { + "additionalProperties": { + "type": "boolean" + }, + "description": "Process-wide runtime feature enablement keyed by canonical feature name.\n\nOnly named features are updated. Omitted features are left unchanged. Send an empty map for a no-op.", + "type": "object" + } + }, + "required": [ + "enablement" + ], + "title": "ExperimentalFeatureEnablementSetParams", + "type": "object" + }, + "ExperimentalFeatureEnablementSetResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "enablement": { + "additionalProperties": { + "type": "boolean" + }, + "description": "Feature enablement entries updated by this request.", + "type": "object" + } + }, + "required": [ + "enablement" + ], + "title": "ExperimentalFeatureEnablementSetResponse", + "type": "object" + }, + "ExperimentalFeatureListParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cursor": { + "description": "Opaque pagination cursor returned by a previous call.", + "type": [ + "string", + "null" + ] + }, + "limit": { + "description": "Optional page size; defaults to a reasonable server-side value.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "title": "ExperimentalFeatureListParams", + "type": "object" + }, + "ExperimentalFeatureListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "data": { + "items": { + "$ref": "#/definitions/ExperimentalFeature" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ExperimentalFeatureListResponse", + "type": "object" + }, + "ExperimentalFeatureStage": { + "oneOf": [ + { + "description": "Feature is available for user testing and feedback.", + "enum": [ + "beta" + ], + "type": "string" + }, + { + "description": "Feature is still being built and not ready for broad use.", + "enum": [ + "underDevelopment" + ], + "type": "string" + }, + { + "description": "Feature is production-ready.", + "enum": [ + "stable" + ], + "type": "string" + }, + { + "description": "Feature is deprecated and should be avoided.", + "enum": [ + "deprecated" + ], + "type": "string" + }, + { + "description": "Feature flag is retained only for backwards compatibility.", + "enum": [ + "removed" + ], + "type": "string" + } + ] + }, + "FeedbackUploadParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "classification": { + "type": "string" + }, + "extraLogFiles": { + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "includeLogs": { + "type": "boolean" + }, + "reason": { + "type": [ + "string", + "null" + ] + }, + "tags": { + "additionalProperties": { + "type": "string" + }, + "type": [ + "object", + "null" + ] + }, + "threadId": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "classification", + "includeLogs" + ], + "title": "FeedbackUploadParams", + "type": "object" + }, + "FeedbackUploadResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "FeedbackUploadResponse", + "type": "object" + }, + "FileChangeOutputDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "FileChangeOutputDeltaNotification", + "type": "object" + }, + "FileChangePatchUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "changes": { + "items": { + "$ref": "#/definitions/FileUpdateChange" + }, + "type": "array" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "changes", + "itemId", + "threadId", + "turnId" + ], + "title": "FileChangePatchUpdatedNotification", + "type": "object" + }, + "FileSystemAccessMode": { + "enum": [ + "read", + "write", + "none" + ], + "type": "string" + }, + "FileSystemPath": { + "oneOf": [ + { + "properties": { + "path": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": { + "enum": [ + "path" + ], + "title": "PathFileSystemPathType", + "type": "string" + } + }, + "required": [ + "path", + "type" + ], + "title": "PathFileSystemPath", + "type": "object" + }, + { + "properties": { + "pattern": { + "type": "string" + }, + "type": { + "enum": [ + "glob_pattern" + ], + "title": "GlobPatternFileSystemPathType", + "type": "string" + } + }, + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "special" + ], + "title": "SpecialFileSystemPathType", + "type": "string" + }, + "value": { + "$ref": "#/definitions/FileSystemSpecialPath" + } + }, + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" + } + ] + }, + "FileSystemSandboxEntry": { + "properties": { + "access": { + "$ref": "#/definitions/FileSystemAccessMode" + }, + "path": { + "$ref": "#/definitions/FileSystemPath" + } + }, + "required": [ + "access", + "path" + ], + "type": "object" + }, + "FileSystemSpecialPath": { + "oneOf": [ + { + "properties": { + "kind": { + "enum": [ + "root" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "minimal" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "current_working_directory" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "project_roots" + ], + "type": "string" + }, + "subpath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind" + ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "tmpdir" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "unknown" + ], + "type": "string" + }, + "path": { + "type": "string" + }, + "subpath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind", + "path" + ], + "type": "object" + } + ] + }, + "FileUpdateChange": { + "properties": { + "diff": { + "type": "string" + }, + "kind": { + "$ref": "#/definitions/PatchChangeKind" + }, + "path": { + "type": "string" + } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" + }, "ForcedLoginMethod": { - "type": "string", "enum": [ "chatgpt", "api" + ], + "type": "string" + }, + "FsChangedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Filesystem watch notification emitted for `fs/watch` subscribers.", + "properties": { + "changedPaths": { + "description": "File or directory paths associated with this event.", + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": "array" + }, + "watchId": { + "description": "Watch identifier previously provided to `fs/watch`.", + "type": "string" + } + }, + "required": [ + "changedPaths", + "watchId" + ], + "title": "FsChangedNotification", + "type": "object" + }, + "FsCopyParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Copy a file or directory tree on the host filesystem.", + "properties": { + "destinationPath": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Absolute destination path." + }, + "recursive": { + "description": "Required for directory copies; ignored for file copies.", + "type": "boolean" + }, + "sourcePath": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Absolute source path." + } + }, + "required": [ + "destinationPath", + "sourcePath" + ], + "title": "FsCopyParams", + "type": "object" + }, + "FsCopyResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Successful response for `fs/copy`.", + "title": "FsCopyResponse", + "type": "object" + }, + "FsCreateDirectoryParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Create a directory on the host filesystem.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Absolute directory path to create." + }, + "recursive": { + "description": "Whether parent directories should also be created. Defaults to `true`.", + "type": [ + "boolean", + "null" + ] + } + }, + "required": [ + "path" + ], + "title": "FsCreateDirectoryParams", + "type": "object" + }, + "FsCreateDirectoryResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Successful response for `fs/createDirectory`.", + "title": "FsCreateDirectoryResponse", + "type": "object" + }, + "FsGetMetadataParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Request metadata for an absolute path.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Absolute path to inspect." + } + }, + "required": [ + "path" + ], + "title": "FsGetMetadataParams", + "type": "object" + }, + "FsGetMetadataResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Metadata returned by `fs/getMetadata`.", + "properties": { + "createdAtMs": { + "description": "File creation time in Unix milliseconds when available, otherwise `0`.", + "format": "int64", + "type": "integer" + }, + "isDirectory": { + "description": "Whether the path resolves to a directory.", + "type": "boolean" + }, + "isFile": { + "description": "Whether the path resolves to a regular file.", + "type": "boolean" + }, + "isSymlink": { + "description": "Whether the path itself is a symbolic link.", + "type": "boolean" + }, + "modifiedAtMs": { + "description": "File modification time in Unix milliseconds when available, otherwise `0`.", + "format": "int64", + "type": "integer" + } + }, + "required": [ + "createdAtMs", + "isDirectory", + "isFile", + "isSymlink", + "modifiedAtMs" + ], + "title": "FsGetMetadataResponse", + "type": "object" + }, + "FsReadDirectoryEntry": { + "description": "A directory entry returned by `fs/readDirectory`.", + "properties": { + "fileName": { + "description": "Direct child entry name only, not an absolute or relative path.", + "type": "string" + }, + "isDirectory": { + "description": "Whether this entry resolves to a directory.", + "type": "boolean" + }, + "isFile": { + "description": "Whether this entry resolves to a regular file.", + "type": "boolean" + } + }, + "required": [ + "fileName", + "isDirectory", + "isFile" + ], + "type": "object" + }, + "FsReadDirectoryParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "List direct child names for a directory.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Absolute directory path to read." + } + }, + "required": [ + "path" + ], + "title": "FsReadDirectoryParams", + "type": "object" + }, + "FsReadDirectoryResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Directory entries returned by `fs/readDirectory`.", + "properties": { + "entries": { + "description": "Direct child entries in the requested directory.", + "items": { + "$ref": "#/definitions/FsReadDirectoryEntry" + }, + "type": "array" + } + }, + "required": [ + "entries" + ], + "title": "FsReadDirectoryResponse", + "type": "object" + }, + "FsReadFileParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Read a file from the host filesystem.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Absolute path to read." + } + }, + "required": [ + "path" + ], + "title": "FsReadFileParams", + "type": "object" + }, + "FsReadFileResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Base64-encoded file contents returned by `fs/readFile`.", + "properties": { + "dataBase64": { + "description": "File contents encoded as base64.", + "type": "string" + } + }, + "required": [ + "dataBase64" + ], + "title": "FsReadFileResponse", + "type": "object" + }, + "FsRemoveParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Remove a file or directory tree from the host filesystem.", + "properties": { + "force": { + "description": "Whether missing paths should be ignored. Defaults to `true`.", + "type": [ + "boolean", + "null" + ] + }, + "path": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Absolute path to remove." + }, + "recursive": { + "description": "Whether directory removal should recurse. Defaults to `true`.", + "type": [ + "boolean", + "null" + ] + } + }, + "required": [ + "path" + ], + "title": "FsRemoveParams", + "type": "object" + }, + "FsRemoveResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Successful response for `fs/remove`.", + "title": "FsRemoveResponse", + "type": "object" + }, + "FsUnwatchParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Stop filesystem watch notifications for a prior `fs/watch`.", + "properties": { + "watchId": { + "description": "Watch identifier previously provided to `fs/watch`.", + "type": "string" + } + }, + "required": [ + "watchId" + ], + "title": "FsUnwatchParams", + "type": "object" + }, + "FsUnwatchResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Successful response for `fs/unwatch`.", + "title": "FsUnwatchResponse", + "type": "object" + }, + "FsWatchParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Start filesystem watch notifications for an absolute path.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Absolute file or directory path to watch." + }, + "watchId": { + "description": "Connection-scoped watch identifier used for `fs/unwatch` and `fs/changed`.", + "type": "string" + } + }, + "required": [ + "path", + "watchId" + ], + "title": "FsWatchParams", + "type": "object" + }, + "FsWatchResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Successful response for `fs/watch`.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Canonicalized path associated with the watch." + } + }, + "required": [ + "path" + ], + "title": "FsWatchResponse", + "type": "object" + }, + "FsWriteFileParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Write a file on the host filesystem.", + "properties": { + "dataBase64": { + "description": "File contents encoded as base64.", + "type": "string" + }, + "path": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Absolute path to write." + } + }, + "required": [ + "dataBase64", + "path" + ], + "title": "FsWriteFileParams", + "type": "object" + }, + "FsWriteFileResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Successful response for `fs/writeFile`.", + "title": "FsWriteFileResponse", + "type": "object" + }, + "FunctionCallOutputBody": { + "anyOf": [ + { + "type": "string" + }, + { + "items": { + "$ref": "#/definitions/FunctionCallOutputContentItem" + }, + "type": "array" + } ] }, + "FunctionCallOutputContentItem": { + "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.", + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "input_text" + ], + "title": "InputTextFunctionCallOutputContentItemType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "InputTextFunctionCallOutputContentItem", + "type": "object" + }, + { + "properties": { + "detail": { + "anyOf": [ + { + "$ref": "#/definitions/ImageDetail" + }, + { + "type": "null" + } + ] + }, + "image_url": { + "type": "string" + }, + "type": { + "enum": [ + "input_image" + ], + "title": "InputImageFunctionCallOutputContentItemType", + "type": "string" + } + }, + "required": [ + "image_url", + "type" + ], + "title": "InputImageFunctionCallOutputContentItem", + "type": "object" + } + ] + }, + "FuzzyFileSearchMatchType": { + "enum": [ + "file", + "directory" + ], + "type": "string" + }, + "FuzzyFileSearchParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cancellationToken": { + "type": [ + "string", + "null" + ] + }, + "query": { + "type": "string" + }, + "roots": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "query", + "roots" + ], + "title": "FuzzyFileSearchParams", + "type": "object" + }, + "FuzzyFileSearchResult": { + "description": "Superset of [`codex_file_search::FileMatch`]", + "properties": { + "file_name": { + "type": "string" + }, + "indices": { + "items": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "type": [ + "array", + "null" + ] + }, + "match_type": { + "$ref": "#/definitions/FuzzyFileSearchMatchType" + }, + "path": { + "type": "string" + }, + "root": { + "type": "string" + }, + "score": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "file_name", + "match_type", + "path", + "root", + "score" + ], + "type": "object" + }, + "FuzzyFileSearchSessionCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "sessionId": { + "type": "string" + } + }, + "required": [ + "sessionId" + ], + "title": "FuzzyFileSearchSessionCompletedNotification", + "type": "object" + }, + "FuzzyFileSearchSessionUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "files": { + "items": { + "$ref": "#/definitions/FuzzyFileSearchResult" + }, + "type": "array" + }, + "query": { + "type": "string" + }, + "sessionId": { + "type": "string" + } + }, + "required": [ + "files", + "query", + "sessionId" + ], + "title": "FuzzyFileSearchSessionUpdatedNotification", + "type": "object" + }, + "GetAccountParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "refreshToken": { + "default": false, + "description": "When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.", + "type": "boolean" + } + }, + "title": "GetAccountParams", + "type": "object" + }, + "GetAccountRateLimitsResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "rateLimits": { + "allOf": [ + { + "$ref": "#/definitions/RateLimitSnapshot" + } + ], + "description": "Backward-compatible single-bucket view; mirrors the historical payload." + }, + "rateLimitsByLimitId": { + "additionalProperties": { + "$ref": "#/definitions/RateLimitSnapshot" + }, + "description": "Multi-bucket view keyed by metered `limit_id` (for example, `codex`).", + "type": [ + "object", + "null" + ] + } + }, + "required": [ + "rateLimits" + ], + "title": "GetAccountRateLimitsResponse", + "type": "object" + }, + "GetAccountResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "account": { + "anyOf": [ + { + "$ref": "#/definitions/Account" + }, + { + "type": "null" + } + ] + }, + "requiresOpenaiAuth": { + "type": "boolean" + } + }, + "required": [ + "requiresOpenaiAuth" + ], + "title": "GetAccountResponse", + "type": "object" + }, + "GhostCommit": { + "description": "Details of a ghost commit created from a repository state.", + "properties": { + "id": { + "type": "string" + }, + "parent": { + "type": [ + "string", + "null" + ] + }, + "preexisting_untracked_dirs": { + "items": { + "type": "string" + }, + "type": "array" + }, + "preexisting_untracked_files": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "id", + "preexisting_untracked_dirs", + "preexisting_untracked_files" + ], + "type": "object" + }, + "GitInfo": { + "properties": { + "branch": { + "type": [ + "string", + "null" + ] + }, + "originUrl": { + "type": [ + "string", + "null" + ] + }, + "sha": { + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "GuardianApprovalReview": { + "description": "[UNSTABLE] Temporary approval auto-review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.", + "properties": { + "rationale": { + "type": [ + "string", + "null" + ] + }, + "riskLevel": { + "anyOf": [ + { + "$ref": "#/definitions/GuardianRiskLevel" + }, + { + "type": "null" + } + ] + }, + "status": { + "$ref": "#/definitions/GuardianApprovalReviewStatus" + }, + "userAuthorization": { + "anyOf": [ + { + "$ref": "#/definitions/GuardianUserAuthorization" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "status" + ], + "type": "object" + }, + "GuardianApprovalReviewAction": { + "oneOf": [ + { + "properties": { + "command": { + "type": "string" + }, + "cwd": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "source": { + "$ref": "#/definitions/GuardianCommandSource" + }, + "type": { + "enum": [ + "command" + ], + "title": "CommandGuardianApprovalReviewActionType", + "type": "string" + } + }, + "required": [ + "command", + "cwd", + "source", + "type" + ], + "title": "CommandGuardianApprovalReviewAction", + "type": "object" + }, + { + "properties": { + "argv": { + "items": { + "type": "string" + }, + "type": "array" + }, + "cwd": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "program": { + "type": "string" + }, + "source": { + "$ref": "#/definitions/GuardianCommandSource" + }, + "type": { + "enum": [ + "execve" + ], + "title": "ExecveGuardianApprovalReviewActionType", + "type": "string" + } + }, + "required": [ + "argv", + "cwd", + "program", + "source", + "type" + ], + "title": "ExecveGuardianApprovalReviewAction", + "type": "object" + }, + { + "properties": { + "cwd": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "files": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": "array" + }, + "type": { + "enum": [ + "applyPatch" + ], + "title": "ApplyPatchGuardianApprovalReviewActionType", + "type": "string" + } + }, + "required": [ + "cwd", + "files", + "type" + ], + "title": "ApplyPatchGuardianApprovalReviewAction", + "type": "object" + }, + { + "properties": { + "host": { + "type": "string" + }, + "port": { + "format": "uint16", + "minimum": 0.0, + "type": "integer" + }, + "protocol": { + "$ref": "#/definitions/NetworkApprovalProtocol" + }, + "target": { + "type": "string" + }, + "type": { + "enum": [ + "networkAccess" + ], + "title": "NetworkAccessGuardianApprovalReviewActionType", + "type": "string" + } + }, + "required": [ + "host", + "port", + "protocol", + "target", + "type" + ], + "title": "NetworkAccessGuardianApprovalReviewAction", + "type": "object" + }, + { + "properties": { + "connectorId": { + "type": [ + "string", + "null" + ] + }, + "connectorName": { + "type": [ + "string", + "null" + ] + }, + "server": { + "type": "string" + }, + "toolName": { + "type": "string" + }, + "toolTitle": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "mcpToolCall" + ], + "title": "McpToolCallGuardianApprovalReviewActionType", + "type": "string" + } + }, + "required": [ + "server", + "toolName", + "type" + ], + "title": "McpToolCallGuardianApprovalReviewAction", + "type": "object" + }, + { + "properties": { + "permissions": { + "$ref": "#/definitions/RequestPermissionProfile" + }, + "reason": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "requestPermissions" + ], + "title": "RequestPermissionsGuardianApprovalReviewActionType", + "type": "string" + } + }, + "required": [ + "permissions", + "type" + ], + "title": "RequestPermissionsGuardianApprovalReviewAction", + "type": "object" + } + ] + }, + "GuardianApprovalReviewStatus": { + "description": "[UNSTABLE] Lifecycle state for an approval auto-review.", + "enum": [ + "inProgress", + "approved", + "denied", + "timedOut", + "aborted" + ], + "type": "string" + }, + "GuardianCommandSource": { + "enum": [ + "shell", + "unifiedExec" + ], + "type": "string" + }, + "GuardianRiskLevel": { + "description": "[UNSTABLE] Risk level assigned by approval auto-review.", + "enum": [ + "low", + "medium", + "high", + "critical" + ], + "type": "string" + }, + "GuardianUserAuthorization": { + "description": "[UNSTABLE] Authorization level assigned by approval auto-review.", + "enum": [ + "unknown", + "low", + "medium", + "high" + ], + "type": "string" + }, + "GuardianWarningNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "message": { + "description": "Concise guardian warning message for the user.", + "type": "string" + }, + "threadId": { + "description": "Thread target for the guardian warning.", + "type": "string" + } + }, + "required": [ + "message", + "threadId" + ], + "title": "GuardianWarningNotification", + "type": "object" + }, + "HookCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "run": { + "$ref": "#/definitions/HookRunSummary" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "run", + "threadId" + ], + "title": "HookCompletedNotification", + "type": "object" + }, + "HookEventName": { + "enum": [ + "preToolUse", + "permissionRequest", + "postToolUse", + "sessionStart", + "userPromptSubmit", + "stop" + ], + "type": "string" + }, + "HookExecutionMode": { + "enum": [ + "sync", + "async" + ], + "type": "string" + }, + "HookHandlerType": { + "enum": [ + "command", + "prompt", + "agent" + ], + "type": "string" + }, + "HookOutputEntry": { + "properties": { + "kind": { + "$ref": "#/definitions/HookOutputEntryKind" + }, + "text": { + "type": "string" + } + }, + "required": [ + "kind", + "text" + ], + "type": "object" + }, + "HookOutputEntryKind": { + "enum": [ + "warning", + "stop", + "feedback", + "context", + "error" + ], + "type": "string" + }, + "HookPromptFragment": { + "properties": { + "hookRunId": { + "type": "string" + }, + "text": { + "type": "string" + } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" + }, + "HookRunStatus": { + "enum": [ + "running", + "completed", + "failed", + "blocked", + "stopped" + ], + "type": "string" + }, + "HookRunSummary": { + "properties": { + "completedAt": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "displayOrder": { + "format": "int64", + "type": "integer" + }, + "durationMs": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "entries": { + "items": { + "$ref": "#/definitions/HookOutputEntry" + }, + "type": "array" + }, + "eventName": { + "$ref": "#/definitions/HookEventName" + }, + "executionMode": { + "$ref": "#/definitions/HookExecutionMode" + }, + "handlerType": { + "$ref": "#/definitions/HookHandlerType" + }, + "id": { + "type": "string" + }, + "scope": { + "$ref": "#/definitions/HookScope" + }, + "source": { + "allOf": [ + { + "$ref": "#/definitions/HookSource" + } + ], + "default": "unknown" + }, + "sourcePath": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "startedAt": { + "format": "int64", + "type": "integer" + }, + "status": { + "$ref": "#/definitions/HookRunStatus" + }, + "statusMessage": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "displayOrder", + "entries", + "eventName", + "executionMode", + "handlerType", + "id", + "scope", + "sourcePath", + "startedAt", + "status" + ], + "type": "object" + }, + "HookScope": { + "enum": [ + "thread", + "turn" + ], + "type": "string" + }, + "HookSource": { + "enum": [ + "system", + "user", + "project", + "mdm", + "sessionFlags", + "legacyManagedConfigFile", + "legacyManagedConfigMdm", + "unknown" + ], + "type": "string" + }, + "HookStartedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "run": { + "$ref": "#/definitions/HookRunSummary" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "run", + "threadId" + ], + "title": "HookStartedNotification", + "type": "object" + }, + "ImageDetail": { + "enum": [ + "auto", + "low", + "high", + "original" + ], + "type": "string" + }, + "InitializeCapabilities": { + "description": "Client-declared capabilities negotiated during initialize.", + "properties": { + "experimentalApi": { + "default": false, + "description": "Opt into receiving experimental API methods and fields.", + "type": "boolean" + }, + "optOutNotificationMethods": { + "description": "Exact notification method names that should be suppressed for this connection (for example `thread/started`).", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + } + }, + "type": "object" + }, + "InitializeParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "capabilities": { + "anyOf": [ + { + "$ref": "#/definitions/InitializeCapabilities" + }, + { + "type": "null" + } + ] + }, + "clientInfo": { + "$ref": "#/definitions/ClientInfo" + } + }, + "required": [ + "clientInfo" + ], + "title": "InitializeParams", + "type": "object" + }, + "InputModality": { + "description": "Canonical user-input modality tags advertised by a model.", + "oneOf": [ + { + "description": "Plain text turns and tool payloads.", + "enum": [ + "text" + ], + "type": "string" + }, + { + "description": "Image attachments included in user turns.", + "enum": [ + "image" + ], + "type": "string" + } + ] + }, + "ItemCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "item": { + "$ref": "#/definitions/ThreadItem" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "item", + "threadId", + "turnId" + ], + "title": "ItemCompletedNotification", + "type": "object" + }, + "ItemGuardianApprovalReviewCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", + "properties": { + "action": { + "$ref": "#/definitions/GuardianApprovalReviewAction" + }, + "decisionSource": { + "$ref": "#/definitions/AutoReviewDecisionSource" + }, + "review": { + "$ref": "#/definitions/GuardianApprovalReview" + }, + "reviewId": { + "description": "Stable identifier for this review.", + "type": "string" + }, + "targetItemId": { + "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", + "type": [ + "string", + "null" + ] + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "action", + "decisionSource", + "review", + "reviewId", + "threadId", + "turnId" + ], + "title": "ItemGuardianApprovalReviewCompletedNotification", + "type": "object" + }, + "ItemGuardianApprovalReviewStartedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", + "properties": { + "action": { + "$ref": "#/definitions/GuardianApprovalReviewAction" + }, + "review": { + "$ref": "#/definitions/GuardianApprovalReview" + }, + "reviewId": { + "description": "Stable identifier for this review.", + "type": "string" + }, + "targetItemId": { + "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", + "type": [ + "string", + "null" + ] + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "action", + "review", + "reviewId", + "threadId", + "turnId" + ], + "title": "ItemGuardianApprovalReviewStartedNotification", + "type": "object" + }, + "ItemStartedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "item": { + "$ref": "#/definitions/ThreadItem" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "item", + "threadId", + "turnId" + ], + "title": "ItemStartedNotification", + "type": "object" + }, + "ListMcpServerStatusParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cursor": { + "description": "Opaque pagination cursor returned by a previous call.", + "type": [ + "string", + "null" + ] + }, + "detail": { + "anyOf": [ + { + "$ref": "#/definitions/McpServerStatusDetail" + }, + { + "type": "null" + } + ], + "description": "Controls how much MCP inventory data to fetch for each server. Defaults to `Full` when omitted." + }, + "limit": { + "description": "Optional page size; defaults to a server-defined value.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "title": "ListMcpServerStatusParams", + "type": "object" + }, + "ListMcpServerStatusResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "data": { + "items": { + "$ref": "#/definitions/McpServerStatus" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ListMcpServerStatusResponse", + "type": "object" + }, + "LocalShellAction": { + "oneOf": [ + { + "properties": { + "command": { + "items": { + "type": "string" + }, + "type": "array" + }, + "env": { + "additionalProperties": { + "type": "string" + }, + "type": [ + "object", + "null" + ] + }, + "timeout_ms": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "type": { + "enum": [ + "exec" + ], + "title": "ExecLocalShellActionType", + "type": "string" + }, + "user": { + "type": [ + "string", + "null" + ] + }, + "working_directory": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "command", + "type" + ], + "title": "ExecLocalShellAction", + "type": "object" + } + ] + }, + "LocalShellStatus": { + "enum": [ + "completed", + "in_progress", + "incomplete" + ], + "type": "string" + }, + "LoginAccountParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "oneOf": [ + { + "properties": { + "apiKey": { + "type": "string" + }, + "type": { + "enum": [ + "apiKey" + ], + "title": "ApiKeyv2::LoginAccountParamsType", + "type": "string" + } + }, + "required": [ + "apiKey", + "type" + ], + "title": "ApiKeyv2::LoginAccountParams", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "chatgpt" + ], + "title": "Chatgptv2::LoginAccountParamsType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "Chatgptv2::LoginAccountParams", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "chatgptDeviceCode" + ], + "title": "ChatgptDeviceCodev2::LoginAccountParamsType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ChatgptDeviceCodev2::LoginAccountParams", + "type": "object" + }, + { + "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE. The access token must contain the same scopes that Codex-managed ChatGPT auth tokens have.", + "properties": { + "accessToken": { + "description": "Access token (JWT) supplied by the client. This token is used for backend API requests and email extraction.", + "type": "string" + }, + "chatgptAccountId": { + "description": "Workspace/account identifier supplied by the client.", + "type": "string" + }, + "chatgptPlanType": { + "description": "Optional plan type supplied by the client.\n\nWhen `null`, Codex attempts to derive the plan type from access-token claims. If unavailable, the plan defaults to `unknown`.", + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "chatgptAuthTokens" + ], + "title": "ChatgptAuthTokensv2::LoginAccountParamsType", + "type": "string" + } + }, + "required": [ + "accessToken", + "chatgptAccountId", + "type" + ], + "title": "ChatgptAuthTokensv2::LoginAccountParams", + "type": "object" + } + ], + "title": "LoginAccountParams" + }, + "LoginAccountResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "apiKey" + ], + "title": "ApiKeyv2::LoginAccountResponseType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ApiKeyv2::LoginAccountResponse", + "type": "object" + }, + { + "properties": { + "authUrl": { + "description": "URL the client should open in a browser to initiate the OAuth flow.", + "type": "string" + }, + "loginId": { + "type": "string" + }, + "type": { + "enum": [ + "chatgpt" + ], + "title": "Chatgptv2::LoginAccountResponseType", + "type": "string" + } + }, + "required": [ + "authUrl", + "loginId", + "type" + ], + "title": "Chatgptv2::LoginAccountResponse", + "type": "object" + }, + { + "properties": { + "loginId": { + "type": "string" + }, + "type": { + "enum": [ + "chatgptDeviceCode" + ], + "title": "ChatgptDeviceCodev2::LoginAccountResponseType", + "type": "string" + }, + "userCode": { + "description": "One-time code the user must enter after signing in.", + "type": "string" + }, + "verificationUrl": { + "description": "URL the client should open in a browser to complete device code authorization.", + "type": "string" + } + }, + "required": [ + "loginId", + "type", + "userCode", + "verificationUrl" + ], + "title": "ChatgptDeviceCodev2::LoginAccountResponse", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "chatgptAuthTokens" + ], + "title": "ChatgptAuthTokensv2::LoginAccountResponseType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ChatgptAuthTokensv2::LoginAccountResponse", + "type": "object" + } + ], + "title": "LoginAccountResponse" + }, + "LogoutAccountResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "LogoutAccountResponse", + "type": "object" + }, + "McpAuthStatus": { + "enum": [ + "unsupported", + "notLoggedIn", + "bearerToken", + "oAuth" + ], + "type": "string" + }, + "McpResourceReadParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "server": { + "type": "string" + }, + "threadId": { + "type": [ + "string", + "null" + ] + }, + "uri": { + "type": "string" + } + }, + "required": [ + "server", + "uri" + ], + "title": "McpResourceReadParams", + "type": "object" + }, + "McpResourceReadResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "contents": { + "items": { + "$ref": "#/definitions/ResourceContent" + }, + "type": "array" + } + }, + "required": [ + "contents" + ], + "title": "McpResourceReadResponse", + "type": "object" + }, + "McpServerOauthLoginCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "error": { + "type": [ + "string", + "null" + ] + }, + "name": { + "type": "string" + }, + "success": { + "type": "boolean" + } + }, + "required": [ + "name", + "success" + ], + "title": "McpServerOauthLoginCompletedNotification", + "type": "object" + }, + "McpServerOauthLoginParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "name": { + "type": "string" + }, + "scopes": { + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "timeoutSecs": { + "format": "int64", + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "name" + ], + "title": "McpServerOauthLoginParams", + "type": "object" + }, + "McpServerOauthLoginResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "authorizationUrl": { + "type": "string" + } + }, + "required": [ + "authorizationUrl" + ], + "title": "McpServerOauthLoginResponse", + "type": "object" + }, + "McpServerRefreshResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "McpServerRefreshResponse", + "type": "object" + }, + "McpServerStartupState": { + "enum": [ + "starting", + "ready", + "failed", + "cancelled" + ], + "type": "string" + }, + "McpServerStatus": { + "properties": { + "authStatus": { + "$ref": "#/definitions/McpAuthStatus" + }, + "name": { + "type": "string" + }, + "resourceTemplates": { + "items": { + "$ref": "#/definitions/ResourceTemplate" + }, + "type": "array" + }, + "resources": { + "items": { + "$ref": "#/definitions/Resource" + }, + "type": "array" + }, + "tools": { + "additionalProperties": { + "$ref": "#/definitions/Tool" + }, + "type": "object" + } + }, + "required": [ + "authStatus", + "name", + "resourceTemplates", + "resources", + "tools" + ], + "type": "object" + }, + "McpServerStatusDetail": { + "enum": [ + "full", + "toolsAndAuthOnly" + ], + "type": "string" + }, + "McpServerStatusUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "error": { + "type": [ + "string", + "null" + ] + }, + "name": { + "type": "string" + }, + "status": { + "$ref": "#/definitions/McpServerStartupState" + } + }, + "required": [ + "name", + "status" + ], + "title": "McpServerStatusUpdatedNotification", + "type": "object" + }, + "McpServerToolCallParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "_meta": true, + "arguments": true, + "server": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "tool": { + "type": "string" + } + }, + "required": [ + "server", + "threadId", + "tool" + ], + "title": "McpServerToolCallParams", + "type": "object" + }, + "McpServerToolCallResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "_meta": true, + "content": { + "items": true, + "type": "array" + }, + "isError": { + "type": [ + "boolean", + "null" + ] + }, + "structuredContent": true + }, + "required": [ + "content" + ], + "title": "McpServerToolCallResponse", + "type": "object" + }, + "McpToolCallError": { + "properties": { + "message": { + "type": "string" + } + }, + "required": [ + "message" + ], + "type": "object" + }, + "McpToolCallProgressNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "itemId": { + "type": "string" + }, + "message": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "itemId", + "message", + "threadId", + "turnId" + ], + "title": "McpToolCallProgressNotification", + "type": "object" + }, + "McpToolCallResult": { + "properties": { + "_meta": true, + "content": { + "items": true, + "type": "array" + }, + "structuredContent": true + }, + "required": [ + "content" + ], + "type": "object" + }, + "McpToolCallStatus": { + "enum": [ + "inProgress", + "completed", + "failed" + ], + "type": "string" + }, + "MemoryCitation": { + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "entries", + "threadIds" + ], + "type": "object" + }, + "MemoryCitationEntry": { + "properties": { + "lineEnd": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "lineStart": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "note": { + "type": "string" + }, + "path": { + "type": "string" + } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" + }, + "MergeStrategy": { + "enum": [ + "replace", + "upsert" + ], + "type": "string" + }, + "MessagePhase": { + "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", + "oneOf": [ + { + "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", + "enum": [ + "commentary" + ], + "type": "string" + }, + { + "description": "The assistant's terminal answer text for the current turn.", + "enum": [ + "final_answer" + ], + "type": "string" + } + ] + }, + "ModeKind": { + "description": "Initial collaboration mode to use when the TUI starts.", + "enum": [ + "plan", + "default" + ], + "type": "string" + }, + "Model": { + "properties": { + "additionalSpeedTiers": { + "default": [], + "items": { + "type": "string" + }, + "type": "array" + }, + "availabilityNux": { + "anyOf": [ + { + "$ref": "#/definitions/ModelAvailabilityNux" + }, + { + "type": "null" + } + ] + }, + "defaultReasoningEffort": { + "$ref": "#/definitions/ReasoningEffort" + }, + "description": { + "type": "string" + }, + "displayName": { + "type": "string" + }, + "hidden": { + "type": "boolean" + }, + "id": { + "type": "string" + }, + "inputModalities": { + "default": [ + "text", + "image" + ], + "items": { + "$ref": "#/definitions/InputModality" + }, + "type": "array" + }, + "isDefault": { + "type": "boolean" + }, + "model": { + "type": "string" + }, + "supportedReasoningEfforts": { + "items": { + "$ref": "#/definitions/ReasoningEffortOption" + }, + "type": "array" + }, + "supportsPersonality": { + "default": false, + "type": "boolean" + }, + "upgrade": { + "type": [ + "string", + "null" + ] + }, + "upgradeInfo": { + "anyOf": [ + { + "$ref": "#/definitions/ModelUpgradeInfo" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "defaultReasoningEffort", + "description", + "displayName", + "hidden", + "id", + "isDefault", + "model", + "supportedReasoningEfforts" + ], + "type": "object" + }, + "ModelAvailabilityNux": { + "properties": { + "message": { + "type": "string" + } + }, + "required": [ + "message" + ], + "type": "object" + }, + "ModelListParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cursor": { + "description": "Opaque pagination cursor returned by a previous call.", + "type": [ + "string", + "null" + ] + }, + "includeHidden": { + "description": "When true, include models that are hidden from the default picker list.", + "type": [ + "boolean", + "null" + ] + }, + "limit": { + "description": "Optional page size; defaults to a reasonable server-side value.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "title": "ModelListParams", + "type": "object" + }, + "ModelListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "data": { + "items": { + "$ref": "#/definitions/Model" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ModelListResponse", + "type": "object" + }, + "ModelRerouteReason": { + "enum": [ + "highRiskCyberActivity" + ], + "type": "string" + }, + "ModelReroutedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "fromModel": { + "type": "string" + }, + "reason": { + "$ref": "#/definitions/ModelRerouteReason" + }, + "threadId": { + "type": "string" + }, + "toModel": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "fromModel", + "reason", + "threadId", + "toModel", + "turnId" + ], + "title": "ModelReroutedNotification", + "type": "object" + }, + "ModelUpgradeInfo": { + "properties": { + "migrationMarkdown": { + "type": [ + "string", + "null" + ] + }, + "model": { + "type": "string" + }, + "modelLink": { + "type": [ + "string", + "null" + ] + }, + "upgradeCopy": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "model" + ], + "type": "object" + }, + "NetworkAccess": { + "enum": [ + "restricted", + "enabled" + ], + "type": "string" + }, + "NetworkApprovalProtocol": { + "enum": [ + "http", + "https", + "socks5Tcp", + "socks5Udp" + ], + "type": "string" + }, + "NetworkDomainPermission": { + "enum": [ + "allow", + "deny" + ], + "type": "string" + }, + "NetworkRequirements": { + "properties": { + "allowLocalBinding": { + "type": [ + "boolean", + "null" + ] + }, + "allowUnixSockets": { + "description": "Legacy compatibility view derived from `unix_sockets`.", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "allowUpstreamProxy": { + "type": [ + "boolean", + "null" + ] + }, + "allowedDomains": { + "description": "Legacy compatibility view derived from `domains`.", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "dangerouslyAllowAllUnixSockets": { + "type": [ + "boolean", + "null" + ] + }, + "dangerouslyAllowNonLoopbackProxy": { + "type": [ + "boolean", + "null" + ] + }, + "deniedDomains": { + "description": "Legacy compatibility view derived from `domains`.", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "domains": { + "additionalProperties": { + "$ref": "#/definitions/NetworkDomainPermission" + }, + "description": "Canonical network permission map for `experimental_network`.", + "type": [ + "object", + "null" + ] + }, + "enabled": { + "type": [ + "boolean", + "null" + ] + }, + "httpPort": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "managedAllowedDomainsOnly": { + "description": "When true, only managed allowlist entries are respected while managed network enforcement is active.", + "type": [ + "boolean", + "null" + ] + }, + "socksPort": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "unixSockets": { + "additionalProperties": { + "$ref": "#/definitions/NetworkUnixSocketPermission" + }, + "description": "Canonical unix socket permission map for `experimental_network`.", + "type": [ + "object", + "null" + ] + } + }, + "type": "object" + }, + "NetworkUnixSocketPermission": { + "enum": [ + "allow", + "none" + ], + "type": "string" + }, + "NonSteerableTurnKind": { + "enum": [ + "review", + "compact" + ], + "type": "string" + }, + "OverriddenMetadata": { + "properties": { + "effectiveValue": true, + "message": { + "type": "string" + }, + "overridingLayer": { + "$ref": "#/definitions/ConfigLayerMetadata" + } + }, + "required": [ + "effectiveValue", + "message", + "overridingLayer" + ], + "type": "object" + }, + "PatchApplyStatus": { + "enum": [ + "inProgress", + "completed", + "failed", + "declined" + ], + "type": "string" + }, + "PatchChangeKind": { + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "add" + ], + "title": "AddPatchChangeKindType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "delete" + ], + "title": "DeletePatchChangeKindType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { + "properties": { + "move_path": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "update" + ], + "title": "UpdatePatchChangeKindType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" + } + ] + }, + "PermissionProfile": { + "properties": { + "fileSystem": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfileFileSystemPermissions" + }, + { + "type": "null" + } + ] + }, + "network": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfileNetworkPermissions" + }, + { + "type": "null" + } + ] + } + }, + "type": "object" + }, + "PermissionProfileFileSystemPermissions": { + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + }, + "type": "array" + }, + "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "entries" + ], + "type": "object" + }, + "PermissionProfileNetworkPermissions": { + "properties": { + "enabled": { + "type": [ + "boolean", + "null" + ] + } + }, + "type": "object" + }, + "Personality": { + "enum": [ + "none", + "friendly", + "pragmatic" + ], + "type": "string" + }, + "PlanDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items. Clients should not assume concatenated deltas match the completed plan item content.", + "properties": { + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "PlanDeltaNotification", + "type": "object" + }, + "PlanType": { + "enum": [ + "free", + "go", + "plus", + "pro", + "prolite", + "team", + "self_serve_business_usage_based", + "business", + "enterprise_cbp_usage_based", + "enterprise", + "edu", + "unknown" + ], + "type": "string" + }, "ProfileV2": { - "type": "object", + "additionalProperties": true, "properties": { "approval_policy": { "anyOf": [ @@ -13609,7 +8346,6 @@ ] }, "approvals_reviewer": { - "description": "[UNSTABLE] Optional profile-level override for where approval requests are routed for review. If omitted, the enclosing config default is used.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -13617,7 +8353,8 @@ { "type": "null" } - ] + ], + "description": "[UNSTABLE] Optional profile-level override for where approval requests are routed for review. If omitted, the enclosing config default is used." }, "chatgpt_base_url": { "type": [ @@ -13698,10 +8435,1487 @@ ] } }, - "additionalProperties": true + "type": "object" + }, + "RateLimitReachedType": { + "enum": [ + "rate_limit_reached", + "workspace_owner_credits_depleted", + "workspace_member_credits_depleted", + "workspace_owner_usage_limit_reached", + "workspace_member_usage_limit_reached" + ], + "type": "string" + }, + "RateLimitSnapshot": { + "properties": { + "credits": { + "anyOf": [ + { + "$ref": "#/definitions/CreditsSnapshot" + }, + { + "type": "null" + } + ] + }, + "limitId": { + "type": [ + "string", + "null" + ] + }, + "limitName": { + "type": [ + "string", + "null" + ] + }, + "planType": { + "anyOf": [ + { + "$ref": "#/definitions/PlanType" + }, + { + "type": "null" + } + ] + }, + "primary": { + "anyOf": [ + { + "$ref": "#/definitions/RateLimitWindow" + }, + { + "type": "null" + } + ] + }, + "rateLimitReachedType": { + "anyOf": [ + { + "$ref": "#/definitions/RateLimitReachedType" + }, + { + "type": "null" + } + ] + }, + "secondary": { + "anyOf": [ + { + "$ref": "#/definitions/RateLimitWindow" + }, + { + "type": "null" + } + ] + } + }, + "type": "object" + }, + "RateLimitWindow": { + "properties": { + "resetsAt": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "usedPercent": { + "format": "int32", + "type": "integer" + }, + "windowDurationMins": { + "format": "int64", + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "usedPercent" + ], + "type": "object" + }, + "RawResponseItemCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "item": { + "$ref": "#/definitions/ResponseItem" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "item", + "threadId", + "turnId" + ], + "title": "RawResponseItemCompletedNotification", + "type": "object" + }, + "ReadOnlyAccess": { + "oneOf": [ + { + "properties": { + "includePlatformDefaults": { + "default": true, + "type": "boolean" + }, + "readableRoots": { + "default": [], + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": "array" + }, + "type": { + "enum": [ + "restricted" + ], + "title": "RestrictedReadOnlyAccessType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "RestrictedReadOnlyAccess", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "fullAccess" + ], + "title": "FullAccessReadOnlyAccessType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "FullAccessReadOnlyAccess", + "type": "object" + } + ] + }, + "RealtimeConversationVersion": { + "enum": [ + "v1", + "v2" + ], + "type": "string" + }, + "RealtimeOutputModality": { + "enum": [ + "text", + "audio" + ], + "type": "string" + }, + "RealtimeVoice": { + "enum": [ + "alloy", + "arbor", + "ash", + "ballad", + "breeze", + "cedar", + "coral", + "cove", + "echo", + "ember", + "juniper", + "maple", + "marin", + "sage", + "shimmer", + "sol", + "spruce", + "vale", + "verse" + ], + "type": "string" + }, + "RealtimeVoicesList": { + "properties": { + "defaultV1": { + "$ref": "#/definitions/RealtimeVoice" + }, + "defaultV2": { + "$ref": "#/definitions/RealtimeVoice" + }, + "v1": { + "items": { + "$ref": "#/definitions/RealtimeVoice" + }, + "type": "array" + }, + "v2": { + "items": { + "$ref": "#/definitions/RealtimeVoice" + }, + "type": "array" + } + }, + "required": [ + "defaultV1", + "defaultV2", + "v1", + "v2" + ], + "type": "object" + }, + "ReasoningEffort": { + "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "enum": [ + "none", + "minimal", + "low", + "medium", + "high", + "xhigh" + ], + "type": "string" + }, + "ReasoningEffortOption": { + "properties": { + "description": { + "type": "string" + }, + "reasoningEffort": { + "$ref": "#/definitions/ReasoningEffort" + } + }, + "required": [ + "description", + "reasoningEffort" + ], + "type": "object" + }, + "ReasoningItemContent": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "reasoning_text" + ], + "title": "ReasoningTextReasoningItemContentType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "ReasoningTextReasoningItemContent", + "type": "object" + }, + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "text" + ], + "title": "TextReasoningItemContentType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "TextReasoningItemContent", + "type": "object" + } + ] + }, + "ReasoningItemReasoningSummary": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "summary_text" + ], + "title": "SummaryTextReasoningItemReasoningSummaryType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "SummaryTextReasoningItemReasoningSummary", + "type": "object" + } + ] + }, + "ReasoningSummary": { + "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries", + "oneOf": [ + { + "enum": [ + "auto", + "concise", + "detailed" + ], + "type": "string" + }, + { + "description": "Option to disable reasoning summaries.", + "enum": [ + "none" + ], + "type": "string" + } + ] + }, + "ReasoningSummaryPartAddedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "itemId": { + "type": "string" + }, + "summaryIndex": { + "format": "int64", + "type": "integer" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "itemId", + "summaryIndex", + "threadId", + "turnId" + ], + "title": "ReasoningSummaryPartAddedNotification", + "type": "object" + }, + "ReasoningSummaryTextDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "summaryIndex": { + "format": "int64", + "type": "integer" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "delta", + "itemId", + "summaryIndex", + "threadId", + "turnId" + ], + "title": "ReasoningSummaryTextDeltaNotification", + "type": "object" + }, + "ReasoningTextDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "contentIndex": { + "format": "int64", + "type": "integer" + }, + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "contentIndex", + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "ReasoningTextDeltaNotification", + "type": "object" + }, + "RemoteControlClientConnectionAudience": { + "description": "Audience for a remote-control client connection device-key proof.", + "enum": [ + "remote_control_client_websocket" + ], + "type": "string" + }, + "RemoteControlClientEnrollmentAudience": { + "description": "Audience for a remote-control client enrollment device-key proof.", + "enum": [ + "remote_control_client_enrollment" + ], + "type": "string" + }, + "RequestId": { + "anyOf": [ + { + "type": "string" + }, + { + "format": "int64", + "type": "integer" + } + ] + }, + "RequestPermissionProfile": { + "additionalProperties": false, + "properties": { + "fileSystem": { + "anyOf": [ + { + "$ref": "#/definitions/AdditionalFileSystemPermissions" + }, + { + "type": "null" + } + ] + }, + "network": { + "anyOf": [ + { + "$ref": "#/definitions/AdditionalNetworkPermissions" + }, + { + "type": "null" + } + ] + } + }, + "type": "object" + }, + "ResidencyRequirement": { + "enum": [ + "us" + ], + "type": "string" + }, + "Resource": { + "description": "A known resource that the server is capable of reading.", + "properties": { + "_meta": true, + "annotations": true, + "description": { + "type": [ + "string", + "null" + ] + }, + "icons": { + "items": true, + "type": [ + "array", + "null" + ] + }, + "mimeType": { + "type": [ + "string", + "null" + ] + }, + "name": { + "type": "string" + }, + "size": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "uri": { + "type": "string" + } + }, + "required": [ + "name", + "uri" + ], + "type": "object" + }, + "ResourceContent": { + "anyOf": [ + { + "properties": { + "_meta": true, + "mimeType": { + "type": [ + "string", + "null" + ] + }, + "text": { + "type": "string" + }, + "uri": { + "description": "The URI of this resource.", + "type": "string" + } + }, + "required": [ + "text", + "uri" + ], + "type": "object" + }, + { + "properties": { + "_meta": true, + "blob": { + "type": "string" + }, + "mimeType": { + "type": [ + "string", + "null" + ] + }, + "uri": { + "description": "The URI of this resource.", + "type": "string" + } + }, + "required": [ + "blob", + "uri" + ], + "type": "object" + } + ], + "description": "Contents returned when reading a resource from an MCP server." + }, + "ResourceTemplate": { + "description": "A template description for resources available on the server.", + "properties": { + "annotations": true, + "description": { + "type": [ + "string", + "null" + ] + }, + "mimeType": { + "type": [ + "string", + "null" + ] + }, + "name": { + "type": "string" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "uriTemplate": { + "type": "string" + } + }, + "required": [ + "name", + "uriTemplate" + ], + "type": "object" + }, + "ResponseItem": { + "oneOf": [ + { + "properties": { + "content": { + "items": { + "$ref": "#/definitions/ContentItem" + }, + "type": "array" + }, + "end_turn": { + "type": [ + "boolean", + "null" + ] + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "phase": { + "anyOf": [ + { + "$ref": "#/definitions/MessagePhase" + }, + { + "type": "null" + } + ] + }, + "role": { + "type": "string" + }, + "type": { + "enum": [ + "message" + ], + "title": "MessageResponseItemType", + "type": "string" + } + }, + "required": [ + "content", + "role", + "type" + ], + "title": "MessageResponseItem", + "type": "object" + }, + { + "properties": { + "content": { + "default": null, + "items": { + "$ref": "#/definitions/ReasoningItemContent" + }, + "type": [ + "array", + "null" + ] + }, + "encrypted_content": { + "type": [ + "string", + "null" + ] + }, + "summary": { + "items": { + "$ref": "#/definitions/ReasoningItemReasoningSummary" + }, + "type": "array" + }, + "type": { + "enum": [ + "reasoning" + ], + "title": "ReasoningResponseItemType", + "type": "string" + } + }, + "required": [ + "summary", + "type" + ], + "title": "ReasoningResponseItem", + "type": "object" + }, + { + "properties": { + "action": { + "$ref": "#/definitions/LocalShellAction" + }, + "call_id": { + "description": "Set when using the Responses API.", + "type": [ + "string", + "null" + ] + }, + "id": { + "description": "Legacy id field retained for compatibility with older payloads.", + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "status": { + "$ref": "#/definitions/LocalShellStatus" + }, + "type": { + "enum": [ + "local_shell_call" + ], + "title": "LocalShellCallResponseItemType", + "type": "string" + } + }, + "required": [ + "action", + "status", + "type" + ], + "title": "LocalShellCallResponseItem", + "type": "object" + }, + { + "properties": { + "arguments": { + "type": "string" + }, + "call_id": { + "type": "string" + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "name": { + "type": "string" + }, + "namespace": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "function_call" + ], + "title": "FunctionCallResponseItemType", + "type": "string" + } + }, + "required": [ + "arguments", + "call_id", + "name", + "type" + ], + "title": "FunctionCallResponseItem", + "type": "object" + }, + { + "properties": { + "arguments": true, + "call_id": { + "type": [ + "string", + "null" + ] + }, + "execution": { + "type": "string" + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "status": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "tool_search_call" + ], + "title": "ToolSearchCallResponseItemType", + "type": "string" + } + }, + "required": [ + "arguments", + "execution", + "type" + ], + "title": "ToolSearchCallResponseItem", + "type": "object" + }, + { + "properties": { + "call_id": { + "type": "string" + }, + "output": { + "$ref": "#/definitions/FunctionCallOutputBody" + }, + "type": { + "enum": [ + "function_call_output" + ], + "title": "FunctionCallOutputResponseItemType", + "type": "string" + } + }, + "required": [ + "call_id", + "output", + "type" + ], + "title": "FunctionCallOutputResponseItem", + "type": "object" + }, + { + "properties": { + "call_id": { + "type": "string" + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "input": { + "type": "string" + }, + "name": { + "type": "string" + }, + "status": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "custom_tool_call" + ], + "title": "CustomToolCallResponseItemType", + "type": "string" + } + }, + "required": [ + "call_id", + "input", + "name", + "type" + ], + "title": "CustomToolCallResponseItem", + "type": "object" + }, + { + "properties": { + "call_id": { + "type": "string" + }, + "name": { + "type": [ + "string", + "null" + ] + }, + "output": { + "$ref": "#/definitions/FunctionCallOutputBody" + }, + "type": { + "enum": [ + "custom_tool_call_output" + ], + "title": "CustomToolCallOutputResponseItemType", + "type": "string" + } + }, + "required": [ + "call_id", + "output", + "type" + ], + "title": "CustomToolCallOutputResponseItem", + "type": "object" + }, + { + "properties": { + "call_id": { + "type": [ + "string", + "null" + ] + }, + "execution": { + "type": "string" + }, + "status": { + "type": "string" + }, + "tools": { + "items": true, + "type": "array" + }, + "type": { + "enum": [ + "tool_search_output" + ], + "title": "ToolSearchOutputResponseItemType", + "type": "string" + } + }, + "required": [ + "execution", + "status", + "tools", + "type" + ], + "title": "ToolSearchOutputResponseItem", + "type": "object" + }, + { + "properties": { + "action": { + "anyOf": [ + { + "$ref": "#/definitions/ResponsesApiWebSearchAction" + }, + { + "type": "null" + } + ] + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "status": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "web_search_call" + ], + "title": "WebSearchCallResponseItemType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "WebSearchCallResponseItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "result": { + "type": "string" + }, + "revised_prompt": { + "type": [ + "string", + "null" + ] + }, + "status": { + "type": "string" + }, + "type": { + "enum": [ + "image_generation_call" + ], + "title": "ImageGenerationCallResponseItemType", + "type": "string" + } + }, + "required": [ + "id", + "result", + "status", + "type" + ], + "title": "ImageGenerationCallResponseItem", + "type": "object" + }, + { + "properties": { + "ghost_commit": { + "$ref": "#/definitions/GhostCommit" + }, + "type": { + "enum": [ + "ghost_snapshot" + ], + "title": "GhostSnapshotResponseItemType", + "type": "string" + } + }, + "required": [ + "ghost_commit", + "type" + ], + "title": "GhostSnapshotResponseItem", + "type": "object" + }, + { + "properties": { + "encrypted_content": { + "type": "string" + }, + "type": { + "enum": [ + "compaction" + ], + "title": "CompactionResponseItemType", + "type": "string" + } + }, + "required": [ + "encrypted_content", + "type" + ], + "title": "CompactionResponseItem", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "other" + ], + "title": "OtherResponseItemType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "OtherResponseItem", + "type": "object" + } + ] + }, + "ResponsesApiWebSearchAction": { + "oneOf": [ + { + "properties": { + "queries": { + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "query": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "search" + ], + "title": "SearchResponsesApiWebSearchActionType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "SearchResponsesApiWebSearchAction", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "open_page" + ], + "title": "OpenPageResponsesApiWebSearchActionType", + "type": "string" + }, + "url": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "type" + ], + "title": "OpenPageResponsesApiWebSearchAction", + "type": "object" + }, + { + "properties": { + "pattern": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "find_in_page" + ], + "title": "FindInPageResponsesApiWebSearchActionType", + "type": "string" + }, + "url": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "type" + ], + "title": "FindInPageResponsesApiWebSearchAction", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "other" + ], + "title": "OtherResponsesApiWebSearchActionType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "OtherResponsesApiWebSearchAction", + "type": "object" + } + ] + }, + "ReviewDelivery": { + "enum": [ + "inline", + "detached" + ], + "type": "string" + }, + "ReviewStartParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "delivery": { + "anyOf": [ + { + "$ref": "#/definitions/ReviewDelivery" + }, + { + "type": "null" + } + ], + "default": null, + "description": "Where to run the review: inline (default) on the current thread or detached on a new thread (returned in `reviewThreadId`)." + }, + "target": { + "$ref": "#/definitions/ReviewTarget" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "target", + "threadId" + ], + "title": "ReviewStartParams", + "type": "object" + }, + "ReviewStartResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "reviewThreadId": { + "description": "Identifies the thread where the review runs.\n\nFor inline reviews, this is the original thread id. For detached reviews, this is the id of the new review thread.", + "type": "string" + }, + "turn": { + "$ref": "#/definitions/Turn" + } + }, + "required": [ + "reviewThreadId", + "turn" + ], + "title": "ReviewStartResponse", + "type": "object" + }, + "ReviewTarget": { + "oneOf": [ + { + "description": "Review the working tree: staged, unstaged, and untracked files.", + "properties": { + "type": { + "enum": [ + "uncommittedChanges" + ], + "title": "UncommittedChangesReviewTargetType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "UncommittedChangesReviewTarget", + "type": "object" + }, + { + "description": "Review changes between the current branch and the given base branch.", + "properties": { + "branch": { + "type": "string" + }, + "type": { + "enum": [ + "baseBranch" + ], + "title": "BaseBranchReviewTargetType", + "type": "string" + } + }, + "required": [ + "branch", + "type" + ], + "title": "BaseBranchReviewTarget", + "type": "object" + }, + { + "description": "Review the changes introduced by a specific commit.", + "properties": { + "sha": { + "type": "string" + }, + "title": { + "description": "Optional human-readable label (e.g., commit subject) for UIs.", + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "commit" + ], + "title": "CommitReviewTargetType", + "type": "string" + } + }, + "required": [ + "sha", + "type" + ], + "title": "CommitReviewTarget", + "type": "object" + }, + { + "description": "Arbitrary instructions, equivalent to the old free-form prompt.", + "properties": { + "instructions": { + "type": "string" + }, + "type": { + "enum": [ + "custom" + ], + "title": "CustomReviewTargetType", + "type": "string" + } + }, + "required": [ + "instructions", + "type" + ], + "title": "CustomReviewTarget", + "type": "object" + } + ] + }, + "SandboxMode": { + "enum": [ + "read-only", + "workspace-write", + "danger-full-access" + ], + "type": "string" + }, + "SandboxPolicy": { + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "dangerFullAccess" + ], + "title": "DangerFullAccessSandboxPolicyType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "DangerFullAccessSandboxPolicy", + "type": "object" + }, + { + "properties": { + "access": { + "allOf": [ + { + "$ref": "#/definitions/ReadOnlyAccess" + } + ], + "default": { + "type": "fullAccess" + } + }, + "networkAccess": { + "default": false, + "type": "boolean" + }, + "type": { + "enum": [ + "readOnly" + ], + "title": "ReadOnlySandboxPolicyType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ReadOnlySandboxPolicy", + "type": "object" + }, + { + "properties": { + "networkAccess": { + "allOf": [ + { + "$ref": "#/definitions/NetworkAccess" + } + ], + "default": "restricted" + }, + "type": { + "enum": [ + "externalSandbox" + ], + "title": "ExternalSandboxSandboxPolicyType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ExternalSandboxSandboxPolicy", + "type": "object" + }, + { + "properties": { + "excludeSlashTmp": { + "default": false, + "type": "boolean" + }, + "excludeTmpdirEnvVar": { + "default": false, + "type": "boolean" + }, + "networkAccess": { + "default": false, + "type": "boolean" + }, + "readOnlyAccess": { + "allOf": [ + { + "$ref": "#/definitions/ReadOnlyAccess" + } + ], + "default": { + "type": "fullAccess" + } + }, + "type": { + "enum": [ + "workspaceWrite" + ], + "title": "WorkspaceWriteSandboxPolicyType", + "type": "string" + }, + "writableRoots": { + "default": [], + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": "array" + } + }, + "required": [ + "type" + ], + "title": "WorkspaceWriteSandboxPolicy", + "type": "object" + } + ] }, "SandboxWorkspaceWrite": { - "type": "object", "properties": { "exclude_slash_tmp": { "default": false, @@ -13717,15 +9931,6271 @@ }, "writable_roots": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" + }, + "SendAddCreditsNudgeEmailParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "creditType": { + "$ref": "#/definitions/AddCreditsNudgeCreditType" + } + }, + "required": [ + "creditType" + ], + "title": "SendAddCreditsNudgeEmailParams", + "type": "object" + }, + "SendAddCreditsNudgeEmailResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "status": { + "$ref": "#/definitions/AddCreditsNudgeEmailStatus" + } + }, + "required": [ + "status" + ], + "title": "SendAddCreditsNudgeEmailResponse", + "type": "object" + }, + "ServerNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Notification sent from the server to the client.", + "oneOf": [ + { + "description": "NEW NOTIFICATIONS", + "properties": { + "method": { + "enum": [ + "error" + ], + "title": "ErrorNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ErrorNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "ErrorNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/started" + ], + "title": "Thread/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/status/changed" + ], + "title": "Thread/status/changedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadStatusChangedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/status/changedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/archived" + ], + "title": "Thread/archivedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadArchivedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/archivedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/unarchived" + ], + "title": "Thread/unarchivedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadUnarchivedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/unarchivedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/closed" + ], + "title": "Thread/closedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadClosedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/closedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/name/updated" + ], + "title": "Thread/name/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadNameUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/name/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/tokenUsage/updated" + ], + "title": "Thread/tokenUsage/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadTokenUsageUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/tokenUsage/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "turn/started" + ], + "title": "Turn/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Turn/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "hook/started" + ], + "title": "Hook/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/HookStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Hook/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "turn/completed" + ], + "title": "Turn/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Turn/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "hook/completed" + ], + "title": "Hook/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/HookCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Hook/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "turn/diff/updated" + ], + "title": "Turn/diff/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnDiffUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Turn/diff/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "turn/plan/updated" + ], + "title": "Turn/plan/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TurnPlanUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Turn/plan/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/started" + ], + "title": "Item/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ItemStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/autoApprovalReview/started" + ], + "title": "Item/autoApprovalReview/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ItemGuardianApprovalReviewStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/autoApprovalReview/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/autoApprovalReview/completed" + ], + "title": "Item/autoApprovalReview/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ItemGuardianApprovalReviewCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/autoApprovalReview/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/completed" + ], + "title": "Item/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ItemCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/agentMessage/delta" + ], + "title": "Item/agentMessage/deltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/AgentMessageDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/agentMessage/deltaNotification", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items.", + "properties": { + "method": { + "enum": [ + "item/plan/delta" + ], + "title": "Item/plan/deltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/PlanDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/plan/deltaNotification", + "type": "object" + }, + { + "description": "Stream base64-encoded stdout/stderr chunks for a running `command/exec` session.", + "properties": { + "method": { + "enum": [ + "command/exec/outputDelta" + ], + "title": "Command/exec/outputDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecOutputDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Command/exec/outputDeltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/commandExecution/outputDelta" + ], + "title": "Item/commandExecution/outputDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/CommandExecutionOutputDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/commandExecution/outputDeltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/commandExecution/terminalInteraction" + ], + "title": "Item/commandExecution/terminalInteractionNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/TerminalInteractionNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/commandExecution/terminalInteractionNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/fileChange/outputDelta" + ], + "title": "Item/fileChange/outputDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FileChangeOutputDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/fileChange/outputDeltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/fileChange/patchUpdated" + ], + "title": "Item/fileChange/patchUpdatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FileChangePatchUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/fileChange/patchUpdatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "serverRequest/resolved" + ], + "title": "ServerRequest/resolvedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ServerRequestResolvedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "ServerRequest/resolvedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/mcpToolCall/progress" + ], + "title": "Item/mcpToolCall/progressNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpToolCallProgressNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/mcpToolCall/progressNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "mcpServer/oauthLogin/completed" + ], + "title": "McpServer/oauthLogin/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpServerOauthLoginCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "McpServer/oauthLogin/completedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "mcpServer/startupStatus/updated" + ], + "title": "McpServer/startupStatus/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/McpServerStatusUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "McpServer/startupStatus/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "account/updated" + ], + "title": "Account/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/AccountUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Account/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "account/rateLimits/updated" + ], + "title": "Account/rateLimits/updatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/AccountRateLimitsUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Account/rateLimits/updatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "fs/changed" + ], + "title": "Fs/changedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FsChangedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Fs/changedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/reasoning/summaryTextDelta" + ], + "title": "Item/reasoning/summaryTextDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ReasoningSummaryTextDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/reasoning/summaryTextDeltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/reasoning/summaryPartAdded" + ], + "title": "Item/reasoning/summaryPartAddedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ReasoningSummaryPartAddedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/reasoning/summaryPartAddedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "item/reasoning/textDelta" + ], + "title": "Item/reasoning/textDeltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ReasoningTextDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Item/reasoning/textDeltaNotification", + "type": "object" + }, + { + "description": "Deprecated: Use `ContextCompaction` item type instead.", + "properties": { + "method": { + "enum": [ + "thread/compacted" + ], + "title": "Thread/compactedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ContextCompactedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/compactedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "model/rerouted" + ], + "title": "Model/reroutedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ModelReroutedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Model/reroutedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "warning" + ], + "title": "WarningNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/WarningNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "WarningNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "guardianWarning" + ], + "title": "GuardianWarningNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/GuardianWarningNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "GuardianWarningNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "deprecationNotice" + ], + "title": "DeprecationNoticeNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/DeprecationNoticeNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "DeprecationNoticeNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "configWarning" + ], + "title": "ConfigWarningNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ConfigWarningNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "ConfigWarningNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/epiphany/stateUpdated" + ], + "title": "Thread/epiphany/stateUpdatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadEpiphanyStateUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/epiphany/stateUpdatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/epiphany/jobsUpdated" + ], + "title": "Thread/epiphany/jobsUpdatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadEpiphanyJobsUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/epiphany/jobsUpdatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "fuzzyFileSearch/sessionUpdated" + ], + "title": "FuzzyFileSearch/sessionUpdatedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FuzzyFileSearchSessionUpdatedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "FuzzyFileSearch/sessionUpdatedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "fuzzyFileSearch/sessionCompleted" + ], + "title": "FuzzyFileSearch/sessionCompletedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/FuzzyFileSearchSessionCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "FuzzyFileSearch/sessionCompletedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/started" + ], + "title": "Thread/realtime/startedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeStartedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/startedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/itemAdded" + ], + "title": "Thread/realtime/itemAddedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeItemAddedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/itemAddedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/transcript/delta" + ], + "title": "Thread/realtime/transcript/deltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeTranscriptDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/transcript/deltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/transcript/done" + ], + "title": "Thread/realtime/transcript/doneNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeTranscriptDoneNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/transcript/doneNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/outputAudio/delta" + ], + "title": "Thread/realtime/outputAudio/deltaNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeOutputAudioDeltaNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/outputAudio/deltaNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/sdp" + ], + "title": "Thread/realtime/sdpNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeSdpNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/sdpNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/error" + ], + "title": "Thread/realtime/errorNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeErrorNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/errorNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "thread/realtime/closed" + ], + "title": "Thread/realtime/closedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/ThreadRealtimeClosedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Thread/realtime/closedNotification", + "type": "object" + }, + { + "description": "Notifies the user of world-writable directories on Windows, which cannot be protected by the sandbox.", + "properties": { + "method": { + "enum": [ + "windows/worldWritableWarning" + ], + "title": "Windows/worldWritableWarningNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/WindowsWorldWritableWarningNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Windows/worldWritableWarningNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "windowsSandbox/setupCompleted" + ], + "title": "WindowsSandbox/setupCompletedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/WindowsSandboxSetupCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "WindowsSandbox/setupCompletedNotification", + "type": "object" + }, + { + "properties": { + "method": { + "enum": [ + "account/login/completed" + ], + "title": "Account/login/completedNotificationMethod", + "type": "string" + }, + "params": { + "$ref": "#/definitions/AccountLoginCompletedNotification" + } + }, + "required": [ + "method", + "params" + ], + "title": "Account/login/completedNotification", + "type": "object" + } + ], + "title": "ServerNotification" + }, + "ServerRequestResolvedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "requestId": { + "$ref": "#/definitions/RequestId" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "requestId", + "threadId" + ], + "title": "ServerRequestResolvedNotification", + "type": "object" + }, + "ServiceTier": { + "enum": [ + "fast", + "flex" + ], + "type": "string" + }, + "SessionSource": { + "oneOf": [ + { + "enum": [ + "cli", + "vscode", + "exec", + "appServer", + "unknown" + ], + "type": "string" + }, + { + "additionalProperties": false, + "properties": { + "custom": { + "type": "string" + } + }, + "required": [ + "custom" + ], + "title": "CustomSessionSource", + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "subAgent": { + "$ref": "#/definitions/SubAgentSource" + } + }, + "required": [ + "subAgent" + ], + "title": "SubAgentSessionSource", + "type": "object" + } + ] + }, + "Settings": { + "description": "Settings for a collaboration mode.", + "properties": { + "developer_instructions": { + "type": [ + "string", + "null" + ] + }, + "model": { + "type": "string" + }, + "reasoning_effort": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningEffort" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "model" + ], + "type": "object" + }, + "SortDirection": { + "enum": [ + "asc", + "desc" + ], + "type": "string" + }, + "SubAgentSource": { + "oneOf": [ + { + "enum": [ + "review", + "compact", + "memory_consolidation" + ], + "type": "string" + }, + { + "additionalProperties": false, + "properties": { + "thread_spawn": { + "properties": { + "agent_nickname": { + "default": null, + "type": [ + "string", + "null" + ] + }, + "agent_path": { + "anyOf": [ + { + "$ref": "#/definitions/AgentPath" + }, + { + "type": "null" + } + ], + "default": null + }, + "agent_role": { + "default": null, + "type": [ + "string", + "null" + ] + }, + "depth": { + "format": "int32", + "type": "integer" + }, + "parent_thread_id": { + "$ref": "#/definitions/ThreadId" + } + }, + "required": [ + "depth", + "parent_thread_id" + ], + "type": "object" + } + }, + "required": [ + "thread_spawn" + ], + "title": "ThreadSpawnSubAgentSource", + "type": "object" + }, + { + "additionalProperties": false, + "properties": { + "other": { + "type": "string" + } + }, + "required": [ + "other" + ], + "title": "OtherSubAgentSource", + "type": "object" + } + ] + }, + "TerminalInteractionNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "itemId": { + "type": "string" + }, + "processId": { + "type": "string" + }, + "stdin": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "itemId", + "processId", + "stdin", + "threadId", + "turnId" + ], + "title": "TerminalInteractionNotification", + "type": "object" + }, + "TextElement": { + "properties": { + "byteRange": { + "allOf": [ + { + "$ref": "#/definitions/ByteRange" + } + ], + "description": "Byte range in the parent `text` buffer that this element occupies." + }, + "placeholder": { + "description": "Optional human-readable placeholder for the element, displayed in the UI.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "byteRange" + ], + "type": "object" + }, + "TextPosition": { + "properties": { + "column": { + "description": "1-based column number (in Unicode scalar values).", + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "line": { + "description": "1-based line number.", + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "column", + "line" + ], + "type": "object" + }, + "TextRange": { + "properties": { + "end": { + "$ref": "#/definitions/TextPosition" + }, + "start": { + "$ref": "#/definitions/TextPosition" + } + }, + "required": [ + "end", + "start" + ], + "type": "object" + }, + "Thread": { + "properties": { + "agentNickname": { + "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", + "type": [ + "string", + "null" + ] + }, + "agentRole": { + "description": "Optional role (agent_role) assigned to an AgentControl-spawned sub-agent.", + "type": [ + "string", + "null" + ] + }, + "cliVersion": { + "description": "Version of the CLI that created the thread.", + "type": "string" + }, + "createdAt": { + "description": "Unix timestamp (in seconds) when the thread was created.", + "format": "int64", + "type": "integer" + }, + "cwd": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Working directory captured for the thread." + }, + "ephemeral": { + "description": "Whether the thread is ephemeral and should not be materialized on disk.", + "type": "boolean" + }, + "epiphanyState": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyThreadState" + }, + { + "type": "null" + } + ], + "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads." + }, + "forkedFromId": { + "description": "Source thread id when this thread was created by forking another thread.", + "type": [ + "string", + "null" + ] + }, + "gitInfo": { + "anyOf": [ + { + "$ref": "#/definitions/GitInfo" + }, + { + "type": "null" + } + ], + "description": "Optional Git metadata captured when the thread was created." + }, + "id": { + "type": "string" + }, + "modelProvider": { + "description": "Model provider used for this thread (for example, 'openai').", + "type": "string" + }, + "name": { + "description": "Optional user-facing thread title.", + "type": [ + "string", + "null" + ] + }, + "path": { + "description": "[UNSTABLE] Path to the thread on disk.", + "type": [ + "string", + "null" + ] + }, + "preview": { + "description": "Usually the first user message in the thread, if available.", + "type": "string" + }, + "source": { + "allOf": [ + { + "$ref": "#/definitions/SessionSource" + } + ], + "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." + }, + "status": { + "allOf": [ + { + "$ref": "#/definitions/ThreadStatus" + } + ], + "description": "Current runtime status for the thread." + }, + "turns": { + "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", + "items": { + "$ref": "#/definitions/Turn" + }, + "type": "array" + }, + "updatedAt": { + "description": "Unix timestamp (in seconds) when the thread was last updated.", + "format": "int64", + "type": "integer" + } + }, + "required": [ + "cliVersion", + "createdAt", + "cwd", + "ephemeral", + "id", + "modelProvider", + "preview", + "source", + "status", + "turns", + "updatedAt" + ], + "type": "object" + }, + "ThreadActiveFlag": { + "enum": [ + "waitingOnApproval", + "waitingOnUserInput" + ], + "type": "string" + }, + "ThreadApproveGuardianDeniedActionParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "event": { + "description": "Serialized `codex_protocol::protocol::GuardianAssessmentEvent`." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "event", + "threadId" + ], + "title": "ThreadApproveGuardianDeniedActionParams", + "type": "object" + }, + "ThreadApproveGuardianDeniedActionResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadApproveGuardianDeniedActionResponse", + "type": "object" + }, + "ThreadArchiveParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadArchiveParams", + "type": "object" + }, + "ThreadArchiveResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadArchiveResponse", + "type": "object" + }, + "ThreadArchivedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadArchivedNotification", + "type": "object" + }, + "ThreadClosedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadClosedNotification", + "type": "object" + }, + "ThreadCompactStartParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadCompactStartParams", + "type": "object" + }, + "ThreadCompactStartResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadCompactStartResponse", + "type": "object" + }, + "ThreadEpiphanyContext": { + "properties": { + "checkpoint": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyGraphCheckpoint" + }, + { + "type": "null" + } + ] + }, + "evidence": { + "items": { + "$ref": "#/definitions/EpiphanyEvidenceRecord" + }, + "type": "array" + }, + "frontier": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyGraphFrontier" + }, + { + "type": "null" + } + ] + }, + "graph": { + "$ref": "#/definitions/ThreadEpiphanyGraphContext" + }, + "investigationCheckpoint": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyInvestigationCheckpoint" + }, + { + "type": "null" + } + ] + }, + "observations": { + "items": { + "$ref": "#/definitions/EpiphanyObservation" + }, + "type": "array" + } + }, + "required": [ + "graph" + ], + "type": "object" + }, + "ThreadEpiphanyContextMissing": { + "properties": { + "evidenceIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "graphEdgeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "graphNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "observationIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ThreadEpiphanyContextSource": { + "enum": [ + "stored", + "live" + ], + "type": "string" + }, + "ThreadEpiphanyContextStateStatus": { + "enum": [ + "missing", + "ready" + ], + "type": "string" + }, + "ThreadEpiphanyCoordinatorAction": { + "enum": [ + "prepareCheckpoint", + "compactRehydrateReorient", + "launchReorientWorker", + "waitForReorientWorker", + "reviewReorientResult", + "regatherManually", + "launchResearch", + "reviewResearchResult", + "launchModeling", + "reviewModelingResult", + "launchVerification", + "reviewVerificationResult", + "continueImplementation" + ], + "type": "string" + }, + "ThreadEpiphanyCoordinatorSignals": { + "properties": { + "crrcAction": { + "$ref": "#/definitions/ThreadEpiphanyCrrcAction" + }, + "modelingResultStatus": { + "$ref": "#/definitions/ThreadEpiphanyRoleResultStatus" + }, + "pressureLevel": { + "$ref": "#/definitions/ThreadEpiphanyPressureLevel" + }, + "reorientAction": { + "$ref": "#/definitions/ThreadEpiphanyReorientAction" + }, + "reorientResultStatus": { + "$ref": "#/definitions/ThreadEpiphanyReorientResultStatus" + }, + "researchResultStatus": { + "$ref": "#/definitions/ThreadEpiphanyRoleResultStatus" + }, + "shouldPrepareCompaction": { + "type": "boolean" + }, + "verificationResultStatus": { + "$ref": "#/definitions/ThreadEpiphanyRoleResultStatus" + } + }, + "required": [ + "crrcAction", + "modelingResultStatus", + "pressureLevel", + "reorientAction", + "reorientResultStatus", + "researchResultStatus", + "shouldPrepareCompaction", + "verificationResultStatus" + ], + "type": "object" + }, + "ThreadEpiphanyCrrcAction": { + "enum": [ + "continue", + "prepareCheckpoint", + "launchReorientWorker", + "waitForReorientWorker", + "reviewReorientResult", + "acceptReorientResult", + "regatherManually" + ], + "type": "string" + }, + "ThreadEpiphanyCrrcRecommendation": { + "properties": { + "action": { + "$ref": "#/definitions/ThreadEpiphanyCrrcAction" + }, + "reason": { + "type": "string" + }, + "recommendedSceneAction": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanySceneAction" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "action", + "reason" + ], + "type": "object" + }, + "ThreadEpiphanyFreshnessSource": { + "enum": [ + "stored", + "live" + ], + "type": "string" + }, + "ThreadEpiphanyGraphContext": { + "properties": { + "architectureEdges": { + "items": { + "$ref": "#/definitions/EpiphanyGraphEdge" + }, + "type": "array" + }, + "architectureNodes": { + "items": { + "$ref": "#/definitions/EpiphanyGraphNode" + }, + "type": "array" + }, + "dataflowEdges": { + "items": { + "$ref": "#/definitions/EpiphanyGraphEdge" + }, + "type": "array" + }, + "dataflowNodes": { + "items": { + "$ref": "#/definitions/EpiphanyGraphNode" + }, + "type": "array" + }, + "links": { + "items": { + "$ref": "#/definitions/EpiphanyGraphLink" + }, + "type": "array" + } + }, + "type": "object" + }, + "ThreadEpiphanyGraphFreshness": { + "properties": { + "checkpointId": { + "type": [ + "string", + "null" + ] + }, + "dirtyPathCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "dirtyPaths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "graphFreshness": { + "type": [ + "string", + "null" + ] + }, + "note": { + "type": "string" + }, + "openGapCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "openQuestionCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "status": { + "$ref": "#/definitions/ThreadEpiphanyGraphFreshnessStatus" + } + }, + "required": [ + "dirtyPathCount", + "note", + "openGapCount", + "openQuestionCount", + "status" + ], + "type": "object" + }, + "ThreadEpiphanyGraphFreshnessStatus": { + "enum": [ + "missing", + "ready", + "stale" + ], + "type": "string" + }, + "ThreadEpiphanyGraphQuery": { + "properties": { + "depth": { + "description": "Defaults to 1 and is capped by the server.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "direction": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanyGraphQueryDirection" + }, + { + "type": "null" + } + ], + "description": "Defaults to `both`." + }, + "edgeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "edgeKinds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "includeLinks": { + "description": "Defaults to true so neighborhood queries preserve dataflow/architecture joins.", + "type": [ + "boolean", + "null" + ] + }, + "kind": { + "$ref": "#/definitions/ThreadEpiphanyGraphQueryKind" + }, + "nodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "paths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "symbols": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "kind" + ], + "type": "object" + }, + "ThreadEpiphanyGraphQueryDirection": { + "enum": [ + "incoming", + "outgoing", + "both" + ], + "type": "string" + }, + "ThreadEpiphanyGraphQueryKind": { + "enum": [ + "node", + "path", + "frontierNeighborhood", + "neighbors" + ], + "type": "string" + }, + "ThreadEpiphanyGraphQueryMatched": { + "properties": { + "edgeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "edgeKinds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "nodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "paths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "symbols": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ThreadEpiphanyGraphQueryMissing": { + "properties": { + "edgeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "nodeIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "type": "object" + }, + "ThreadEpiphanyInvalidationInput": { + "properties": { + "activeFrontierNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "changedPathCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "changedPaths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "graphNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "note": { + "type": "string" + }, + "observedAtUnixSeconds": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "status": { + "$ref": "#/definitions/ThreadEpiphanyInvalidationStatus" + }, + "watchedRoot": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "changedPathCount", + "note", + "status" + ], + "type": "object" + }, + "ThreadEpiphanyInvalidationStatus": { + "enum": [ + "unavailable", + "clean", + "changed" + ], + "type": "string" + }, + "ThreadEpiphanyJob": { + "properties": { + "activeThreadIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "authorityScope": { + "type": [ + "string", + "null" + ] + }, + "backendJobId": { + "type": [ + "string", + "null" + ] + }, + "blockingReason": { + "type": [ + "string", + "null" + ] + }, + "id": { + "type": "string" + }, + "itemsProcessed": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "itemsTotal": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "kind": { + "$ref": "#/definitions/ThreadEpiphanyJobKind" + }, + "lastCheckpointAtUnixSeconds": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "launcherJobId": { + "type": [ + "string", + "null" + ] + }, + "linkedGraphNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "linkedSubgoalIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "ownerRole": { + "type": "string" + }, + "progressNote": { + "type": [ + "string", + "null" + ] + }, + "scope": { + "type": "string" + }, + "status": { + "$ref": "#/definitions/ThreadEpiphanyJobStatus" + } + }, + "required": [ + "id", + "kind", + "ownerRole", + "scope", + "status" + ], + "type": "object" + }, + "ThreadEpiphanyJobKind": { + "enum": [ + "indexing", + "remap", + "verification", + "specialist" + ], + "type": "string" + }, + "ThreadEpiphanyJobStatus": { + "enum": [ + "idle", + "needed", + "pending", + "running", + "completed", + "failed", + "cancelled", + "blocked", + "unavailable" + ], + "type": "string" + }, + "ThreadEpiphanyJobsUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "jobs": { + "items": { + "$ref": "#/definitions/ThreadEpiphanyJob" + }, + "type": "array" + }, + "source": { + "$ref": "#/definitions/ThreadEpiphanyJobsUpdatedSource" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "source", + "threadId" + ], + "title": "ThreadEpiphanyJobsUpdatedNotification", + "type": "object" + }, + "ThreadEpiphanyJobsUpdatedSource": { + "enum": [ + "runtimeProgress" + ], + "type": "string" + }, + "ThreadEpiphanyPlanningSummary": { + "properties": { + "activeObjective": { + "type": [ + "string", + "null" + ] + }, + "backlogItemCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "captureCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "draftObjectiveCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "githubIssueCaptureCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "note": { + "type": "string" + }, + "objectiveDraftCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "pendingCaptureCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "readyBacklogItemCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "roadmapStreamCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "backlogItemCount", + "captureCount", + "draftObjectiveCount", + "githubIssueCaptureCount", + "note", + "objectiveDraftCount", + "pendingCaptureCount", + "readyBacklogItemCount", + "roadmapStreamCount" + ], + "type": "object" + }, + "ThreadEpiphanyPressure": { + "properties": { + "basis": { + "$ref": "#/definitions/ThreadEpiphanyPressureBasis" + }, + "level": { + "$ref": "#/definitions/ThreadEpiphanyPressureLevel" + }, + "modelAutoCompactTokenLimit": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "modelContextWindow": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "note": { + "type": "string" + }, + "ratioPerMille": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "remainingTokens": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "shouldPrepareCompaction": { + "type": "boolean" + }, + "status": { + "$ref": "#/definitions/ThreadEpiphanyPressureStatus" + }, + "usedTokens": { + "format": "int64", + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "basis", + "level", + "note", + "shouldPrepareCompaction", + "status" + ], + "type": "object" + }, + "ThreadEpiphanyPressureBasis": { + "enum": [ + "unknown", + "autoCompactLimit", + "modelContextWindow" + ], + "type": "string" + }, + "ThreadEpiphanyPressureLevel": { + "enum": [ + "unknown", + "low", + "elevated", + "high", + "critical" + ], + "type": "string" + }, + "ThreadEpiphanyPressureStatus": { + "enum": [ + "unknown", + "ready" + ], + "type": "string" + }, + "ThreadEpiphanyReorientAction": { + "enum": [ + "resume", + "regather" + ], + "type": "string" + }, + "ThreadEpiphanyReorientCheckpointStatus": { + "enum": [ + "missing", + "resumeReady", + "regatherRequired" + ], + "type": "string" + }, + "ThreadEpiphanyReorientDecision": { + "properties": { + "action": { + "$ref": "#/definitions/ThreadEpiphanyReorientAction" + }, + "activeFrontierNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "checkpointChangedPaths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "checkpointDirtyPaths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "checkpointId": { + "type": [ + "string", + "null" + ] + }, + "checkpointStatus": { + "$ref": "#/definitions/ThreadEpiphanyReorientCheckpointStatus" + }, + "graphStatus": { + "$ref": "#/definitions/ThreadEpiphanyGraphFreshnessStatus" + }, + "nextAction": { + "type": "string" + }, + "note": { + "type": "string" + }, + "pressureLevel": { + "$ref": "#/definitions/ThreadEpiphanyPressureLevel" + }, + "reasons": { + "items": { + "$ref": "#/definitions/ThreadEpiphanyReorientReason" + }, + "type": "array" + }, + "retrievalStatus": { + "$ref": "#/definitions/ThreadEpiphanyRetrievalFreshnessStatus" + }, + "watcherStatus": { + "$ref": "#/definitions/ThreadEpiphanyInvalidationStatus" + } + }, + "required": [ + "action", + "checkpointStatus", + "graphStatus", + "nextAction", + "note", + "pressureLevel", + "retrievalStatus", + "watcherStatus" + ], + "type": "object" + }, + "ThreadEpiphanyReorientFinding": { + "properties": { + "artifactRefs": { + "items": { + "type": "string" + }, + "type": "array" + }, + "checkpointStillValid": { + "type": [ + "boolean", + "null" + ] + }, + "evidenceIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "filesInspected": { + "items": { + "type": "string" + }, + "type": "array" + }, + "frontierNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "itemError": { + "type": [ + "string", + "null" + ] + }, + "jobError": { + "type": [ + "string", + "null" + ] + }, + "mode": { + "type": [ + "string", + "null" + ] + }, + "nextSafeMove": { + "type": [ + "string", + "null" + ] + }, + "runtimeJobId": { + "type": [ + "string", + "null" + ] + }, + "runtimeResultId": { + "type": [ + "string", + "null" + ] + }, + "summary": { + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "ThreadEpiphanyReorientReason": { + "enum": [ + "missingState", + "missingCheckpoint", + "checkpointRequestedRegather", + "checkpointPathsDirty", + "checkpointPathsChanged", + "frontierChanged", + "unanchoredCheckpointWhileStateStale", + "checkpointReady" + ], + "type": "string" + }, + "ThreadEpiphanyReorientResultStatus": { + "enum": [ + "missingState", + "missingBinding", + "backendUnavailable", + "backendMissing", + "pending", + "running", + "completed", + "failed", + "cancelled" + ], + "type": "string" + }, + "ThreadEpiphanyReorientSource": { + "enum": [ + "stored", + "live" + ], + "type": "string" + }, + "ThreadEpiphanyReorientStateStatus": { + "enum": [ + "missing", + "ready" + ], + "type": "string" + }, + "ThreadEpiphanyRetrievalFreshness": { + "properties": { + "dirtyPaths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "indexedChunkCount": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "indexedFileCount": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "lastIndexedAtUnixSeconds": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "note": { + "type": "string" + }, + "semanticAvailable": { + "type": [ + "boolean", + "null" + ] + }, + "status": { + "$ref": "#/definitions/ThreadEpiphanyRetrievalFreshnessStatus" + } + }, + "required": [ + "note", + "status" + ], + "type": "object" + }, + "ThreadEpiphanyRetrievalFreshnessStatus": { + "enum": [ + "missing", + "ready", + "stale", + "indexing", + "unavailable" + ], + "type": "string" + }, + "ThreadEpiphanyRoleFinding": { + "properties": { + "artifactRefs": { + "items": { + "type": "string" + }, + "type": "array" + }, + "checkpointSummary": { + "type": [ + "string", + "null" + ] + }, + "evidenceGaps": { + "items": { + "type": "string" + }, + "type": "array" + }, + "evidenceIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "filesInspected": { + "items": { + "type": "string" + }, + "type": "array" + }, + "frontierNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "itemError": { + "type": [ + "string", + "null" + ] + }, + "jobError": { + "type": [ + "string", + "null" + ] + }, + "nextSafeMove": { + "type": [ + "string", + "null" + ] + }, + "openQuestions": { + "items": { + "type": "string" + }, + "type": "array" + }, + "risks": { + "items": { + "type": "string" + }, + "type": "array" + }, + "roleId": { + "$ref": "#/definitions/ThreadEpiphanyRoleId" + }, + "runtimeJobId": { + "type": [ + "string", + "null" + ] + }, + "runtimeResultId": { + "type": [ + "string", + "null" + ] + }, + "scratchSummary": { + "type": [ + "string", + "null" + ] + }, + "selfPatch": true, + "selfPersistence": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanyRoleSelfPersistenceReview" + }, + { + "type": "null" + } + ] + }, + "statePatch": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanyUpdatePatch" + }, + { + "type": "null" + } + ] + }, + "summary": { + "type": [ + "string", + "null" + ] + }, + "verdict": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "roleId" + ], + "type": "object" + }, + "ThreadEpiphanyRoleId": { + "enum": [ + "implementation", + "imagination", + "research", + "modeling", + "verification", + "reorientation" + ], + "type": "string" + }, + "ThreadEpiphanyRoleLane": { + "properties": { + "authorityScopes": { + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "$ref": "#/definitions/ThreadEpiphanyRoleId" + }, + "jobs": { + "items": { + "$ref": "#/definitions/ThreadEpiphanyJob" + }, + "type": "array" + }, + "note": { + "type": "string" + }, + "ownerRole": { + "type": "string" + }, + "recommendedAction": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanySceneAction" + }, + { + "type": "null" + } + ] + }, + "status": { + "$ref": "#/definitions/ThreadEpiphanyRoleStatus" + }, + "title": { + "type": "string" + } + }, + "required": [ + "id", + "note", + "ownerRole", + "status", + "title" + ], + "type": "object" + }, + "ThreadEpiphanyRoleResultStatus": { + "enum": [ + "missingState", + "missingBinding", + "backendUnavailable", + "backendMissing", + "pending", + "running", + "completed", + "failed", + "cancelled" + ], + "type": "string" + }, + "ThreadEpiphanyRoleSelfPersistenceReview": { + "properties": { + "reasons": { + "items": { + "type": "string" + }, + "type": "array" + }, + "status": { + "$ref": "#/definitions/ThreadEpiphanyRoleSelfPersistenceStatus" + }, + "targetAgentId": { + "type": [ + "string", + "null" + ] + }, + "targetPath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "status" + ], + "type": "object" + }, + "ThreadEpiphanyRoleSelfPersistenceStatus": { + "enum": [ + "missing", + "accepted", + "rejected" + ], + "type": "string" + }, + "ThreadEpiphanyRoleStatus": { + "enum": [ + "ready", + "needed", + "blocked", + "running", + "completed", + "waiting", + "review", + "unavailable" + ], + "type": "string" + }, + "ThreadEpiphanyRolesSource": { + "enum": [ + "stored", + "live" + ], + "type": "string" + }, + "ThreadEpiphanyScene": { + "properties": { + "activeSubgoal": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanySceneSubgoal" + }, + { + "type": "null" + } + ] + }, + "availableActions": { + "items": { + "$ref": "#/definitions/ThreadEpiphanySceneAction" + }, + "type": "array" + }, + "churn": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanySceneChurn" + }, + { + "type": "null" + } + ] + }, + "evidence": { + "$ref": "#/definitions/ThreadEpiphanySceneRecords" + }, + "graph": { + "$ref": "#/definitions/ThreadEpiphanySceneGraph" + }, + "invariantStatusCounts": { + "items": { + "$ref": "#/definitions/ThreadEpiphanySceneStatusCount" + }, + "type": "array" + }, + "investigationCheckpoint": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanySceneInvestigationCheckpoint" + }, + { + "type": "null" + } + ] + }, + "objective": { + "type": [ + "string", + "null" + ] + }, + "observations": { + "$ref": "#/definitions/ThreadEpiphanySceneRecords" + }, + "retrieval": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanySceneRetrieval" + }, + { + "type": "null" + } + ] + }, + "revision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "source": { + "$ref": "#/definitions/ThreadEpiphanySceneSource" + }, + "stateStatus": { + "$ref": "#/definitions/ThreadEpiphanySceneStateStatus" + }, + "subgoals": { + "items": { + "$ref": "#/definitions/ThreadEpiphanySceneSubgoal" + }, + "type": "array" + } + }, + "required": [ + "evidence", + "graph", + "observations", + "source", + "stateStatus" + ], + "type": "object" + }, + "ThreadEpiphanySceneAction": { + "enum": [ + "index", + "retrieve", + "distill", + "context", + "planning", + "graphQuery", + "jobs", + "roles", + "coordinator", + "roleLaunch", + "roleResult", + "roleAccept", + "jobLaunch", + "jobInterrupt", + "freshness", + "pressure", + "reorient", + "crrc", + "reorientLaunch", + "reorientResult", + "reorientAccept", + "propose", + "promote", + "update" + ], + "type": "string" + }, + "ThreadEpiphanySceneChurn": { + "properties": { + "diffPressure": { + "type": "string" + }, + "graphFreshness": { + "type": [ + "string", + "null" + ] + }, + "understandingStatus": { + "type": "string" + }, + "unexplainedWrites": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "warning": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "diffPressure", + "understandingStatus" + ], + "type": "object" + }, + "ThreadEpiphanySceneGraph": { + "properties": { + "activeEdgeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "activeNodeIds": { + "items": { + "type": "string" + }, + "type": "array" + }, + "architectureEdgeCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "architectureNodeCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "checkpointId": { + "type": [ + "string", + "null" + ] + }, + "checkpointSummary": { + "type": [ + "string", + "null" + ] + }, + "dataflowEdgeCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "dataflowNodeCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "dirtyPaths": { + "items": { + "type": "string" + }, + "type": "array" + }, + "linkCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "openGapCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "openQuestionCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "architectureEdgeCount", + "architectureNodeCount", + "dataflowEdgeCount", + "dataflowNodeCount", + "linkCount", + "openGapCount", + "openQuestionCount" + ], + "type": "object" + }, + "ThreadEpiphanySceneInvestigationCheckpoint": { + "properties": { + "capturedAtTurnId": { + "type": [ + "string", + "null" + ] + }, + "checkpointId": { + "type": "string" + }, + "codeRefCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "disposition": { + "$ref": "#/definitions/EpiphanyInvestigationDisposition" + }, + "evidenceCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "focus": { + "type": "string" + }, + "kind": { + "type": "string" + }, + "nextAction": { + "type": [ + "string", + "null" + ] + }, + "openQuestionCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "summary": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "checkpointId", + "codeRefCount", + "disposition", + "evidenceCount", + "focus", + "kind", + "openQuestionCount" + ], + "type": "object" + }, + "ThreadEpiphanySceneRecord": { + "properties": { + "codeRefCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "id": { + "type": "string" + }, + "kind": { + "type": "string" + }, + "status": { + "type": "string" + }, + "summary": { + "type": "string" + } + }, + "required": [ + "codeRefCount", + "id", + "kind", + "status", + "summary" + ], + "type": "object" + }, + "ThreadEpiphanySceneRecords": { + "properties": { + "latest": { + "items": { + "$ref": "#/definitions/ThreadEpiphanySceneRecord" + }, + "type": "array" + }, + "totalCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "totalCount" + ], + "type": "object" + }, + "ThreadEpiphanySceneRetrieval": { + "properties": { + "dirtyPathCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "indexRevision": { + "type": [ + "string", + "null" + ] + }, + "indexedChunkCount": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "indexedFileCount": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "semanticAvailable": { + "type": "boolean" + }, + "shardCount": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "status": { + "$ref": "#/definitions/EpiphanyRetrievalStatus" + }, + "workspaceRoot": { + "type": "string" + } + }, + "required": [ + "dirtyPathCount", + "semanticAvailable", + "shardCount", + "status", + "workspaceRoot" + ], + "type": "object" + }, + "ThreadEpiphanySceneSource": { + "enum": [ + "stored", + "live" + ], + "type": "string" + }, + "ThreadEpiphanySceneStateStatus": { + "enum": [ + "missing", + "ready" + ], + "type": "string" + }, + "ThreadEpiphanySceneStatusCount": { + "properties": { + "count": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "status": { + "type": "string" + } + }, + "required": [ + "count", + "status" + ], + "type": "object" + }, + "ThreadEpiphanySceneSubgoal": { + "properties": { + "active": { + "type": "boolean" + }, + "id": { + "type": "string" + }, + "status": { + "type": "string" + }, + "summary": { + "type": [ + "string", + "null" + ] + }, + "title": { + "type": "string" + } + }, + "required": [ + "active", + "id", + "status", + "title" + ], + "type": "object" + }, + "ThreadEpiphanyStateUpdatedField": { + "enum": [ + "objective", + "activeSubgoalId", + "subgoals", + "invariants", + "graphs", + "graphFrontier", + "graphCheckpoint", + "scratch", + "investigationCheckpoint", + "jobBindings", + "acceptanceReceipts", + "runtimeLinks", + "observations", + "evidence", + "churn", + "mode", + "planning" + ], + "type": "string" + }, + "ThreadEpiphanyStateUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "changedFields": { + "items": { + "$ref": "#/definitions/ThreadEpiphanyStateUpdatedField" + }, + "type": "array" + }, + "epiphanyState": { + "$ref": "#/definitions/EpiphanyThreadState" + }, + "revision": { + "format": "uint64", + "minimum": 0.0, + "type": "integer" + }, + "source": { + "$ref": "#/definitions/ThreadEpiphanyStateUpdatedSource" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "changedFields", + "epiphanyState", + "revision", + "source", + "threadId" + ], + "title": "ThreadEpiphanyStateUpdatedNotification", + "type": "object" + }, + "ThreadEpiphanyStateUpdatedSource": { + "enum": [ + "update", + "promote", + "jobLaunch", + "jobInterrupt", + "reorientAccept", + "roleAccept" + ], + "type": "string" + }, + "ThreadEpiphanyUpdatePatch": { + "properties": { + "acceptanceReceipts": { + "items": { + "$ref": "#/definitions/EpiphanyAcceptanceReceipt" + }, + "type": "array" + }, + "activeSubgoalId": { + "type": [ + "string", + "null" + ] + }, + "churn": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyChurnState" + }, + { + "type": "null" + } + ] + }, + "evidence": { + "items": { + "$ref": "#/definitions/EpiphanyEvidenceRecord" + }, + "type": "array" + }, + "graphCheckpoint": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyGraphCheckpoint" + }, + { + "type": "null" + } + ] + }, + "graphFrontier": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyGraphFrontier" + }, + { + "type": "null" + } + ] + }, + "graphs": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyGraphs" + }, + { + "type": "null" + } + ] + }, + "invariants": { + "items": { + "$ref": "#/definitions/EpiphanyInvariant" + }, + "type": [ + "array", + "null" + ] + }, + "investigationCheckpoint": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyInvestigationCheckpoint" + }, + { + "type": "null" + } + ] + }, + "jobBindings": { + "items": { + "$ref": "#/definitions/EpiphanyJobBinding" + }, + "type": [ + "array", + "null" + ] + }, + "mode": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyModeState" + }, + { + "type": "null" + } + ] + }, + "objective": { + "type": [ + "string", + "null" + ] + }, + "observations": { + "items": { + "$ref": "#/definitions/EpiphanyObservation" + }, + "type": "array" + }, + "planning": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyPlanningState" + }, + { + "type": "null" + } + ] + }, + "runtimeLinks": { + "items": { + "$ref": "#/definitions/EpiphanyRuntimeLink" + }, + "type": "array" + }, + "scratch": { + "anyOf": [ + { + "$ref": "#/definitions/EpiphanyScratchPad" + }, + { + "type": "null" + } + ] + }, + "subgoals": { + "items": { + "$ref": "#/definitions/EpiphanySubgoal" + }, + "type": [ + "array", + "null" + ] + } + }, + "type": "object" + }, + "ThreadEpiphanyViewCoordinator": { + "properties": { + "action": { + "$ref": "#/definitions/ThreadEpiphanyCoordinatorAction" + }, + "canAutoRun": { + "type": "boolean" + }, + "note": { + "type": "string" + }, + "reason": { + "type": "string" + }, + "recommendedSceneAction": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanySceneAction" + }, + { + "type": "null" + } + ] + }, + "requiresReview": { + "type": "boolean" + }, + "roles": { + "items": { + "$ref": "#/definitions/ThreadEpiphanyRoleLane" + }, + "type": "array" + }, + "source": { + "$ref": "#/definitions/ThreadEpiphanyRolesSource" + }, + "sourceSignals": { + "$ref": "#/definitions/ThreadEpiphanyCoordinatorSignals" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "stateStatus": { + "$ref": "#/definitions/ThreadEpiphanyReorientStateStatus" + }, + "targetRole": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanyRoleId" + }, + { + "type": "null" + } + ] + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "action", + "canAutoRun", + "note", + "reason", + "requiresReview", + "roles", + "source", + "sourceSignals", + "stateStatus", + "threadId" + ], + "type": "object" + }, + "ThreadEpiphanyViewCrrc": { + "properties": { + "availableActions": { + "items": { + "$ref": "#/definitions/ThreadEpiphanySceneAction" + }, + "type": "array" + }, + "decision": { + "$ref": "#/definitions/ThreadEpiphanyReorientDecision" + }, + "note": { + "type": "string" + }, + "pressure": { + "$ref": "#/definitions/ThreadEpiphanyPressure" + }, + "recommendation": { + "$ref": "#/definitions/ThreadEpiphanyCrrcRecommendation" + }, + "reorientBindingId": { + "type": "string" + }, + "reorientFinding": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanyReorientFinding" + }, + { + "type": "null" + } + ] + }, + "reorientJob": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadEpiphanyJob" + }, + { + "type": "null" + } + ] + }, + "reorientResultStatus": { + "$ref": "#/definitions/ThreadEpiphanyReorientResultStatus" + }, + "source": { + "$ref": "#/definitions/ThreadEpiphanyReorientSource" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "stateStatus": { + "$ref": "#/definitions/ThreadEpiphanyReorientStateStatus" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "decision", + "note", + "pressure", + "recommendation", + "reorientBindingId", + "reorientResultStatus", + "source", + "stateStatus", + "threadId" + ], + "type": "object" + }, + "ThreadEpiphanyViewLens": { + "enum": [ + "scene", + "jobs", + "roles", + "planning", + "pressure", + "reorient", + "crrc", + "coordinator" + ], + "type": "string" + }, + "ThreadEpiphanyViewPlanning": { + "properties": { + "planning": { + "$ref": "#/definitions/EpiphanyPlanningState" + }, + "source": { + "$ref": "#/definitions/ThreadEpiphanyContextSource" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "stateStatus": { + "$ref": "#/definitions/ThreadEpiphanyContextStateStatus" + }, + "summary": { + "$ref": "#/definitions/ThreadEpiphanyPlanningSummary" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "planning", + "source", + "stateStatus", + "summary", + "threadId" + ], + "type": "object" + }, + "ThreadEpiphanyViewReorient": { + "properties": { + "decision": { + "$ref": "#/definitions/ThreadEpiphanyReorientDecision" + }, + "source": { + "$ref": "#/definitions/ThreadEpiphanyReorientSource" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "stateStatus": { + "$ref": "#/definitions/ThreadEpiphanyReorientStateStatus" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "decision", + "source", + "stateStatus", + "threadId" + ], + "type": "object" + }, + "ThreadEpiphanyViewRoles": { + "properties": { + "note": { + "type": "string" + }, + "roles": { + "items": { + "$ref": "#/definitions/ThreadEpiphanyRoleLane" + }, + "type": "array" + }, + "source": { + "$ref": "#/definitions/ThreadEpiphanyRolesSource" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "stateStatus": { + "$ref": "#/definitions/ThreadEpiphanyReorientStateStatus" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "note", + "roles", + "source", + "stateStatus", + "threadId" + ], + "type": "object" + }, + "ThreadForkParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", + "properties": { + "approvalPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/AskForApproval" + }, + { + "type": "null" + } + ] + }, + "approvalsReviewer": { + "anyOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + }, + { + "type": "null" + } + ], + "description": "Override where approval requests are routed for review on this thread and subsequent turns." + }, + "baseInstructions": { + "type": [ + "string", + "null" + ] + }, + "config": { + "additionalProperties": true, + "type": [ + "object", + "null" + ] + }, + "cwd": { + "type": [ + "string", + "null" + ] + }, + "developerInstructions": { + "type": [ + "string", + "null" + ] + }, + "ephemeral": { + "type": "boolean" + }, + "model": { + "description": "Configuration overrides for the forked thread, if any.", + "type": [ + "string", + "null" + ] + }, + "modelProvider": { + "type": [ + "string", + "null" + ] + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Full permissions override for the forked thread. Cannot be combined with `sandbox`." + }, + "sandbox": { + "anyOf": [ + { + "$ref": "#/definitions/SandboxMode" + }, + { + "type": "null" + } + ] + }, + "serviceTier": { + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "type": "null" + } + ] + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadForkParams", + "type": "object" + }, + "ThreadForkResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "approvalPolicy": { + "$ref": "#/definitions/AskForApproval" + }, + "approvalsReviewer": { + "allOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + } + ], + "description": "Reviewer currently used for approval requests on this thread." + }, + "cwd": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "instructionSources": { + "default": [], + "description": "Instruction source files currently loaded for this thread.", + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": "array" + }, + "model": { + "type": "string" + }, + "modelProvider": { + "type": "string" + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "default": null, + "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`." + }, + "reasoningEffort": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningEffort" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "allOf": [ + { + "$ref": "#/definitions/SandboxPolicy" + } + ], + "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view." + }, + "serviceTier": { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "approvalPolicy", + "approvalsReviewer", + "cwd", + "model", + "modelProvider", + "sandbox", + "thread" + ], + "title": "ThreadForkResponse", + "type": "object" + }, + "ThreadId": { + "type": "string" + }, + "ThreadInjectItemsParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "items": { + "description": "Raw Responses API items to append to the thread's model-visible history.", + "items": true, + "type": "array" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "items", + "threadId" + ], + "title": "ThreadInjectItemsParams", + "type": "object" + }, + "ThreadInjectItemsResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadInjectItemsResponse", + "type": "object" + }, + "ThreadItem": { + "oneOf": [ + { + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, + "required": [ + "content", + "id", + "type" + ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { + "properties": { + "fragments": { + "items": { + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "hookPrompt" + ], + "title": "HookPromptThreadItemType", + "type": "string" + } + }, + "required": [ + "fragments", + "id", + "type" + ], + "title": "HookPromptThreadItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "memoryCitation": { + "anyOf": [ + { + "$ref": "#/definitions/MemoryCitation" + }, + { + "type": "null" + } + ], + "default": null + }, + "phase": { + "anyOf": [ + { + "$ref": "#/definitions/MessagePhase" + }, + { + "type": "null" + } + ], + "default": null + }, + "text": { + "type": "string" + }, + "type": { + "enum": [ + "agentMessage" + ], + "title": "AgentMessageThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "text", + "type" + ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", + "properties": { + "id": { + "type": "string" + }, + "text": { + "type": "string" + }, + "type": { + "enum": [ + "plan" + ], + "title": "PlanThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "text", + "type" + ], + "title": "PlanThreadItem", + "type": "object" + }, + { + "properties": { + "content": { + "default": [], + "items": { + "type": "string" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "summary": { + "default": [], + "items": { + "type": "string" + }, + "type": "array" + }, + "type": { + "enum": [ + "reasoning" + ], + "title": "ReasoningThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "type" + ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { + "properties": { + "aggregatedOutput": { + "description": "The command's output, aggregated from stdout and stderr.", + "type": [ + "string", + "null" + ] + }, + "command": { + "description": "The command to be executed.", + "type": "string" + }, + "commandActions": { + "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", + "items": { + "$ref": "#/definitions/CommandAction" + }, + "type": "array" + }, + "cwd": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "The command's working directory." + }, + "durationMs": { + "description": "The duration of the command execution in milliseconds.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "exitCode": { + "description": "The command's exit code.", + "format": "int32", + "type": [ + "integer", + "null" + ] + }, + "id": { + "type": "string" + }, + "processId": { + "description": "Identifier for the underlying PTY process (when available).", + "type": [ + "string", + "null" + ] + }, + "source": { + "allOf": [ + { + "$ref": "#/definitions/CommandExecutionSource" + } + ], + "default": "agent" + }, + "status": { + "$ref": "#/definitions/CommandExecutionStatus" + }, + "type": { + "enum": [ + "commandExecution" + ], + "title": "CommandExecutionThreadItemType", + "type": "string" + } + }, + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { + "properties": { + "changes": { + "items": { + "$ref": "#/definitions/FileUpdateChange" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "status": { + "$ref": "#/definitions/PatchApplyStatus" + }, + "type": { + "enum": [ + "fileChange" + ], + "title": "FileChangeThreadItemType", + "type": "string" + } + }, + "required": [ + "changes", + "id", + "status", + "type" + ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { + "properties": { + "arguments": true, + "durationMs": { + "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "error": { + "anyOf": [ + { + "$ref": "#/definitions/McpToolCallError" + }, + { + "type": "null" + } + ] + }, + "id": { + "type": "string" + }, + "mcpAppResourceUri": { + "type": [ + "string", + "null" + ] + }, + "result": { + "anyOf": [ + { + "$ref": "#/definitions/McpToolCallResult" + }, + { + "type": "null" + } + ] + }, + "server": { + "type": "string" + }, + "status": { + "$ref": "#/definitions/McpToolCallStatus" + }, + "tool": { + "type": "string" + }, + "type": { + "enum": [ + "mcpToolCall" + ], + "title": "McpToolCallThreadItemType", + "type": "string" + } + }, + "required": [ + "arguments", + "id", + "server", + "status", + "tool", + "type" + ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { + "properties": { + "arguments": true, + "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, + "type": [ + "array", + "null" + ] + }, + "durationMs": { + "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "id": { + "type": "string" + }, + "namespace": { + "type": [ + "string", + "null" + ] + }, + "status": { + "$ref": "#/definitions/DynamicToolCallStatus" + }, + "success": { + "type": [ + "boolean", + "null" + ] + }, + "tool": { + "type": "string" + }, + "type": { + "enum": [ + "dynamicToolCall" + ], + "title": "DynamicToolCallThreadItemType", + "type": "string" + } + }, + "required": [ + "arguments", + "id", + "status", + "tool", + "type" + ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { + "properties": { + "agentsStates": { + "additionalProperties": { + "$ref": "#/definitions/CollabAgentState" + }, + "description": "Last known status of the target agents, when available.", + "type": "object" + }, + "id": { + "description": "Unique identifier for this collab tool call.", + "type": "string" + }, + "model": { + "description": "Model requested for the spawned agent, when applicable.", + "type": [ + "string", + "null" + ] + }, + "prompt": { + "description": "Prompt text sent as part of the collab tool call, when available.", + "type": [ + "string", + "null" + ] + }, + "reasoningEffort": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningEffort" + }, + { + "type": "null" + } + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." + }, + "receiverThreadIds": { + "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", + "items": { + "type": "string" + }, + "type": "array" + }, + "senderThreadId": { + "description": "Thread ID of the agent issuing the collab request.", + "type": "string" + }, + "status": { + "allOf": [ + { + "$ref": "#/definitions/CollabAgentToolCallStatus" + } + ], + "description": "Current status of the collab tool call." + }, + "tool": { + "allOf": [ + { + "$ref": "#/definitions/CollabAgentTool" + } + ], + "description": "Name of the collab tool that was invoked." + }, + "type": { + "enum": [ + "collabAgentToolCall" + ], + "title": "CollabAgentToolCallThreadItemType", + "type": "string" + } + }, + "required": [ + "agentsStates", + "id", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", + "type" + ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { + "properties": { + "action": { + "anyOf": [ + { + "$ref": "#/definitions/WebSearchAction" + }, + { + "type": "null" + } + ] + }, + "id": { + "type": "string" + }, + "query": { + "type": "string" + }, + "type": { + "enum": [ + "webSearch" + ], + "title": "WebSearchThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "query", + "type" + ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "path": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": { + "enum": [ + "imageView" + ], + "title": "ImageViewThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "path", + "type" + ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "result": { + "type": "string" + }, + "revisedPrompt": { + "type": [ + "string", + "null" + ] + }, + "savedPath": { + "anyOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + }, + { + "type": "null" + } + ] + }, + "status": { + "type": "string" + }, + "type": { + "enum": [ + "imageGeneration" + ], + "title": "ImageGenerationThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "result", + "status", + "type" + ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "review": { + "type": "string" + }, + "type": { + "enum": [ + "enteredReviewMode" + ], + "title": "EnteredReviewModeThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "review", + "type" + ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "review": { + "type": "string" + }, + "type": { + "enum": [ + "exitedReviewMode" + ], + "title": "ExitedReviewModeThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "review", + "type" + ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "type": { + "enum": [ + "contextCompaction" + ], + "title": "ContextCompactionThreadItemType", + "type": "string" + } + }, + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" + } + ] + }, + "ThreadListCwdFilter": { + "anyOf": [ + { + "type": "string" + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + }, + "ThreadListParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "archived": { + "description": "Optional archived filter; when set to true, only archived threads are returned. If false or null, only non-archived threads are returned.", + "type": [ + "boolean", + "null" + ] + }, + "cursor": { + "description": "Opaque pagination cursor returned by a previous call.", + "type": [ + "string", + "null" + ] + }, + "cwd": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadListCwdFilter" + }, + { + "type": "null" + } + ], + "description": "Optional cwd filter or filters; when set, only threads whose session cwd exactly matches one of these paths are returned." + }, + "limit": { + "description": "Optional page size; defaults to a reasonable server-side value.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "modelProviders": { + "description": "Optional provider filter; when set, only sessions recorded under these providers are returned. When present but empty, includes all providers.", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "searchTerm": { + "description": "Optional substring filter for the extracted thread title.", + "type": [ + "string", + "null" + ] + }, + "sortDirection": { + "anyOf": [ + { + "$ref": "#/definitions/SortDirection" + }, + { + "type": "null" + } + ], + "description": "Optional sort direction; defaults to descending (newest first)." + }, + "sortKey": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadSortKey" + }, + { + "type": "null" + } + ], + "description": "Optional sort key; defaults to created_at." + }, + "sourceKinds": { + "description": "Optional source filter; when set, only sessions from these source kinds are returned. When omitted or empty, defaults to interactive sources.", + "items": { + "$ref": "#/definitions/ThreadSourceKind" + }, + "type": [ + "array", + "null" + ] + }, + "useStateDbOnly": { + "description": "If true, return from the state DB without scanning JSONL rollouts to repair thread metadata. Omitted or false preserves scan-and-repair behavior.", + "type": "boolean" + } + }, + "title": "ThreadListParams", + "type": "object" + }, + "ThreadListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "backwardsCursor": { + "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one thread. Use it with the opposite `sortDirection`; for timestamp sorts it anchors at the start of the page timestamp so same-second updates are not skipped.", + "type": [ + "string", + "null" + ] + }, + "data": { + "items": { + "$ref": "#/definitions/Thread" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ThreadListResponse", + "type": "object" + }, + "ThreadLoadedListParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cursor": { + "description": "Opaque pagination cursor returned by a previous call.", + "type": [ + "string", + "null" + ] + }, + "limit": { + "description": "Optional page size; defaults to no limit.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "title": "ThreadLoadedListParams", + "type": "object" + }, + "ThreadLoadedListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "data": { + "description": "Thread ids for sessions currently loaded in memory.", + "items": { + "type": "string" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ThreadLoadedListResponse", + "type": "object" + }, + "ThreadMemoryMode": { + "enum": [ + "enabled", + "disabled" + ], + "type": "string" + }, + "ThreadMetadataGitInfoUpdateParams": { + "properties": { + "branch": { + "description": "Omit to leave the stored branch unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", + "type": [ + "string", + "null" + ] + }, + "originUrl": { + "description": "Omit to leave the stored origin URL unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", + "type": [ + "string", + "null" + ] + }, + "sha": { + "description": "Omit to leave the stored commit unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "ThreadMetadataUpdateParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "gitInfo": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadMetadataGitInfoUpdateParams" + }, + { + "type": "null" + } + ], + "description": "Patch the stored Git metadata for this thread. Omit a field to leave it unchanged, set it to `null` to clear it, or provide a string to replace the stored value." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadMetadataUpdateParams", + "type": "object" + }, + "ThreadMetadataUpdateResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "thread" + ], + "title": "ThreadMetadataUpdateResponse", + "type": "object" + }, + "ThreadNameUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + }, + "threadName": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "threadId" + ], + "title": "ThreadNameUpdatedNotification", + "type": "object" + }, + "ThreadReadParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "includeTurns": { + "default": false, + "description": "When true, include turns and their items from rollout history.", + "type": "boolean" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadReadParams", + "type": "object" + }, + "ThreadReadResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "thread" + ], + "title": "ThreadReadResponse", + "type": "object" + }, + "ThreadRealtimeAudioChunk": { + "description": "EXPERIMENTAL - thread realtime audio chunk.", + "properties": { + "data": { + "type": "string" + }, + "itemId": { + "type": [ + "string", + "null" + ] + }, + "numChannels": { + "format": "uint16", + "minimum": 0.0, + "type": "integer" + }, + "sampleRate": { + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "samplesPerChannel": { + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "data", + "numChannels", + "sampleRate" + ], + "type": "object" + }, + "ThreadRealtimeClosedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - emitted when thread realtime transport closes.", + "properties": { + "reason": { + "type": [ + "string", + "null" + ] + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadRealtimeClosedNotification", + "type": "object" + }, + "ThreadRealtimeErrorNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - emitted when thread realtime encounters an error.", + "properties": { + "message": { + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "message", + "threadId" + ], + "title": "ThreadRealtimeErrorNotification", + "type": "object" + }, + "ThreadRealtimeItemAddedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - raw non-audio thread realtime item emitted by the backend.", + "properties": { + "item": true, + "threadId": { + "type": "string" + } + }, + "required": [ + "item", + "threadId" + ], + "title": "ThreadRealtimeItemAddedNotification", + "type": "object" + }, + "ThreadRealtimeOutputAudioDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - streamed output audio emitted by thread realtime.", + "properties": { + "audio": { + "$ref": "#/definitions/ThreadRealtimeAudioChunk" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "audio", + "threadId" + ], + "title": "ThreadRealtimeOutputAudioDeltaNotification", + "type": "object" + }, + "ThreadRealtimeSdpNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - emitted with the remote SDP for a WebRTC realtime session.", + "properties": { + "sdp": { + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "sdp", + "threadId" + ], + "title": "ThreadRealtimeSdpNotification", + "type": "object" + }, + "ThreadRealtimeStartTransport": { + "description": "EXPERIMENTAL - transport used by thread realtime.", + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "websocket" + ], + "title": "WebsocketThreadRealtimeStartTransportType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "WebsocketThreadRealtimeStartTransport", + "type": "object" + }, + { + "properties": { + "sdp": { + "description": "SDP offer generated by a WebRTC RTCPeerConnection after configuring audio and the realtime events data channel.", + "type": "string" + }, + "type": { + "enum": [ + "webrtc" + ], + "title": "WebrtcThreadRealtimeStartTransportType", + "type": "string" + } + }, + "required": [ + "sdp", + "type" + ], + "title": "WebrtcThreadRealtimeStartTransport", + "type": "object" + } + ] + }, + "ThreadRealtimeStartedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - emitted when thread realtime startup is accepted.", + "properties": { + "sessionId": { + "type": [ + "string", + "null" + ] + }, + "threadId": { + "type": "string" + }, + "version": { + "$ref": "#/definitions/RealtimeConversationVersion" + } + }, + "required": [ + "threadId", + "version" + ], + "title": "ThreadRealtimeStartedNotification", + "type": "object" + }, + "ThreadRealtimeTranscriptDeltaNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - flat transcript delta emitted whenever realtime transcript text changes.", + "properties": { + "delta": { + "description": "Live transcript delta from the realtime event.", + "type": "string" + }, + "role": { + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "delta", + "role", + "threadId" + ], + "title": "ThreadRealtimeTranscriptDeltaNotification", + "type": "object" + }, + "ThreadRealtimeTranscriptDoneNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "EXPERIMENTAL - final transcript text emitted when realtime completes a transcript part.", + "properties": { + "role": { + "type": "string" + }, + "text": { + "description": "Final complete text for the transcript part.", + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "role", + "text", + "threadId" + ], + "title": "ThreadRealtimeTranscriptDoneNotification", + "type": "object" + }, + "ThreadResumeParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", + "properties": { + "approvalPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/AskForApproval" + }, + { + "type": "null" + } + ] + }, + "approvalsReviewer": { + "anyOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + }, + { + "type": "null" + } + ], + "description": "Override where approval requests are routed for review on this thread and subsequent turns." + }, + "baseInstructions": { + "type": [ + "string", + "null" + ] + }, + "config": { + "additionalProperties": true, + "type": [ + "object", + "null" + ] + }, + "cwd": { + "type": [ + "string", + "null" + ] + }, + "developerInstructions": { + "type": [ + "string", + "null" + ] + }, + "model": { + "description": "Configuration overrides for the resumed thread, if any.", + "type": [ + "string", + "null" + ] + }, + "modelProvider": { + "type": [ + "string", + "null" + ] + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Full permissions override for the resumed thread. Cannot be combined with `sandbox`." + }, + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/Personality" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "anyOf": [ + { + "$ref": "#/definitions/SandboxMode" + }, + { + "type": "null" + } + ] + }, + "serviceTier": { + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "type": "null" + } + ] + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadResumeParams", + "type": "object" + }, + "ThreadResumeResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "approvalPolicy": { + "$ref": "#/definitions/AskForApproval" + }, + "approvalsReviewer": { + "allOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + } + ], + "description": "Reviewer currently used for approval requests on this thread." + }, + "cwd": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "instructionSources": { + "default": [], + "description": "Instruction source files currently loaded for this thread.", + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": "array" + }, + "model": { + "type": "string" + }, + "modelProvider": { + "type": "string" + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "default": null, + "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`." + }, + "reasoningEffort": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningEffort" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "allOf": [ + { + "$ref": "#/definitions/SandboxPolicy" + } + ], + "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view." + }, + "serviceTier": { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "approvalPolicy", + "approvalsReviewer", + "cwd", + "model", + "modelProvider", + "sandbox", + "thread" + ], + "title": "ThreadResumeResponse", + "type": "object" + }, + "ThreadRollbackParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "numTurns": { + "description": "The number of turns to drop from the end of the thread. Must be >= 1.\n\nThis only modifies the thread's history and does not revert local file changes that have been made by the agent. Clients are responsible for reverting these changes.", + "format": "uint32", + "minimum": 0.0, + "type": "integer" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "numTurns", + "threadId" + ], + "title": "ThreadRollbackParams", + "type": "object" + }, + "ThreadRollbackResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "thread": { + "allOf": [ + { + "$ref": "#/definitions/Thread" + } + ], + "description": "The updated thread after applying the rollback, with `turns` populated.\n\nThe ThreadItems stored in each Turn are lossy since we explicitly do not persist all agent interactions, such as command executions. This is the same behavior as `thread/resume`." + } + }, + "required": [ + "thread" + ], + "title": "ThreadRollbackResponse", + "type": "object" + }, + "ThreadSetNameParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "name": { + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "name", + "threadId" + ], + "title": "ThreadSetNameParams", + "type": "object" + }, + "ThreadSetNameResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadSetNameResponse", + "type": "object" + }, + "ThreadShellCommandParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "command": { + "description": "Shell command string evaluated by the thread's configured shell. Unlike `command/exec`, this intentionally preserves shell syntax such as pipes, redirects, and quoting. This runs unsandboxed with full access rather than inheriting the thread sandbox policy.", + "type": "string" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "command", + "threadId" + ], + "title": "ThreadShellCommandParams", + "type": "object" + }, + "ThreadShellCommandResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadShellCommandResponse", + "type": "object" + }, + "ThreadSortKey": { + "enum": [ + "created_at", + "updated_at" + ], + "type": "string" + }, + "ThreadSourceKind": { + "enum": [ + "cli", + "vscode", + "exec", + "appServer", + "subAgent", + "subAgentReview", + "subAgentCompact", + "subAgentThreadSpawn", + "subAgentOther", + "unknown" + ], + "type": "string" + }, + "ThreadStartParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "approvalPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/AskForApproval" + }, + { + "type": "null" + } + ] + }, + "approvalsReviewer": { + "anyOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + }, + { + "type": "null" + } + ], + "description": "Override where approval requests are routed for review on this thread and subsequent turns." + }, + "baseInstructions": { + "type": [ + "string", + "null" + ] + }, + "config": { + "additionalProperties": true, + "type": [ + "object", + "null" + ] + }, + "cwd": { + "type": [ + "string", + "null" + ] + }, + "developerInstructions": { + "type": [ + "string", + "null" + ] + }, + "ephemeral": { + "type": [ + "boolean", + "null" + ] + }, + "model": { + "type": [ + "string", + "null" + ] + }, + "modelProvider": { + "type": [ + "string", + "null" + ] + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Full permissions override for this thread. Cannot be combined with `sandbox`." + }, + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/Personality" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "anyOf": [ + { + "$ref": "#/definitions/SandboxMode" + }, + { + "type": "null" + } + ] + }, + "serviceName": { + "type": [ + "string", + "null" + ] + }, + "serviceTier": { + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "type": "null" + } + ] + }, + "sessionStartSource": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadStartSource" + }, + { + "type": "null" + } + ] + } + }, + "title": "ThreadStartParams", + "type": "object" + }, + "ThreadStartResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "approvalPolicy": { + "$ref": "#/definitions/AskForApproval" + }, + "approvalsReviewer": { + "allOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + } + ], + "description": "Reviewer currently used for approval requests on this thread." + }, + "cwd": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "instructionSources": { + "default": [], + "description": "Instruction source files currently loaded for this thread.", + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": "array" + }, + "model": { + "type": "string" + }, + "modelProvider": { + "type": "string" + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "default": null, + "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`." + }, + "reasoningEffort": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningEffort" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "allOf": [ + { + "$ref": "#/definitions/SandboxPolicy" + } + ], + "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view." + }, + "serviceTier": { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "approvalPolicy", + "approvalsReviewer", + "cwd", + "model", + "modelProvider", + "sandbox", + "thread" + ], + "title": "ThreadStartResponse", + "type": "object" + }, + "ThreadStartSource": { + "enum": [ + "startup", + "clear" + ], + "type": "string" + }, + "ThreadStartedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "thread" + ], + "title": "ThreadStartedNotification", + "type": "object" + }, + "ThreadStatus": { + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "notLoaded" + ], + "title": "NotLoadedThreadStatusType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "idle" + ], + "title": "IdleThreadStatusType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "IdleThreadStatus", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "systemError" + ], + "title": "SystemErrorThreadStatusType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" + }, + { + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, + "required": [ + "activeFlags", + "type" + ], + "title": "ActiveThreadStatus", + "type": "object" + } + ] + }, + "ThreadStatusChangedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "status": { + "$ref": "#/definitions/ThreadStatus" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "status", + "threadId" + ], + "title": "ThreadStatusChangedNotification", + "type": "object" + }, + "ThreadTokenUsage": { + "properties": { + "last": { + "$ref": "#/definitions/TokenUsageBreakdown" + }, + "modelAutoCompactTokenLimit": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "modelContextWindow": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "total": { + "$ref": "#/definitions/TokenUsageBreakdown" + } + }, + "required": [ + "last", + "total" + ], + "type": "object" + }, + "ThreadTokenUsageUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + }, + "tokenUsage": { + "$ref": "#/definitions/ThreadTokenUsage" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "threadId", + "tokenUsage", + "turnId" + ], + "title": "ThreadTokenUsageUpdatedNotification", + "type": "object" + }, + "ThreadTurnsListParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "cursor": { + "description": "Opaque cursor to pass to the next call to continue after the last turn.", + "type": [ + "string", + "null" + ] + }, + "limit": { + "description": "Optional turn page size.", + "format": "uint32", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "sortDirection": { + "anyOf": [ + { + "$ref": "#/definitions/SortDirection" + }, + { + "type": "null" + } + ], + "description": "Optional turn pagination direction; defaults to descending." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadTurnsListParams", + "type": "object" + }, + "ThreadTurnsListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "backwardsCursor": { + "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one turn. Use it with the opposite `sortDirection` to include the anchor turn again and catch updates to that turn.", + "type": [ + "string", + "null" + ] + }, + "data": { + "items": { + "$ref": "#/definitions/Turn" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last turn. if None, there are no more turns to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ThreadTurnsListResponse", + "type": "object" + }, + "ThreadUnarchiveParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadUnarchiveParams", + "type": "object" + }, + "ThreadUnarchiveResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "thread" + ], + "title": "ThreadUnarchiveResponse", + "type": "object" + }, + "ThreadUnarchivedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadUnarchivedNotification", + "type": "object" + }, + "ThreadUnsubscribeParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadUnsubscribeParams", + "type": "object" + }, + "ThreadUnsubscribeResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "status": { + "$ref": "#/definitions/ThreadUnsubscribeStatus" + } + }, + "required": [ + "status" + ], + "title": "ThreadUnsubscribeResponse", + "type": "object" + }, + "ThreadUnsubscribeStatus": { + "enum": [ + "notLoaded", + "notSubscribed", + "unsubscribed" + ], + "type": "string" + }, + "TokenUsageBreakdown": { + "properties": { + "cachedInputTokens": { + "format": "int64", + "type": "integer" + }, + "inputTokens": { + "format": "int64", + "type": "integer" + }, + "outputTokens": { + "format": "int64", + "type": "integer" + }, + "reasoningOutputTokens": { + "format": "int64", + "type": "integer" + }, + "totalTokens": { + "format": "int64", + "type": "integer" + } + }, + "required": [ + "cachedInputTokens", + "inputTokens", + "outputTokens", + "reasoningOutputTokens", + "totalTokens" + ], + "type": "object" + }, + "Tool": { + "description": "Definition for a tool the client can call.", + "properties": { + "_meta": true, + "annotations": true, + "description": { + "type": [ + "string", + "null" + ] + }, + "icons": { + "items": true, + "type": [ + "array", + "null" + ] + }, + "inputSchema": true, + "name": { + "type": "string" + }, + "outputSchema": true, + "title": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "inputSchema", + "name" + ], + "type": "object" }, "ToolsV2": { - "type": "object", "properties": { "view_image": { "type": [ @@ -13743,27 +16213,670 @@ } ] } - } + }, + "type": "object" + }, + "Turn": { + "properties": { + "completedAt": { + "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "durationMs": { + "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "error": { + "anyOf": [ + { + "$ref": "#/definitions/TurnError" + }, + { + "type": "null" + } + ], + "description": "Only populated when the Turn's status is failed." + }, + "id": { + "type": "string" + }, + "items": { + "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", + "items": { + "$ref": "#/definitions/ThreadItem" + }, + "type": "array" + }, + "startedAt": { + "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "status": { + "$ref": "#/definitions/TurnStatus" + } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" + }, + "TurnCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + }, + "turn": { + "$ref": "#/definitions/Turn" + } + }, + "required": [ + "threadId", + "turn" + ], + "title": "TurnCompletedNotification", + "type": "object" + }, + "TurnDiffUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "description": "Notification that the turn-level unified diff has changed. Contains the latest aggregated diff across all file changes in the turn.", + "properties": { + "diff": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "diff", + "threadId", + "turnId" + ], + "title": "TurnDiffUpdatedNotification", + "type": "object" + }, + "TurnEnvironmentParams": { + "properties": { + "cwd": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "environmentId": { + "type": "string" + } + }, + "required": [ + "cwd", + "environmentId" + ], + "type": "object" + }, + "TurnError": { + "properties": { + "additionalDetails": { + "default": null, + "type": [ + "string", + "null" + ] + }, + "codexErrorInfo": { + "anyOf": [ + { + "$ref": "#/definitions/CodexErrorInfo" + }, + { + "type": "null" + } + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "message" + ], + "type": "object" + }, + "TurnInterruptParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "threadId", + "turnId" + ], + "title": "TurnInterruptParams", + "type": "object" + }, + "TurnInterruptResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "TurnInterruptResponse", + "type": "object" + }, + "TurnPlanStep": { + "properties": { + "status": { + "$ref": "#/definitions/TurnPlanStepStatus" + }, + "step": { + "type": "string" + } + }, + "required": [ + "status", + "step" + ], + "type": "object" + }, + "TurnPlanStepStatus": { + "enum": [ + "pending", + "inProgress", + "completed" + ], + "type": "string" + }, + "TurnPlanUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "explanation": { + "type": [ + "string", + "null" + ] + }, + "plan": { + "items": { + "$ref": "#/definitions/TurnPlanStep" + }, + "type": "array" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "plan", + "threadId", + "turnId" + ], + "title": "TurnPlanUpdatedNotification", + "type": "object" + }, + "TurnStartParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "approvalPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/AskForApproval" + }, + { + "type": "null" + } + ], + "description": "Override the approval policy for this turn and subsequent turns." + }, + "approvalsReviewer": { + "anyOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + }, + { + "type": "null" + } + ], + "description": "Override where approval requests are routed for review on this turn and subsequent turns." + }, + "cwd": { + "description": "Override the working directory for this turn and subsequent turns.", + "type": [ + "string", + "null" + ] + }, + "effort": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningEffort" + }, + { + "type": "null" + } + ], + "description": "Override the reasoning effort for this turn and subsequent turns." + }, + "input": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "model": { + "description": "Override the model for this turn and subsequent turns.", + "type": [ + "string", + "null" + ] + }, + "outputSchema": { + "description": "Optional JSON Schema used to constrain the final assistant message for this turn." + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Override the full permissions profile for this turn and subsequent turns. Cannot be combined with `sandboxPolicy`." + }, + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/Personality" + }, + { + "type": "null" + } + ], + "description": "Override the personality for this turn and subsequent turns." + }, + "sandboxPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/SandboxPolicy" + }, + { + "type": "null" + } + ], + "description": "Override the sandbox policy for this turn and subsequent turns." + }, + "serviceTier": { + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "type": "null" + } + ], + "description": "Override the service tier for this turn and subsequent turns." + }, + "summary": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningSummary" + }, + { + "type": "null" + } + ], + "description": "Override the reasoning summary for this turn and subsequent turns." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "input", + "threadId" + ], + "title": "TurnStartParams", + "type": "object" + }, + "TurnStartResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "turn": { + "$ref": "#/definitions/Turn" + } + }, + "required": [ + "turn" + ], + "title": "TurnStartResponse", + "type": "object" + }, + "TurnStartedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "threadId": { + "type": "string" + }, + "turn": { + "$ref": "#/definitions/Turn" + } + }, + "required": [ + "threadId", + "turn" + ], + "title": "TurnStartedNotification", + "type": "object" + }, + "TurnStatus": { + "enum": [ + "completed", + "interrupted", + "failed", + "inProgress" + ], + "type": "string" + }, + "TurnSteerParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "expectedTurnId": { + "description": "Required active turn id precondition. The request fails when it does not match the currently active turn.", + "type": "string" + }, + "input": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "expectedTurnId", + "input", + "threadId" + ], + "title": "TurnSteerParams", + "type": "object" + }, + "TurnSteerResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "turnId": { + "type": "string" + } + }, + "required": [ + "turnId" + ], + "title": "TurnSteerResponse", + "type": "object" + }, + "UserInput": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "text_elements": { + "default": [], + "description": "UI-defined spans within `text` used to render or persist special elements.", + "items": { + "$ref": "#/definitions/TextElement" + }, + "type": "array" + }, + "type": { + "enum": [ + "text" + ], + "title": "TextUserInputType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "image" + ], + "title": "ImageUserInputType", + "type": "string" + }, + "url": { + "type": "string" + } + }, + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" + }, + { + "properties": { + "path": { + "type": "string" + }, + "type": { + "enum": [ + "localImage" + ], + "title": "LocalImageUserInputType", + "type": "string" + } + }, + "required": [ + "path", + "type" + ], + "title": "LocalImageUserInput", + "type": "object" + }, + { + "properties": { + "name": { + "type": "string" + }, + "path": { + "type": "string" + }, + "type": { + "enum": [ + "mention" + ], + "title": "MentionUserInputType", + "type": "string" + } + }, + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" + } + ] }, "Verbosity": { "description": "Controls output length/detail on GPT-5 models via the Responses API. Serialized with lowercase values to match the OpenAI API.", - "type": "string", "enum": [ "low", "medium", "high" + ], + "type": "string" + }, + "WarningNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "message": { + "description": "Concise warning message for the user.", + "type": "string" + }, + "threadId": { + "description": "Optional thread target when the warning applies to a specific thread.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "message" + ], + "title": "WarningNotification", + "type": "object" + }, + "WebSearchAction": { + "oneOf": [ + { + "properties": { + "queries": { + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "query": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "search" + ], + "title": "SearchWebSearchActionType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "openPage" + ], + "title": "OpenPageWebSearchActionType", + "type": "string" + }, + "url": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "type" + ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { + "properties": { + "pattern": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "findInPage" + ], + "title": "FindInPageWebSearchActionType", + "type": "string" + }, + "url": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "type" + ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "other" + ], + "title": "OtherWebSearchActionType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" + } ] }, "WebSearchContextSize": { - "type": "string", "enum": [ "low", "medium", "high" - ] + ], + "type": "string" }, "WebSearchLocation": { - "type": "object", + "additionalProperties": false, "properties": { "city": { "type": [ @@ -13790,27 +16903,27 @@ ] } }, - "additionalProperties": false + "type": "object" }, "WebSearchMode": { - "type": "string", "enum": [ "disabled", "cached", "live" - ] + ], + "type": "string" }, "WebSearchToolConfig": { - "type": "object", + "additionalProperties": false, "properties": { "allowed_domains": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "context_size": { "anyOf": [ @@ -13833,3676 +16946,108 @@ ] } }, - "additionalProperties": false + "type": "object" }, - "ConfigReadResponse": { + "WindowsSandboxSetupCompletedNotification": { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigReadResponse", - "type": "object", - "required": [ - "config", - "origins" - ], "properties": { - "config": { - "$ref": "#/definitions/Config" - }, - "layers": { + "error": { "type": [ - "array", + "string", "null" - ], - "items": { - "$ref": "#/definitions/ConfigLayer" - } + ] }, - "origins": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/ConfigLayerMetadata" - } + "mode": { + "$ref": "#/definitions/WindowsSandboxSetupMode" + }, + "success": { + "type": "boolean" } - } - }, - "OverriddenMetadata": { - "type": "object", + }, "required": [ - "effectiveValue", - "message", - "overridingLayer" + "mode", + "success" ], + "title": "WindowsSandboxSetupCompletedNotification", + "type": "object" + }, + "WindowsSandboxSetupMode": { + "enum": [ + "elevated", + "unelevated" + ], + "type": "string" + }, + "WindowsSandboxSetupStartParams": { + "$schema": "http://json-schema.org/draft-07/schema#", "properties": { - "effectiveValue": true, - "message": { - "type": "string" + "cwd": { + "anyOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + }, + { + "type": "null" + } + ] }, - "overridingLayer": { - "$ref": "#/definitions/ConfigLayerMetadata" + "mode": { + "$ref": "#/definitions/WindowsSandboxSetupMode" } - } + }, + "required": [ + "mode" + ], + "title": "WindowsSandboxSetupStartParams", + "type": "object" + }, + "WindowsSandboxSetupStartResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "started": { + "type": "boolean" + } + }, + "required": [ + "started" + ], + "title": "WindowsSandboxSetupStartResponse", + "type": "object" + }, + "WindowsWorldWritableWarningNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "properties": { + "extraCount": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "failedScan": { + "type": "boolean" + }, + "samplePaths": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "extraCount", + "failedScan", + "samplePaths" + ], + "title": "WindowsWorldWritableWarningNotification", + "type": "object" }, "WriteStatus": { - "type": "string", "enum": [ "ok", "okOverridden" - ] - }, - "ConfigWriteResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigWriteResponse", - "type": "object", - "required": [ - "filePath", - "status", - "version" ], - "properties": { - "filePath": { - "description": "Canonical path to the config file that was written.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - }, - "overriddenMetadata": { - "anyOf": [ - { - "$ref": "#/definitions/OverriddenMetadata" - }, - { - "type": "null" - } - ] - }, - "status": { - "$ref": "#/definitions/WriteStatus" - }, - "version": { - "type": "string" - } - } - }, - "ConfigRequirements": { - "type": "object", - "properties": { - "allowedApprovalPolicies": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/AskForApproval" - } - }, - "featureRequirements": { - "type": [ - "object", - "null" - ], - "additionalProperties": { - "type": "boolean" - } - }, - "allowedSandboxModes": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/SandboxMode" - } - }, - "allowedWebSearchModes": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/WebSearchMode" - } - }, - "enforceResidency": { - "anyOf": [ - { - "$ref": "#/definitions/ResidencyRequirement" - }, - { - "type": "null" - } - ] - } - } - }, - "NetworkDomainPermission": { - "type": "string", - "enum": [ - "allow", - "deny" - ] - }, - "NetworkRequirements": { - "type": "object", - "properties": { - "allowLocalBinding": { - "type": [ - "boolean", - "null" - ] - }, - "allowUnixSockets": { - "description": "Legacy compatibility view derived from `unix_sockets`.", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "allowUpstreamProxy": { - "type": [ - "boolean", - "null" - ] - }, - "allowedDomains": { - "description": "Legacy compatibility view derived from `domains`.", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "dangerouslyAllowAllUnixSockets": { - "type": [ - "boolean", - "null" - ] - }, - "dangerouslyAllowNonLoopbackProxy": { - "type": [ - "boolean", - "null" - ] - }, - "deniedDomains": { - "description": "Legacy compatibility view derived from `domains`.", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "domains": { - "description": "Canonical network permission map for `experimental_network`.", - "type": [ - "object", - "null" - ], - "additionalProperties": { - "$ref": "#/definitions/NetworkDomainPermission" - } - }, - "enabled": { - "type": [ - "boolean", - "null" - ] - }, - "httpPort": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - }, - "managedAllowedDomainsOnly": { - "description": "When true, only managed allowlist entries are respected while managed network enforcement is active.", - "type": [ - "boolean", - "null" - ] - }, - "socksPort": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - }, - "unixSockets": { - "description": "Canonical unix socket permission map for `experimental_network`.", - "type": [ - "object", - "null" - ], - "additionalProperties": { - "$ref": "#/definitions/NetworkUnixSocketPermission" - } - } - } - }, - "NetworkUnixSocketPermission": { - "type": "string", - "enum": [ - "allow", - "none" - ] - }, - "ResidencyRequirement": { - "type": "string", - "enum": [ - "us" - ] - }, - "ConfigRequirementsReadResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigRequirementsReadResponse", - "type": "object", - "properties": { - "requirements": { - "description": "Null if no requirements are configured (e.g. no requirements.toml/MDM entries).", - "anyOf": [ - { - "$ref": "#/definitions/ConfigRequirements" - }, - { - "type": "null" - } - ] - } - } - }, - "Account": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "apiKey" - ], - "title": "ApiKeyAccountType" - } - }, - "title": "ApiKeyAccount" - }, - { - "type": "object", - "required": [ - "email", - "planType", - "type" - ], - "properties": { - "email": { - "type": "string" - }, - "planType": { - "$ref": "#/definitions/PlanType" - }, - "type": { - "type": "string", - "enum": [ - "chatgpt" - ], - "title": "ChatgptAccountType" - } - }, - "title": "ChatgptAccount" - } - ] - }, - "GetAccountResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "GetAccountResponse", - "type": "object", - "required": [ - "requiresOpenaiAuth" - ], - "properties": { - "account": { - "anyOf": [ - { - "$ref": "#/definitions/Account" - }, - { - "type": "null" - } - ] - }, - "requiresOpenaiAuth": { - "type": "boolean" - } - } - }, - "ErrorNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ErrorNotification", - "type": "object", - "required": [ - "error", - "threadId", - "turnId", - "willRetry" - ], - "properties": { - "error": { - "$ref": "#/definitions/TurnError" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - }, - "willRetry": { - "type": "boolean" - } - } - }, - "ThreadStartedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadStartedNotification", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "$ref": "#/definitions/Thread" - } - } - }, - "ThreadStatusChangedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadStatusChangedNotification", - "type": "object", - "required": [ - "status", - "threadId" - ], - "properties": { - "status": { - "$ref": "#/definitions/ThreadStatus" - }, - "threadId": { - "type": "string" - } - } - }, - "ThreadArchivedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadArchivedNotification", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadUnarchivedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnarchivedNotification", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadClosedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadClosedNotification", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - } - } - }, - "ThreadNameUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadNameUpdatedNotification", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "threadId": { - "type": "string" - }, - "threadName": { - "type": [ - "string", - "null" - ] - } - } - }, - "ThreadTokenUsage": { - "type": "object", - "required": [ - "last", - "total" - ], - "properties": { - "last": { - "$ref": "#/definitions/TokenUsageBreakdown" - }, - "modelAutoCompactTokenLimit": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "modelContextWindow": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "total": { - "$ref": "#/definitions/TokenUsageBreakdown" - } - } - }, - "TokenUsageBreakdown": { - "type": "object", - "required": [ - "cachedInputTokens", - "inputTokens", - "outputTokens", - "reasoningOutputTokens", - "totalTokens" - ], - "properties": { - "cachedInputTokens": { - "type": "integer", - "format": "int64" - }, - "inputTokens": { - "type": "integer", - "format": "int64" - }, - "outputTokens": { - "type": "integer", - "format": "int64" - }, - "reasoningOutputTokens": { - "type": "integer", - "format": "int64" - }, - "totalTokens": { - "type": "integer", - "format": "int64" - } - } - }, - "ThreadTokenUsageUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadTokenUsageUpdatedNotification", - "type": "object", - "required": [ - "threadId", - "tokenUsage", - "turnId" - ], - "properties": { - "threadId": { - "type": "string" - }, - "tokenUsage": { - "$ref": "#/definitions/ThreadTokenUsage" - }, - "turnId": { - "type": "string" - } - } - }, - "TurnStartedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnStartedNotification", - "type": "object", - "required": [ - "threadId", - "turn" - ], - "properties": { - "threadId": { - "type": "string" - }, - "turn": { - "$ref": "#/definitions/Turn" - } - } - }, - "HookEventName": { - "type": "string", - "enum": [ - "preToolUse", - "permissionRequest", - "postToolUse", - "sessionStart", - "userPromptSubmit", - "stop" - ] - }, - "HookExecutionMode": { - "type": "string", - "enum": [ - "sync", - "async" - ] - }, - "HookHandlerType": { - "type": "string", - "enum": [ - "command", - "prompt", - "agent" - ] - }, - "HookOutputEntry": { - "type": "object", - "required": [ - "kind", - "text" - ], - "properties": { - "kind": { - "$ref": "#/definitions/HookOutputEntryKind" - }, - "text": { - "type": "string" - } - } - }, - "HookOutputEntryKind": { - "type": "string", - "enum": [ - "warning", - "stop", - "feedback", - "context", - "error" - ] - }, - "HookRunStatus": { - "type": "string", - "enum": [ - "running", - "completed", - "failed", - "blocked", - "stopped" - ] - }, - "HookRunSummary": { - "type": "object", - "required": [ - "displayOrder", - "entries", - "eventName", - "executionMode", - "handlerType", - "id", - "scope", - "sourcePath", - "startedAt", - "status" - ], - "properties": { - "completedAt": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "displayOrder": { - "type": "integer", - "format": "int64" - }, - "durationMs": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/HookOutputEntry" - } - }, - "eventName": { - "$ref": "#/definitions/HookEventName" - }, - "executionMode": { - "$ref": "#/definitions/HookExecutionMode" - }, - "handlerType": { - "$ref": "#/definitions/HookHandlerType" - }, - "id": { - "type": "string" - }, - "scope": { - "$ref": "#/definitions/HookScope" - }, - "source": { - "default": "unknown", - "allOf": [ - { - "$ref": "#/definitions/HookSource" - } - ] - }, - "sourcePath": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "startedAt": { - "type": "integer", - "format": "int64" - }, - "status": { - "$ref": "#/definitions/HookRunStatus" - }, - "statusMessage": { - "type": [ - "string", - "null" - ] - } - } - }, - "HookScope": { - "type": "string", - "enum": [ - "thread", - "turn" - ] - }, - "HookSource": { - "type": "string", - "enum": [ - "system", - "user", - "project", - "mdm", - "sessionFlags", - "legacyManagedConfigFile", - "legacyManagedConfigMdm", - "unknown" - ] - }, - "HookStartedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "HookStartedNotification", - "type": "object", - "required": [ - "run", - "threadId" - ], - "properties": { - "run": { - "$ref": "#/definitions/HookRunSummary" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": [ - "string", - "null" - ] - } - } - }, - "TurnCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnCompletedNotification", - "type": "object", - "required": [ - "threadId", - "turn" - ], - "properties": { - "threadId": { - "type": "string" - }, - "turn": { - "$ref": "#/definitions/Turn" - } - } - }, - "HookCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "HookCompletedNotification", - "type": "object", - "required": [ - "run", - "threadId" - ], - "properties": { - "run": { - "$ref": "#/definitions/HookRunSummary" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": [ - "string", - "null" - ] - } - } - }, - "TurnDiffUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnDiffUpdatedNotification", - "description": "Notification that the turn-level unified diff has changed. Contains the latest aggregated diff across all file changes in the turn.", - "type": "object", - "required": [ - "diff", - "threadId", - "turnId" - ], - "properties": { - "diff": { - "type": "string" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "TurnPlanStep": { - "type": "object", - "required": [ - "status", - "step" - ], - "properties": { - "status": { - "$ref": "#/definitions/TurnPlanStepStatus" - }, - "step": { - "type": "string" - } - } - }, - "TurnPlanStepStatus": { - "type": "string", - "enum": [ - "pending", - "inProgress", - "completed" - ] - }, - "TurnPlanUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnPlanUpdatedNotification", - "type": "object", - "required": [ - "plan", - "threadId", - "turnId" - ], - "properties": { - "explanation": { - "type": [ - "string", - "null" - ] - }, - "plan": { - "type": "array", - "items": { - "$ref": "#/definitions/TurnPlanStep" - } - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "ItemStartedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ItemStartedNotification", - "type": "object", - "required": [ - "item", - "threadId", - "turnId" - ], - "properties": { - "item": { - "$ref": "#/definitions/ThreadItem" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - } - }, - "AdditionalFileSystemPermissions": { - "type": "object", - "properties": { - "entries": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - } - }, - "globScanMaxDepth": { - "type": [ - "integer", - "null" - ], - "format": "uint", - "minimum": 1.0 - }, - "read": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "write": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - } - } - }, - "AdditionalNetworkPermissions": { - "type": "object", - "properties": { - "enabled": { - "type": [ - "boolean", - "null" - ] - } - } - }, - "FuzzyFileSearchParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FuzzyFileSearchParams", - "type": "object", - "required": [ - "query", - "roots" - ], - "properties": { - "cancellationToken": { - "type": [ - "string", - "null" - ] - }, - "query": { - "type": "string" - }, - "roots": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InitializeParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "InitializeParams", - "type": "object", - "required": [ - "clientInfo" - ], - "properties": { - "capabilities": { - "anyOf": [ - { - "$ref": "#/definitions/InitializeCapabilities" - }, - { - "type": "null" - } - ] - }, - "clientInfo": { - "$ref": "#/definitions/ClientInfo" - } - } - }, - "ClientInfo": { - "type": "object", - "required": [ - "name", - "version" - ], - "properties": { - "name": { - "type": "string" - }, - "title": { - "type": [ - "string", - "null" - ] - }, - "version": { - "type": "string" - } - } - }, - "FuzzyFileSearchSessionCompletedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FuzzyFileSearchSessionCompletedNotification", - "type": "object", - "required": [ - "sessionId" - ], - "properties": { - "sessionId": { - "type": "string" - } - } - }, - "FuzzyFileSearchResult": { - "description": "Superset of [`codex_file_search::FileMatch`]", - "type": "object", - "required": [ - "file_name", - "match_type", - "path", - "root", - "score" - ], - "properties": { - "file_name": { - "type": "string" - }, - "indices": { - "type": [ - "array", - "null" - ], - "items": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - } - }, - "match_type": { - "$ref": "#/definitions/FuzzyFileSearchMatchType" - }, - "path": { - "type": "string" - }, - "root": { - "type": "string" - }, - "score": { - "type": "integer", - "format": "uint32", - "minimum": 0.0 - } - } - }, - "InitializeCapabilities": { - "description": "Client-declared capabilities negotiated during initialize.", - "type": "object", - "properties": { - "experimentalApi": { - "description": "Opt into receiving experimental API methods and fields.", - "default": false, - "type": "boolean" - }, - "optOutNotificationMethods": { - "description": "Exact notification method names that should be suppressed for this connection (for example `thread/started`).", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - } - } - }, - "FuzzyFileSearchMatchType": { - "type": "string", - "enum": [ - "file", - "directory" - ] - }, - "FuzzyFileSearchSessionUpdatedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FuzzyFileSearchSessionUpdatedNotification", - "type": "object", - "required": [ - "files", - "query", - "sessionId" - ], - "properties": { - "files": { - "type": "array", - "items": { - "$ref": "#/definitions/FuzzyFileSearchResult" - } - }, - "query": { - "type": "string" - }, - "sessionId": { - "type": "string" - } - } - }, - "ClientRequest": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ClientRequest", - "description": "Request from the client to the server.", - "oneOf": [ - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "initialize" - ], - "title": "InitializeRequestMethod" - }, - "params": { - "$ref": "#/definitions/InitializeParams" - } - }, - "title": "InitializeRequest" - }, - { - "description": "NEW APIs", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/start" - ], - "title": "Thread/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadStartParams" - } - }, - "title": "Thread/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/resume" - ], - "title": "Thread/resumeRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadResumeParams" - } - }, - "title": "Thread/resumeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/fork" - ], - "title": "Thread/forkRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadForkParams" - } - }, - "title": "Thread/forkRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/archive" - ], - "title": "Thread/archiveRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadArchiveParams" - } - }, - "title": "Thread/archiveRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/unsubscribe" - ], - "title": "Thread/unsubscribeRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadUnsubscribeParams" - } - }, - "title": "Thread/unsubscribeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/name/set" - ], - "title": "Thread/name/setRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadSetNameParams" - } - }, - "title": "Thread/name/setRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/metadata/update" - ], - "title": "Thread/metadata/updateRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadMetadataUpdateParams" - } - }, - "title": "Thread/metadata/updateRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/unarchive" - ], - "title": "Thread/unarchiveRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadUnarchiveParams" - } - }, - "title": "Thread/unarchiveRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/compact/start" - ], - "title": "Thread/compact/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadCompactStartParams" - } - }, - "title": "Thread/compact/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/shellCommand" - ], - "title": "Thread/shellCommandRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadShellCommandParams" - } - }, - "title": "Thread/shellCommandRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/approveGuardianDeniedAction" - ], - "title": "Thread/approveGuardianDeniedActionRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadApproveGuardianDeniedActionParams" - } - }, - "title": "Thread/approveGuardianDeniedActionRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/rollback" - ], - "title": "Thread/rollbackRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRollbackParams" - } - }, - "title": "Thread/rollbackRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/list" - ], - "title": "Thread/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadListParams" - } - }, - "title": "Thread/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/loaded/list" - ], - "title": "Thread/loaded/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadLoadedListParams" - } - }, - "title": "Thread/loaded/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/read" - ], - "title": "Thread/readRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadReadParams" - } - }, - "title": "Thread/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/turns/list" - ], - "title": "Thread/turns/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadTurnsListParams" - } - }, - "title": "Thread/turns/listRequest" - }, - { - "description": "Append raw Responses API items to the thread history without starting a user turn.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "thread/inject_items" - ], - "title": "Thread/injectItemsRequestMethod" - }, - "params": { - "$ref": "#/definitions/ThreadInjectItemsParams" - } - }, - "title": "Thread/injectItemsRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "device/key/create" - ], - "title": "Device/key/createRequestMethod" - }, - "params": { - "$ref": "#/definitions/DeviceKeyCreateParams" - } - }, - "title": "Device/key/createRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "device/key/public" - ], - "title": "Device/key/publicRequestMethod" - }, - "params": { - "$ref": "#/definitions/DeviceKeyPublicParams" - } - }, - "title": "Device/key/publicRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "device/key/sign" - ], - "title": "Device/key/signRequestMethod" - }, - "params": { - "$ref": "#/definitions/DeviceKeySignParams" - } - }, - "title": "Device/key/signRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/readFile" - ], - "title": "Fs/readFileRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsReadFileParams" - } - }, - "title": "Fs/readFileRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/writeFile" - ], - "title": "Fs/writeFileRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsWriteFileParams" - } - }, - "title": "Fs/writeFileRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/createDirectory" - ], - "title": "Fs/createDirectoryRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsCreateDirectoryParams" - } - }, - "title": "Fs/createDirectoryRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/getMetadata" - ], - "title": "Fs/getMetadataRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsGetMetadataParams" - } - }, - "title": "Fs/getMetadataRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/readDirectory" - ], - "title": "Fs/readDirectoryRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsReadDirectoryParams" - } - }, - "title": "Fs/readDirectoryRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/remove" - ], - "title": "Fs/removeRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsRemoveParams" - } - }, - "title": "Fs/removeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/copy" - ], - "title": "Fs/copyRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsCopyParams" - } - }, - "title": "Fs/copyRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/watch" - ], - "title": "Fs/watchRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsWatchParams" - } - }, - "title": "Fs/watchRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fs/unwatch" - ], - "title": "Fs/unwatchRequestMethod" - }, - "params": { - "$ref": "#/definitions/FsUnwatchParams" - } - }, - "title": "Fs/unwatchRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "turn/start" - ], - "title": "Turn/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/TurnStartParams" - } - }, - "title": "Turn/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "turn/steer" - ], - "title": "Turn/steerRequestMethod" - }, - "params": { - "$ref": "#/definitions/TurnSteerParams" - } - }, - "title": "Turn/steerRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "turn/interrupt" - ], - "title": "Turn/interruptRequestMethod" - }, - "params": { - "$ref": "#/definitions/TurnInterruptParams" - } - }, - "title": "Turn/interruptRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "review/start" - ], - "title": "Review/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/ReviewStartParams" - } - }, - "title": "Review/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "model/list" - ], - "title": "Model/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/ModelListParams" - } - }, - "title": "Model/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "experimentalFeature/list" - ], - "title": "ExperimentalFeature/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/ExperimentalFeatureListParams" - } - }, - "title": "ExperimentalFeature/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "experimentalFeature/enablement/set" - ], - "title": "ExperimentalFeature/enablement/setRequestMethod" - }, - "params": { - "$ref": "#/definitions/ExperimentalFeatureEnablementSetParams" - } - }, - "title": "ExperimentalFeature/enablement/setRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServer/oauth/login" - ], - "title": "McpServer/oauth/loginRequestMethod" - }, - "params": { - "$ref": "#/definitions/McpServerOauthLoginParams" - } - }, - "title": "McpServer/oauth/loginRequest" - }, - { - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "config/mcpServer/reload" - ], - "title": "Config/mcpServer/reloadRequestMethod" - }, - "params": { - "type": "null" - } - }, - "title": "Config/mcpServer/reloadRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServerStatus/list" - ], - "title": "McpServerStatus/listRequestMethod" - }, - "params": { - "$ref": "#/definitions/ListMcpServerStatusParams" - } - }, - "title": "McpServerStatus/listRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServer/resource/read" - ], - "title": "McpServer/resource/readRequestMethod" - }, - "params": { - "$ref": "#/definitions/McpResourceReadParams" - } - }, - "title": "McpServer/resource/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "mcpServer/tool/call" - ], - "title": "McpServer/tool/callRequestMethod" - }, - "params": { - "$ref": "#/definitions/McpServerToolCallParams" - } - }, - "title": "McpServer/tool/callRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "windowsSandbox/setupStart" - ], - "title": "WindowsSandbox/setupStartRequestMethod" - }, - "params": { - "$ref": "#/definitions/WindowsSandboxSetupStartParams" - } - }, - "title": "WindowsSandbox/setupStartRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/login/start" - ], - "title": "Account/login/startRequestMethod" - }, - "params": { - "$ref": "#/definitions/LoginAccountParams" - } - }, - "title": "Account/login/startRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/login/cancel" - ], - "title": "Account/login/cancelRequestMethod" - }, - "params": { - "$ref": "#/definitions/CancelLoginAccountParams" - } - }, - "title": "Account/login/cancelRequest" - }, - { - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/logout" - ], - "title": "Account/logoutRequestMethod" - }, - "params": { - "type": "null" - } - }, - "title": "Account/logoutRequest" - }, - { - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/rateLimits/read" - ], - "title": "Account/rateLimits/readRequestMethod" - }, - "params": { - "type": "null" - } - }, - "title": "Account/rateLimits/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/sendAddCreditsNudgeEmail" - ], - "title": "Account/sendAddCreditsNudgeEmailRequestMethod" - }, - "params": { - "$ref": "#/definitions/SendAddCreditsNudgeEmailParams" - } - }, - "title": "Account/sendAddCreditsNudgeEmailRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "feedback/upload" - ], - "title": "Feedback/uploadRequestMethod" - }, - "params": { - "$ref": "#/definitions/FeedbackUploadParams" - } - }, - "title": "Feedback/uploadRequest" - }, - { - "description": "Execute a standalone command (argv vector) under the server's sandbox.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "command/exec" - ], - "title": "Command/execRequestMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecParams" - } - }, - "title": "Command/execRequest" - }, - { - "description": "Write stdin bytes to a running `command/exec` session or close stdin.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "command/exec/write" - ], - "title": "Command/exec/writeRequestMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecWriteParams" - } - }, - "title": "Command/exec/writeRequest" - }, - { - "description": "Terminate a running `command/exec` session by client-supplied `processId`.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "command/exec/terminate" - ], - "title": "Command/exec/terminateRequestMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecTerminateParams" - } - }, - "title": "Command/exec/terminateRequest" - }, - { - "description": "Resize a running PTY-backed `command/exec` session by client-supplied `processId`.", - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "command/exec/resize" - ], - "title": "Command/exec/resizeRequestMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecResizeParams" - } - }, - "title": "Command/exec/resizeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "config/read" - ], - "title": "Config/readRequestMethod" - }, - "params": { - "$ref": "#/definitions/ConfigReadParams" - } - }, - "title": "Config/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "config/value/write" - ], - "title": "Config/value/writeRequestMethod" - }, - "params": { - "$ref": "#/definitions/ConfigValueWriteParams" - } - }, - "title": "Config/value/writeRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "config/batchWrite" - ], - "title": "Config/batchWriteRequestMethod" - }, - "params": { - "$ref": "#/definitions/ConfigBatchWriteParams" - } - }, - "title": "Config/batchWriteRequest" - }, - { - "type": "object", - "required": [ - "id", - "method" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "configRequirements/read" - ], - "title": "ConfigRequirements/readRequestMethod" - }, - "params": { - "type": "null" - } - }, - "title": "ConfigRequirements/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "account/read" - ], - "title": "Account/readRequestMethod" - }, - "params": { - "$ref": "#/definitions/GetAccountParams" - } - }, - "title": "Account/readRequest" - }, - { - "type": "object", - "required": [ - "id", - "method", - "params" - ], - "properties": { - "id": { - "$ref": "#/definitions/RequestId" - }, - "method": { - "type": "string", - "enum": [ - "fuzzyFileSearch" - ], - "title": "FuzzyFileSearchRequestMethod" - }, - "params": { - "$ref": "#/definitions/FuzzyFileSearchParams" - } - }, - "title": "FuzzyFileSearchRequest" - } - ] - }, - "ServerNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ServerNotification", - "description": "Notification sent from the server to the client.", - "oneOf": [ - { - "description": "NEW NOTIFICATIONS", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "error" - ], - "title": "ErrorNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ErrorNotification" - } - }, - "title": "ErrorNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/started" - ], - "title": "Thread/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadStartedNotification" - } - }, - "title": "Thread/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/status/changed" - ], - "title": "Thread/status/changedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadStatusChangedNotification" - } - }, - "title": "Thread/status/changedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/archived" - ], - "title": "Thread/archivedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadArchivedNotification" - } - }, - "title": "Thread/archivedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/unarchived" - ], - "title": "Thread/unarchivedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadUnarchivedNotification" - } - }, - "title": "Thread/unarchivedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/closed" - ], - "title": "Thread/closedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadClosedNotification" - } - }, - "title": "Thread/closedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/name/updated" - ], - "title": "Thread/name/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadNameUpdatedNotification" - } - }, - "title": "Thread/name/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/tokenUsage/updated" - ], - "title": "Thread/tokenUsage/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadTokenUsageUpdatedNotification" - } - }, - "title": "Thread/tokenUsage/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "turn/started" - ], - "title": "Turn/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/TurnStartedNotification" - } - }, - "title": "Turn/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "hook/started" - ], - "title": "Hook/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/HookStartedNotification" - } - }, - "title": "Hook/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "turn/completed" - ], - "title": "Turn/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/TurnCompletedNotification" - } - }, - "title": "Turn/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "hook/completed" - ], - "title": "Hook/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/HookCompletedNotification" - } - }, - "title": "Hook/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "turn/diff/updated" - ], - "title": "Turn/diff/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/TurnDiffUpdatedNotification" - } - }, - "title": "Turn/diff/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "turn/plan/updated" - ], - "title": "Turn/plan/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/TurnPlanUpdatedNotification" - } - }, - "title": "Turn/plan/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/started" - ], - "title": "Item/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ItemStartedNotification" - } - }, - "title": "Item/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/autoApprovalReview/started" - ], - "title": "Item/autoApprovalReview/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ItemGuardianApprovalReviewStartedNotification" - } - }, - "title": "Item/autoApprovalReview/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/autoApprovalReview/completed" - ], - "title": "Item/autoApprovalReview/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ItemGuardianApprovalReviewCompletedNotification" - } - }, - "title": "Item/autoApprovalReview/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/completed" - ], - "title": "Item/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ItemCompletedNotification" - } - }, - "title": "Item/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/agentMessage/delta" - ], - "title": "Item/agentMessage/deltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/AgentMessageDeltaNotification" - } - }, - "title": "Item/agentMessage/deltaNotification" - }, - { - "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items.", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/plan/delta" - ], - "title": "Item/plan/deltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/PlanDeltaNotification" - } - }, - "title": "Item/plan/deltaNotification" - }, - { - "description": "Stream base64-encoded stdout/stderr chunks for a running `command/exec` session.", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "command/exec/outputDelta" - ], - "title": "Command/exec/outputDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecOutputDeltaNotification" - } - }, - "title": "Command/exec/outputDeltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/commandExecution/outputDelta" - ], - "title": "Item/commandExecution/outputDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/CommandExecutionOutputDeltaNotification" - } - }, - "title": "Item/commandExecution/outputDeltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/commandExecution/terminalInteraction" - ], - "title": "Item/commandExecution/terminalInteractionNotificationMethod" - }, - "params": { - "$ref": "#/definitions/TerminalInteractionNotification" - } - }, - "title": "Item/commandExecution/terminalInteractionNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/fileChange/outputDelta" - ], - "title": "Item/fileChange/outputDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/FileChangeOutputDeltaNotification" - } - }, - "title": "Item/fileChange/outputDeltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/fileChange/patchUpdated" - ], - "title": "Item/fileChange/patchUpdatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/FileChangePatchUpdatedNotification" - } - }, - "title": "Item/fileChange/patchUpdatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "serverRequest/resolved" - ], - "title": "ServerRequest/resolvedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ServerRequestResolvedNotification" - } - }, - "title": "ServerRequest/resolvedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/mcpToolCall/progress" - ], - "title": "Item/mcpToolCall/progressNotificationMethod" - }, - "params": { - "$ref": "#/definitions/McpToolCallProgressNotification" - } - }, - "title": "Item/mcpToolCall/progressNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "mcpServer/oauthLogin/completed" - ], - "title": "McpServer/oauthLogin/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/McpServerOauthLoginCompletedNotification" - } - }, - "title": "McpServer/oauthLogin/completedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "mcpServer/startupStatus/updated" - ], - "title": "McpServer/startupStatus/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/McpServerStatusUpdatedNotification" - } - }, - "title": "McpServer/startupStatus/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "account/updated" - ], - "title": "Account/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/AccountUpdatedNotification" - } - }, - "title": "Account/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "account/rateLimits/updated" - ], - "title": "Account/rateLimits/updatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/AccountRateLimitsUpdatedNotification" - } - }, - "title": "Account/rateLimits/updatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "fs/changed" - ], - "title": "Fs/changedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/FsChangedNotification" - } - }, - "title": "Fs/changedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/reasoning/summaryTextDelta" - ], - "title": "Item/reasoning/summaryTextDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ReasoningSummaryTextDeltaNotification" - } - }, - "title": "Item/reasoning/summaryTextDeltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/reasoning/summaryPartAdded" - ], - "title": "Item/reasoning/summaryPartAddedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ReasoningSummaryPartAddedNotification" - } - }, - "title": "Item/reasoning/summaryPartAddedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "item/reasoning/textDelta" - ], - "title": "Item/reasoning/textDeltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ReasoningTextDeltaNotification" - } - }, - "title": "Item/reasoning/textDeltaNotification" - }, - { - "description": "Deprecated: Use `ContextCompaction` item type instead.", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/compacted" - ], - "title": "Thread/compactedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ContextCompactedNotification" - } - }, - "title": "Thread/compactedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "model/rerouted" - ], - "title": "Model/reroutedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ModelReroutedNotification" - } - }, - "title": "Model/reroutedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "warning" - ], - "title": "WarningNotificationMethod" - }, - "params": { - "$ref": "#/definitions/WarningNotification" - } - }, - "title": "WarningNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "guardianWarning" - ], - "title": "GuardianWarningNotificationMethod" - }, - "params": { - "$ref": "#/definitions/GuardianWarningNotification" - } - }, - "title": "GuardianWarningNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "deprecationNotice" - ], - "title": "DeprecationNoticeNotificationMethod" - }, - "params": { - "$ref": "#/definitions/DeprecationNoticeNotification" - } - }, - "title": "DeprecationNoticeNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "configWarning" - ], - "title": "ConfigWarningNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ConfigWarningNotification" - } - }, - "title": "ConfigWarningNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/epiphany/stateUpdated" - ], - "title": "Thread/epiphany/stateUpdatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadEpiphanyStateUpdatedNotification" - } - }, - "title": "Thread/epiphany/stateUpdatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/epiphany/jobsUpdated" - ], - "title": "Thread/epiphany/jobsUpdatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadEpiphanyJobsUpdatedNotification" - } - }, - "title": "Thread/epiphany/jobsUpdatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "fuzzyFileSearch/sessionUpdated" - ], - "title": "FuzzyFileSearch/sessionUpdatedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/FuzzyFileSearchSessionUpdatedNotification" - } - }, - "title": "FuzzyFileSearch/sessionUpdatedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "fuzzyFileSearch/sessionCompleted" - ], - "title": "FuzzyFileSearch/sessionCompletedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/FuzzyFileSearchSessionCompletedNotification" - } - }, - "title": "FuzzyFileSearch/sessionCompletedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/started" - ], - "title": "Thread/realtime/startedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeStartedNotification" - } - }, - "title": "Thread/realtime/startedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/itemAdded" - ], - "title": "Thread/realtime/itemAddedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeItemAddedNotification" - } - }, - "title": "Thread/realtime/itemAddedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/transcript/delta" - ], - "title": "Thread/realtime/transcript/deltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeTranscriptDeltaNotification" - } - }, - "title": "Thread/realtime/transcript/deltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/transcript/done" - ], - "title": "Thread/realtime/transcript/doneNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeTranscriptDoneNotification" - } - }, - "title": "Thread/realtime/transcript/doneNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/outputAudio/delta" - ], - "title": "Thread/realtime/outputAudio/deltaNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeOutputAudioDeltaNotification" - } - }, - "title": "Thread/realtime/outputAudio/deltaNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/sdp" - ], - "title": "Thread/realtime/sdpNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeSdpNotification" - } - }, - "title": "Thread/realtime/sdpNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/error" - ], - "title": "Thread/realtime/errorNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeErrorNotification" - } - }, - "title": "Thread/realtime/errorNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "thread/realtime/closed" - ], - "title": "Thread/realtime/closedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/ThreadRealtimeClosedNotification" - } - }, - "title": "Thread/realtime/closedNotification" - }, - { - "description": "Notifies the user of world-writable directories on Windows, which cannot be protected by the sandbox.", - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "windows/worldWritableWarning" - ], - "title": "Windows/worldWritableWarningNotificationMethod" - }, - "params": { - "$ref": "#/definitions/WindowsWorldWritableWarningNotification" - } - }, - "title": "Windows/worldWritableWarningNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "windowsSandbox/setupCompleted" - ], - "title": "WindowsSandbox/setupCompletedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/WindowsSandboxSetupCompletedNotification" - } - }, - "title": "WindowsSandbox/setupCompletedNotification" - }, - { - "type": "object", - "required": [ - "method", - "params" - ], - "properties": { - "method": { - "type": "string", - "enum": [ - "account/login/completed" - ], - "title": "Account/login/completedNotificationMethod" - }, - "params": { - "$ref": "#/definitions/AccountLoginCompletedNotification" - } - }, - "title": "Account/login/completedNotification" - } - ] + "type": "string" } - } -} + }, + "title": "CodexAppServerProtocolV2", + "type": "object" +} \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v1/InitializeParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v1/InitializeParams.json index 908233a8..6048b822 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v1/InitializeParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v1/InitializeParams.json @@ -1,10 +1,49 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "InitializeParams", - "type": "object", - "required": [ - "clientInfo" - ], + "definitions": { + "ClientInfo": { + "properties": { + "name": { + "type": "string" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "version": { + "type": "string" + } + }, + "required": [ + "name", + "version" + ], + "type": "object" + }, + "InitializeCapabilities": { + "description": "Client-declared capabilities negotiated during initialize.", + "properties": { + "experimentalApi": { + "default": false, + "description": "Opt into receiving experimental API methods and fields.", + "type": "boolean" + }, + "optOutNotificationMethods": { + "description": "Exact notification method names that should be suppressed for this connection (for example `thread/started`).", + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + } + }, + "type": "object" + } + }, "properties": { "capabilities": { "anyOf": [ @@ -20,48 +59,9 @@ "$ref": "#/definitions/ClientInfo" } }, - "definitions": { - "ClientInfo": { - "type": "object", - "required": [ - "name", - "version" - ], - "properties": { - "name": { - "type": "string" - }, - "title": { - "type": [ - "string", - "null" - ] - }, - "version": { - "type": "string" - } - } - }, - "InitializeCapabilities": { - "description": "Client-declared capabilities negotiated during initialize.", - "type": "object", - "properties": { - "experimentalApi": { - "description": "Opt into receiving experimental API methods and fields.", - "default": false, - "type": "boolean" - }, - "optOutNotificationMethods": { - "description": "Exact notification method names that should be suppressed for this connection (for example `thread/started`).", - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - } - } - } - } + "required": [ + "clientInfo" + ], + "title": "InitializeParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v1/InitializeResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v1/InitializeResponse.json index 462c8188..1de65f82 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v1/InitializeResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v1/InitializeResponse.json @@ -1,21 +1,19 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "InitializeResponse", - "type": "object", - "required": [ - "codexHome", - "platformFamily", - "platformOs", - "userAgent" - ], + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + } + }, "properties": { "codexHome": { - "description": "Absolute path to the server's $CODEX_HOME directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute path to the server's $CODEX_HOME directory." }, "platformFamily": { "description": "Platform family for the running app-server target, for example `\"unix\"` or `\"windows\"`.", @@ -29,10 +27,12 @@ "type": "string" } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - } - } + "required": [ + "codexHome", + "platformFamily", + "platformOs", + "userAgent" + ], + "title": "InitializeResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AccountLoginCompletedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AccountLoginCompletedNotification.json index 56407343..128cb643 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AccountLoginCompletedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AccountLoginCompletedNotification.json @@ -1,10 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "AccountLoginCompletedNotification", - "type": "object", - "required": [ - "success" - ], "properties": { "error": { "type": [ @@ -21,5 +16,10 @@ "success": { "type": "boolean" } - } + }, + "required": [ + "success" + ], + "title": "AccountLoginCompletedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AccountRateLimitsUpdatedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AccountRateLimitsUpdatedNotification.json index 14d086e5..96fefb22 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AccountRateLimitsUpdatedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AccountRateLimitsUpdatedNotification.json @@ -1,22 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "AccountRateLimitsUpdatedNotification", - "type": "object", - "required": [ - "rateLimits" - ], - "properties": { - "rateLimits": { - "$ref": "#/definitions/RateLimitSnapshot" - } - }, "definitions": { "CreditsSnapshot": { - "type": "object", - "required": [ - "hasCredits", - "unlimited" - ], "properties": { "balance": { "type": [ @@ -30,10 +15,14 @@ "unlimited": { "type": "boolean" } - } + }, + "required": [ + "hasCredits", + "unlimited" + ], + "type": "object" }, "PlanType": { - "type": "string", "enum": [ "free", "go", @@ -47,20 +36,20 @@ "enterprise", "edu", "unknown" - ] + ], + "type": "string" }, "RateLimitReachedType": { - "type": "string", "enum": [ "rate_limit_reached", "workspace_owner_credits_depleted", "workspace_member_credits_depleted", "workspace_owner_usage_limit_reached", "workspace_member_usage_limit_reached" - ] + ], + "type": "string" }, "RateLimitSnapshot": { - "type": "object", "properties": { "credits": { "anyOf": [ @@ -124,33 +113,44 @@ } ] } - } + }, + "type": "object" }, "RateLimitWindow": { - "type": "object", + "properties": { + "resetsAt": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "usedPercent": { + "format": "int32", + "type": "integer" + }, + "windowDurationMins": { + "format": "int64", + "type": [ + "integer", + "null" + ] + } + }, "required": [ "usedPercent" ], - "properties": { - "resetsAt": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "usedPercent": { - "type": "integer", - "format": "int32" - }, - "windowDurationMins": { - "type": [ - "integer", - "null" - ], - "format": "int64" - } - } + "type": "object" } - } + }, + "properties": { + "rateLimits": { + "$ref": "#/definitions/RateLimitSnapshot" + } + }, + "required": [ + "rateLimits" + ], + "title": "AccountRateLimitsUpdatedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AccountUpdatedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AccountUpdatedNotification.json index b5e7ac71..e7546f55 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AccountUpdatedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AccountUpdatedNotification.json @@ -1,7 +1,57 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "AccountUpdatedNotification", - "type": "object", + "definitions": { + "AuthMode": { + "description": "Authentication mode for OpenAI-backed providers.", + "oneOf": [ + { + "description": "OpenAI API key provided by the caller and stored by Codex.", + "enum": [ + "apikey" + ], + "type": "string" + }, + { + "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).", + "enum": [ + "chatgpt" + ], + "type": "string" + }, + { + "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE.\n\nChatGPT auth tokens are supplied by an external host app and are only stored in memory. Token refresh must be handled by the external host app.", + "enum": [ + "chatgptAuthTokens" + ], + "type": "string" + }, + { + "description": "Programmatic Codex auth backed by a registered Agent Identity.", + "enum": [ + "agentIdentity" + ], + "type": "string" + } + ] + }, + "PlanType": { + "enum": [ + "free", + "go", + "plus", + "pro", + "prolite", + "team", + "self_serve_business_usage_based", + "business", + "enterprise_cbp_usage_based", + "enterprise", + "edu", + "unknown" + ], + "type": "string" + } + }, "properties": { "authMode": { "anyOf": [ @@ -24,56 +74,6 @@ ] } }, - "definitions": { - "AuthMode": { - "description": "Authentication mode for OpenAI-backed providers.", - "oneOf": [ - { - "description": "OpenAI API key provided by the caller and stored by Codex.", - "type": "string", - "enum": [ - "apikey" - ] - }, - { - "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).", - "type": "string", - "enum": [ - "chatgpt" - ] - }, - { - "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE.\n\nChatGPT auth tokens are supplied by an external host app and are only stored in memory. Token refresh must be handled by the external host app.", - "type": "string", - "enum": [ - "chatgptAuthTokens" - ] - }, - { - "description": "Programmatic Codex auth backed by a registered Agent Identity.", - "type": "string", - "enum": [ - "agentIdentity" - ] - } - ] - }, - "PlanType": { - "type": "string", - "enum": [ - "free", - "go", - "plus", - "pro", - "prolite", - "team", - "self_serve_business_usage_based", - "business", - "enterprise_cbp_usage_based", - "enterprise", - "edu", - "unknown" - ] - } - } + "title": "AccountUpdatedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AgentMessageDeltaNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AgentMessageDeltaNotification.json index b2868771..09510d95 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AgentMessageDeltaNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/AgentMessageDeltaNotification.json @@ -1,13 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "AgentMessageDeltaNotification", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], "properties": { "delta": { "type": "string" @@ -21,5 +13,13 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "AgentMessageDeltaNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountParams.json index c7a5d107..22c9a2ac 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountParams.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CancelLoginAccountParams", - "type": "object", - "required": [ - "loginId" - ], "properties": { "loginId": { "type": "string" } - } + }, + "required": [ + "loginId" + ], + "title": "CancelLoginAccountParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountResponse.json index 939ab6ef..23df186d 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountResponse.json @@ -1,22 +1,22 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CancelLoginAccountResponse", - "type": "object", - "required": [ - "status" - ], + "definitions": { + "CancelLoginAccountStatus": { + "enum": [ + "canceled", + "notFound" + ], + "type": "string" + } + }, "properties": { "status": { "$ref": "#/definitions/CancelLoginAccountStatus" } }, - "definitions": { - "CancelLoginAccountStatus": { - "type": "string", - "enum": [ - "canceled", - "notFound" - ] - } - } + "required": [ + "status" + ], + "title": "CancelLoginAccountResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecOutputDeltaNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecOutputDeltaNotification.json index a1a3876f..fff7e57d 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecOutputDeltaNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecOutputDeltaNotification.json @@ -1,14 +1,27 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecOutputDeltaNotification", + "definitions": { + "CommandExecOutputStream": { + "description": "Stream label for `command/exec/outputDelta` notifications.", + "oneOf": [ + { + "description": "stdout stream. PTY mode multiplexes terminal output here.", + "enum": [ + "stdout" + ], + "type": "string" + }, + { + "description": "stderr stream.", + "enum": [ + "stderr" + ], + "type": "string" + } + ] + } + }, "description": "Base64-encoded output chunk emitted for a streaming `command/exec` request.\n\nThese notifications are connection-scoped. If the originating connection closes, the server terminates the process.", - "type": "object", - "required": [ - "capReached", - "deltaBase64", - "processId", - "stream" - ], "properties": { "capReached": { "description": "`true` on the final streamed chunk for a stream when `outputBytesCap` truncated later output on that stream.", @@ -23,33 +36,20 @@ "type": "string" }, "stream": { - "description": "Output stream for this chunk.", "allOf": [ { "$ref": "#/definitions/CommandExecOutputStream" } - ] + ], + "description": "Output stream for this chunk." } }, - "definitions": { - "CommandExecOutputStream": { - "description": "Stream label for `command/exec/outputDelta` notifications.", - "oneOf": [ - { - "description": "stdout stream. PTY mode multiplexes terminal output here.", - "type": "string", - "enum": [ - "stdout" - ] - }, - { - "description": "stderr stream.", - "type": "string", - "enum": [ - "stderr" - ] - } - ] - } - } + "required": [ + "capReached", + "deltaBase64", + "processId", + "stream" + ], + "title": "CommandExecOutputDeltaNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecParams.json index 85b45f01..986ec4cc 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecParams.json @@ -1,18 +1,214 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecParams", + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + }, + "CommandExecTerminalSize": { + "description": "PTY size in character cells for `command/exec` PTY sessions.", + "properties": { + "cols": { + "description": "Terminal width in character cells.", + "format": "uint16", + "minimum": 0.0, + "type": "integer" + }, + "rows": { + "description": "Terminal height in character cells.", + "format": "uint16", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "cols", + "rows" + ], + "type": "object" + }, + "NetworkAccess": { + "enum": [ + "restricted", + "enabled" + ], + "type": "string" + }, + "ReadOnlyAccess": { + "oneOf": [ + { + "properties": { + "includePlatformDefaults": { + "default": true, + "type": "boolean" + }, + "readableRoots": { + "default": [], + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": "array" + }, + "type": { + "enum": [ + "restricted" + ], + "title": "RestrictedReadOnlyAccessType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "RestrictedReadOnlyAccess", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "fullAccess" + ], + "title": "FullAccessReadOnlyAccessType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "FullAccessReadOnlyAccess", + "type": "object" + } + ] + }, + "SandboxPolicy": { + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "dangerFullAccess" + ], + "title": "DangerFullAccessSandboxPolicyType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "DangerFullAccessSandboxPolicy", + "type": "object" + }, + { + "properties": { + "access": { + "allOf": [ + { + "$ref": "#/definitions/ReadOnlyAccess" + } + ], + "default": { + "type": "fullAccess" + } + }, + "networkAccess": { + "default": false, + "type": "boolean" + }, + "type": { + "enum": [ + "readOnly" + ], + "title": "ReadOnlySandboxPolicyType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ReadOnlySandboxPolicy", + "type": "object" + }, + { + "properties": { + "networkAccess": { + "allOf": [ + { + "$ref": "#/definitions/NetworkAccess" + } + ], + "default": "restricted" + }, + "type": { + "enum": [ + "externalSandbox" + ], + "title": "ExternalSandboxSandboxPolicyType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ExternalSandboxSandboxPolicy", + "type": "object" + }, + { + "properties": { + "excludeSlashTmp": { + "default": false, + "type": "boolean" + }, + "excludeTmpdirEnvVar": { + "default": false, + "type": "boolean" + }, + "networkAccess": { + "default": false, + "type": "boolean" + }, + "readOnlyAccess": { + "allOf": [ + { + "$ref": "#/definitions/ReadOnlyAccess" + } + ], + "default": { + "type": "fullAccess" + } + }, + "type": { + "enum": [ + "workspaceWrite" + ], + "title": "WorkspaceWriteSandboxPolicyType", + "type": "string" + }, + "writableRoots": { + "default": [], + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": "array" + } + }, + "required": [ + "type" + ], + "title": "WorkspaceWriteSandboxPolicy", + "type": "object" + } + ] + } + }, "description": "Run a standalone command (argv vector) in the server sandbox without creating a thread or turn.\n\nThe final `command/exec` response is deferred until the process exits and is sent only after all `command/exec/outputDelta` notifications for that connection have been emitted.", - "type": "object", - "required": [ - "command" - ], "properties": { "command": { "description": "Command argv vector. Empty arrays are rejected.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "cwd": { "description": "Optional working directory. Defaults to the server cwd.", @@ -30,26 +226,26 @@ "type": "boolean" }, "env": { - "description": "Optional environment overrides merged into the server-computed environment.\n\nMatching names override inherited values. Set a key to `null` to unset an inherited variable.", - "type": [ - "object", - "null" - ], "additionalProperties": { "type": [ "string", "null" ] - } + }, + "description": "Optional environment overrides merged into the server-computed environment.\n\nMatching names override inherited values. Set a key to `null` to unset an inherited variable.", + "type": [ + "object", + "null" + ] }, "outputBytesCap": { "description": "Optional per-stream stdout/stderr capture cap in bytes.\n\nWhen omitted, the server default applies. Cannot be combined with `disableOutputCap`.", + "format": "uint", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 0.0 + ] }, "processId": { "description": "Optional client-supplied, connection-scoped process id.\n\nRequired for `tty`, `streamStdin`, `streamStdoutStderr`, and follow-up `command/exec/write`, `command/exec/resize`, and `command/exec/terminate` calls. When omitted, buffered execution gets an internal id that is not exposed to the client.", @@ -59,7 +255,6 @@ ] }, "sandboxPolicy": { - "description": "Optional sandbox policy for this command.\n\nUses the same shape as thread/turn execution sandbox configuration and defaults to the user's configured policy when omitted.", "anyOf": [ { "$ref": "#/definitions/SandboxPolicy" @@ -67,10 +262,10 @@ { "type": "null" } - ] + ], + "description": "Optional sandbox policy for this command.\n\nUses the same shape as thread/turn execution sandbox configuration and defaults to the user's configured policy when omitted." }, "size": { - "description": "Optional initial PTY size in character cells. Only valid when `tty` is true.", "anyOf": [ { "$ref": "#/definitions/CommandExecTerminalSize" @@ -78,7 +273,8 @@ { "type": "null" } - ] + ], + "description": "Optional initial PTY size in character cells. Only valid when `tty` is true." }, "streamStdin": { "description": "Allow follow-up `command/exec/write` requests to write stdin bytes.\n\nRequires a client-supplied `processId`.", @@ -90,216 +286,20 @@ }, "timeoutMs": { "description": "Optional timeout in milliseconds.\n\nWhen omitted, the server default applies. Cannot be combined with `disableTimeout`.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "tty": { "description": "Enable PTY mode.\n\nThis implies `streamStdin` and `streamStdoutStderr`.", "type": "boolean" } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - }, - "CommandExecTerminalSize": { - "description": "PTY size in character cells for `command/exec` PTY sessions.", - "type": "object", - "required": [ - "cols", - "rows" - ], - "properties": { - "cols": { - "description": "Terminal width in character cells.", - "type": "integer", - "format": "uint16", - "minimum": 0.0 - }, - "rows": { - "description": "Terminal height in character cells.", - "type": "integer", - "format": "uint16", - "minimum": 0.0 - } - } - }, - "NetworkAccess": { - "type": "string", - "enum": [ - "restricted", - "enabled" - ] - }, - "ReadOnlyAccess": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "includePlatformDefaults": { - "default": true, - "type": "boolean" - }, - "readableRoots": { - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "type": { - "type": "string", - "enum": [ - "restricted" - ], - "title": "RestrictedReadOnlyAccessType" - } - }, - "title": "RestrictedReadOnlyAccess" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "fullAccess" - ], - "title": "FullAccessReadOnlyAccessType" - } - }, - "title": "FullAccessReadOnlyAccess" - } - ] - }, - "SandboxPolicy": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "dangerFullAccess" - ], - "title": "DangerFullAccessSandboxPolicyType" - } - }, - "title": "DangerFullAccessSandboxPolicy" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "access": { - "default": { - "type": "fullAccess" - }, - "allOf": [ - { - "$ref": "#/definitions/ReadOnlyAccess" - } - ] - }, - "networkAccess": { - "default": false, - "type": "boolean" - }, - "type": { - "type": "string", - "enum": [ - "readOnly" - ], - "title": "ReadOnlySandboxPolicyType" - } - }, - "title": "ReadOnlySandboxPolicy" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "networkAccess": { - "default": "restricted", - "allOf": [ - { - "$ref": "#/definitions/NetworkAccess" - } - ] - }, - "type": { - "type": "string", - "enum": [ - "externalSandbox" - ], - "title": "ExternalSandboxSandboxPolicyType" - } - }, - "title": "ExternalSandboxSandboxPolicy" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "excludeSlashTmp": { - "default": false, - "type": "boolean" - }, - "excludeTmpdirEnvVar": { - "default": false, - "type": "boolean" - }, - "networkAccess": { - "default": false, - "type": "boolean" - }, - "readOnlyAccess": { - "default": { - "type": "fullAccess" - }, - "allOf": [ - { - "$ref": "#/definitions/ReadOnlyAccess" - } - ] - }, - "type": { - "type": "string", - "enum": [ - "workspaceWrite" - ], - "title": "WorkspaceWriteSandboxPolicyType" - }, - "writableRoots": { - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - } - }, - "title": "WorkspaceWriteSandboxPolicy" - } - ] - } - } + "required": [ + "command" + ], + "title": "CommandExecParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecResizeParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecResizeParams.json index cd716a26..57d3b6a3 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecResizeParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecResizeParams.json @@ -1,48 +1,48 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecResizeParams", + "definitions": { + "CommandExecTerminalSize": { + "description": "PTY size in character cells for `command/exec` PTY sessions.", + "properties": { + "cols": { + "description": "Terminal width in character cells.", + "format": "uint16", + "minimum": 0.0, + "type": "integer" + }, + "rows": { + "description": "Terminal height in character cells.", + "format": "uint16", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "cols", + "rows" + ], + "type": "object" + } + }, "description": "Resize a running PTY-backed `command/exec` session.", - "type": "object", - "required": [ - "processId", - "size" - ], "properties": { "processId": { "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", "type": "string" }, "size": { - "description": "New PTY size in character cells.", "allOf": [ { "$ref": "#/definitions/CommandExecTerminalSize" } - ] + ], + "description": "New PTY size in character cells." } }, - "definitions": { - "CommandExecTerminalSize": { - "description": "PTY size in character cells for `command/exec` PTY sessions.", - "type": "object", - "required": [ - "cols", - "rows" - ], - "properties": { - "cols": { - "description": "Terminal width in character cells.", - "type": "integer", - "format": "uint16", - "minimum": 0.0 - }, - "rows": { - "description": "Terminal height in character cells.", - "type": "integer", - "format": "uint16", - "minimum": 0.0 - } - } - } - } + "required": [ + "processId", + "size" + ], + "title": "CommandExecResizeParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecResizeResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecResizeResponse.json index ddabfa5b..def86b66 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecResizeResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecResizeResponse.json @@ -1,6 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecResizeResponse", "description": "Empty success response for `command/exec/resize`.", + "title": "CommandExecResizeResponse", "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecResponse.json index d10361a6..1bbc5192 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecResponse.json @@ -1,18 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecResponse", "description": "Final buffered result for `command/exec`.", - "type": "object", - "required": [ - "exitCode", - "stderr", - "stdout" - ], "properties": { "exitCode": { "description": "Process exit code.", - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "stderr": { "description": "Buffered stderr capture.\n\nEmpty when stderr was streamed via `command/exec/outputDelta`.", @@ -22,5 +15,12 @@ "description": "Buffered stdout capture.\n\nEmpty when stdout was streamed via `command/exec/outputDelta`.", "type": "string" } - } + }, + "required": [ + "exitCode", + "stderr", + "stdout" + ], + "title": "CommandExecResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecTerminateParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecTerminateParams.json index 77ddbe14..1f848770 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecTerminateParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecTerminateParams.json @@ -1,15 +1,15 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecTerminateParams", "description": "Terminate a running `command/exec` session.", - "type": "object", - "required": [ - "processId" - ], "properties": { "processId": { "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", "type": "string" } - } + }, + "required": [ + "processId" + ], + "title": "CommandExecTerminateParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecTerminateResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecTerminateResponse.json index 244df8a8..59bdb0cb 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecTerminateResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecTerminateResponse.json @@ -1,6 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecTerminateResponse", "description": "Empty success response for `command/exec/terminate`.", + "title": "CommandExecTerminateResponse", "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecWriteParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecWriteParams.json index 493b3f4a..440f2410 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecWriteParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecWriteParams.json @@ -1,11 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecWriteParams", "description": "Write stdin bytes to a running `command/exec` session, close stdin, or both.", - "type": "object", - "required": [ - "processId" - ], "properties": { "closeStdin": { "description": "Close stdin after writing `deltaBase64`, if present.", @@ -22,5 +17,10 @@ "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", "type": "string" } - } + }, + "required": [ + "processId" + ], + "title": "CommandExecWriteParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecWriteResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecWriteResponse.json index cd5fe632..dff8301e 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecWriteResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecWriteResponse.json @@ -1,6 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecWriteResponse", "description": "Empty success response for `command/exec/write`.", + "title": "CommandExecWriteResponse", "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecutionOutputDeltaNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecutionOutputDeltaNotification.json index 5aa90958..e4cb64a9 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecutionOutputDeltaNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/CommandExecutionOutputDeltaNotification.json @@ -1,13 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "CommandExecutionOutputDeltaNotification", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], "properties": { "delta": { "type": "string" @@ -21,5 +13,13 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "CommandExecutionOutputDeltaNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigBatchWriteParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigBatchWriteParams.json index c93499bb..03cf2edb 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigBatchWriteParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigBatchWriteParams.json @@ -1,16 +1,37 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigBatchWriteParams", - "type": "object", - "required": [ - "edits" - ], + "definitions": { + "ConfigEdit": { + "properties": { + "keyPath": { + "type": "string" + }, + "mergeStrategy": { + "$ref": "#/definitions/MergeStrategy" + }, + "value": true + }, + "required": [ + "keyPath", + "mergeStrategy", + "value" + ], + "type": "object" + }, + "MergeStrategy": { + "enum": [ + "replace", + "upsert" + ], + "type": "string" + } + }, "properties": { "edits": { - "type": "array", "items": { "$ref": "#/definitions/ConfigEdit" - } + }, + "type": "array" }, "expectedVersion": { "type": [ @@ -30,30 +51,9 @@ "type": "boolean" } }, - "definitions": { - "ConfigEdit": { - "type": "object", - "required": [ - "keyPath", - "mergeStrategy", - "value" - ], - "properties": { - "keyPath": { - "type": "string" - }, - "mergeStrategy": { - "$ref": "#/definitions/MergeStrategy" - }, - "value": true - } - }, - "MergeStrategy": { - "type": "string", - "enum": [ - "replace", - "upsert" - ] - } - } + "required": [ + "edits" + ], + "title": "ConfigBatchWriteParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigReadParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigReadParams.json index 364cfd08..b173d2ba 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigReadParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigReadParams.json @@ -1,7 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigReadParams", - "type": "object", "properties": { "cwd": { "description": "Optional working directory to resolve project config layers. If specified, return the effective config as seen from that directory (i.e., including any project layers between `cwd` and the project/repo root).", @@ -14,5 +12,7 @@ "default": false, "type": "boolean" } - } + }, + "title": "ConfigReadParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigReadResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigReadResponse.json index 60eda481..e3f05ca5 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigReadResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigReadResponse.json @@ -1,38 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigReadResponse", - "type": "object", - "required": [ - "config", - "origins" - ], - "properties": { - "config": { - "$ref": "#/definitions/Config" - }, - "layers": { - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/ConfigLayer" - } - }, - "origins": { - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/ConfigLayerMetadata" - } - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "AnalyticsConfig": { - "type": "object", + "additionalProperties": true, "properties": { "enabled": { "type": [ @@ -41,41 +15,32 @@ ] } }, - "additionalProperties": true + "type": "object" }, "ApprovalsReviewer": { "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", - "type": "string", "enum": [ "user", "auto_review", "guardian_subagent" - ] + ], + "type": "string" }, "AskForApproval": { "oneOf": [ { - "type": "string", "enum": [ "untrusted", "on-failure", "on-request", "never" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "granular" - ], + "additionalProperties": false, "properties": { "granular": { - "type": "object", - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -90,16 +55,25 @@ "sandbox_approval": { "type": "boolean" } - } + }, + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "GranularAskForApproval" + "required": [ + "granular" + ], + "title": "GranularAskForApproval", + "type": "object" } ] }, "Config": { - "type": "object", + "additionalProperties": true, "properties": { "analytics": { "anyOf": [ @@ -122,7 +96,6 @@ ] }, "approvals_reviewer": { - "description": "[UNSTABLE] Optional default for where approval requests are routed for review.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -130,7 +103,8 @@ { "type": "null" } - ] + ], + "description": "[UNSTABLE] Optional default for where approval requests are routed for review." }, "compact_prompt": { "type": [ @@ -173,18 +147,18 @@ ] }, "model_auto_compact_token_limit": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "model_context_window": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "model_provider": { "type": [ @@ -229,11 +203,11 @@ ] }, "profiles": { - "default": {}, - "type": "object", "additionalProperties": { "$ref": "#/definitions/ProfileV2" - } + }, + "default": {}, + "type": "object" }, "review_model": { "type": [ @@ -292,15 +266,9 @@ ] } }, - "additionalProperties": true + "type": "object" }, "ConfigLayer": { - "type": "object", - "required": [ - "config", - "name", - "version" - ], "properties": { "config": true, "disabledReason": { @@ -315,14 +283,15 @@ "version": { "type": "string" } - } - }, - "ConfigLayerMetadata": { - "type": "object", + }, "required": [ + "config", "name", "version" ], + "type": "object" + }, + "ConfigLayerMetadata": { "properties": { "name": { "$ref": "#/definitions/ConfigLayerSource" @@ -330,18 +299,17 @@ "version": { "type": "string" } - } + }, + "required": [ + "name", + "version" + ], + "type": "object" }, "ConfigLayerSource": { "oneOf": [ { "description": "Managed preferences layer delivered by MDM (macOS only).", - "type": "object", - "required": [ - "domain", - "key", - "type" - ], "properties": { "domain": { "type": "string" @@ -350,153 +318,159 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mdm" ], - "title": "MdmConfigLayerSourceType" + "title": "MdmConfigLayerSourceType", + "type": "string" } }, - "title": "MdmConfigLayerSource" + "required": [ + "domain", + "key", + "type" + ], + "title": "MdmConfigLayerSource", + "type": "object" }, { "description": "Managed config layer from a file (usually `managed_config.toml`).", - "type": "object", - "required": [ - "file", - "type" - ], "properties": { "file": { - "description": "This is the path to the system config.toml file, though it is not guaranteed to exist.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "This is the path to the system config.toml file, though it is not guaranteed to exist." }, "type": { - "type": "string", "enum": [ "system" ], - "title": "SystemConfigLayerSourceType" + "title": "SystemConfigLayerSourceType", + "type": "string" } }, - "title": "SystemConfigLayerSource" - }, - { - "description": "User config layer from $CODEX_HOME/config.toml. This layer is special in that it is expected to be: - writable by the user - generally outside the workspace directory", - "type": "object", "required": [ "file", "type" ], + "title": "SystemConfigLayerSource", + "type": "object" + }, + { + "description": "User config layer from $CODEX_HOME/config.toml. This layer is special in that it is expected to be: - writable by the user - generally outside the workspace directory", "properties": { "file": { - "description": "This is the path to the user's config.toml file, though it is not guaranteed to exist.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "This is the path to the user's config.toml file, though it is not guaranteed to exist." }, "type": { - "type": "string", "enum": [ "user" ], - "title": "UserConfigLayerSourceType" + "title": "UserConfigLayerSourceType", + "type": "string" } }, - "title": "UserConfigLayerSource" + "required": [ + "file", + "type" + ], + "title": "UserConfigLayerSource", + "type": "object" }, { "description": "Path to a .codex/ folder within a project. There could be multiple of these between `cwd` and the project/repo root.", - "type": "object", - "required": [ - "dotCodexFolder", - "type" - ], "properties": { "dotCodexFolder": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "project" ], - "title": "ProjectConfigLayerSourceType" + "title": "ProjectConfigLayerSourceType", + "type": "string" } }, - "title": "ProjectConfigLayerSource" + "required": [ + "dotCodexFolder", + "type" + ], + "title": "ProjectConfigLayerSource", + "type": "object" }, { "description": "Session-layer overrides supplied via `-c`/`--config`.", - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "sessionFlags" ], - "title": "SessionFlagsConfigLayerSourceType" + "title": "SessionFlagsConfigLayerSourceType", + "type": "string" } }, - "title": "SessionFlagsConfigLayerSource" + "required": [ + "type" + ], + "title": "SessionFlagsConfigLayerSource", + "type": "object" }, { "description": "`managed_config.toml` was designed to be a config that was loaded as the last layer on top of everything else. This scheme did not quite work out as intended, but we keep this variant as a \"best effort\" while we phase out `managed_config.toml` in favor of `requirements.toml`.", - "type": "object", - "required": [ - "file", - "type" - ], "properties": { "file": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "legacyManagedConfigTomlFromFile" ], - "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType" + "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType", + "type": "string" } }, - "title": "LegacyManagedConfigTomlFromFileConfigLayerSource" - }, - { - "type": "object", "required": [ + "file", "type" ], + "title": "LegacyManagedConfigTomlFromFileConfigLayerSource", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "legacyManagedConfigTomlFromMdm" ], - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType" + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType", + "type": "string" } }, - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource" + "required": [ + "type" + ], + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource", + "type": "object" } ] }, "ForcedLoginMethod": { - "type": "string", "enum": [ "chatgpt", "api" - ] + ], + "type": "string" }, "ProfileV2": { - "type": "object", + "additionalProperties": true, "properties": { "approval_policy": { "anyOf": [ @@ -509,7 +483,6 @@ ] }, "approvals_reviewer": { - "description": "[UNSTABLE] Optional profile-level override for where approval requests are routed for review. If omitted, the enclosing config default is used.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -517,7 +490,8 @@ { "type": "null" } - ] + ], + "description": "[UNSTABLE] Optional profile-level override for where approval requests are routed for review. If omitted, the enclosing config default is used." }, "chatgpt_base_url": { "type": [ @@ -598,11 +572,10 @@ ] } }, - "additionalProperties": true + "type": "object" }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -610,38 +583,38 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "ReasoningSummary": { "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries", "oneOf": [ { - "type": "string", "enum": [ "auto", "concise", "detailed" - ] + ], + "type": "string" }, { "description": "Option to disable reasoning summaries.", - "type": "string", "enum": [ "none" - ] + ], + "type": "string" } ] }, "SandboxMode": { - "type": "string", "enum": [ "read-only", "workspace-write", "danger-full-access" - ] + ], + "type": "string" }, "SandboxWorkspaceWrite": { - "type": "object", "properties": { "exclude_slash_tmp": { "default": false, @@ -657,22 +630,22 @@ }, "writable_roots": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "ServiceTier": { - "type": "string", "enum": [ "fast", "flex" - ] + ], + "type": "string" }, "ToolsV2": { - "type": "object", "properties": { "view_image": { "type": [ @@ -690,27 +663,28 @@ } ] } - } + }, + "type": "object" }, "Verbosity": { "description": "Controls output length/detail on GPT-5 models via the Responses API. Serialized with lowercase values to match the OpenAI API.", - "type": "string", "enum": [ "low", "medium", "high" - ] + ], + "type": "string" }, "WebSearchContextSize": { - "type": "string", "enum": [ "low", "medium", "high" - ] + ], + "type": "string" }, "WebSearchLocation": { - "type": "object", + "additionalProperties": false, "properties": { "city": { "type": [ @@ -737,27 +711,27 @@ ] } }, - "additionalProperties": false + "type": "object" }, "WebSearchMode": { - "type": "string", "enum": [ "disabled", "cached", "live" - ] + ], + "type": "string" }, "WebSearchToolConfig": { - "type": "object", + "additionalProperties": false, "properties": { "allowed_domains": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "context_size": { "anyOf": [ @@ -780,7 +754,33 @@ ] } }, - "additionalProperties": false + "type": "object" } - } + }, + "properties": { + "config": { + "$ref": "#/definitions/Config" + }, + "layers": { + "items": { + "$ref": "#/definitions/ConfigLayer" + }, + "type": [ + "array", + "null" + ] + }, + "origins": { + "additionalProperties": { + "$ref": "#/definitions/ConfigLayerMetadata" + }, + "type": "object" + } + }, + "required": [ + "config", + "origins" + ], + "title": "ConfigReadResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigRequirementsReadResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigRequirementsReadResponse.json index 47fd1f60..0e6224ce 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigRequirementsReadResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigRequirementsReadResponse.json @@ -1,54 +1,30 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigRequirementsReadResponse", - "type": "object", - "properties": { - "requirements": { - "description": "Null if no requirements are configured (e.g. no requirements.toml/MDM entries).", - "anyOf": [ - { - "$ref": "#/definitions/ConfigRequirements" - }, - { - "type": "null" - } - ] - } - }, "definitions": { "ApprovalsReviewer": { "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", - "type": "string", "enum": [ "user", "auto_review", "guardian_subagent" - ] + ], + "type": "string" }, "AskForApproval": { "oneOf": [ { - "type": "string", "enum": [ "untrusted", "on-failure", "on-request", "never" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "granular" - ], + "additionalProperties": false, "properties": { "granular": { - "type": "object", - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -63,52 +39,51 @@ "sandbox_approval": { "type": "boolean" } - } + }, + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "GranularAskForApproval" + "required": [ + "granular" + ], + "title": "GranularAskForApproval", + "type": "object" } ] }, "ConfigRequirements": { - "type": "object", "properties": { "allowedApprovalPolicies": { - "type": [ - "array", - "null" - ], "items": { "$ref": "#/definitions/AskForApproval" - } - }, - "featureRequirements": { + }, "type": [ - "object", + "array", "null" - ], - "additionalProperties": { - "type": "boolean" - } + ] }, "allowedSandboxModes": { - "type": [ - "array", - "null" - ], "items": { "$ref": "#/definitions/SandboxMode" - } - }, - "allowedWebSearchModes": { + }, "type": [ "array", "null" - ], + ] + }, + "allowedWebSearchModes": { "items": { "$ref": "#/definitions/WebSearchMode" - } + }, + "type": [ + "array", + "null" + ] }, "enforceResidency": { "anyOf": [ @@ -119,18 +94,27 @@ "type": "null" } ] + }, + "featureRequirements": { + "additionalProperties": { + "type": "boolean" + }, + "type": [ + "object", + "null" + ] } - } + }, + "type": "object" }, "NetworkDomainPermission": { - "type": "string", "enum": [ "allow", "deny" - ] + ], + "type": "string" }, "NetworkRequirements": { - "type": "object", "properties": { "allowLocalBinding": { "type": [ @@ -140,13 +124,13 @@ }, "allowUnixSockets": { "description": "Legacy compatibility view derived from `unix_sockets`.", + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "allowUpstreamProxy": { "type": [ @@ -156,13 +140,13 @@ }, "allowedDomains": { "description": "Legacy compatibility view derived from `domains`.", + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "dangerouslyAllowAllUnixSockets": { "type": [ @@ -178,23 +162,23 @@ }, "deniedDomains": { "description": "Legacy compatibility view derived from `domains`.", + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "domains": { + "additionalProperties": { + "$ref": "#/definitions/NetworkDomainPermission" + }, "description": "Canonical network permission map for `experimental_network`.", "type": [ "object", "null" - ], - "additionalProperties": { - "$ref": "#/definitions/NetworkDomainPermission" - } + ] }, "enabled": { "type": [ @@ -203,12 +187,12 @@ ] }, "httpPort": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] }, "managedAllowedDomainsOnly": { "description": "When true, only managed allowlist entries are respected while managed network enforcement is active.", @@ -218,53 +202,69 @@ ] }, "socksPort": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] }, "unixSockets": { + "additionalProperties": { + "$ref": "#/definitions/NetworkUnixSocketPermission" + }, "description": "Canonical unix socket permission map for `experimental_network`.", "type": [ "object", "null" - ], - "additionalProperties": { - "$ref": "#/definitions/NetworkUnixSocketPermission" - } + ] } - } + }, + "type": "object" }, "NetworkUnixSocketPermission": { - "type": "string", "enum": [ "allow", "none" - ] + ], + "type": "string" }, "ResidencyRequirement": { - "type": "string", "enum": [ "us" - ] + ], + "type": "string" }, "SandboxMode": { - "type": "string", "enum": [ "read-only", "workspace-write", "danger-full-access" - ] + ], + "type": "string" }, "WebSearchMode": { - "type": "string", "enum": [ "disabled", "cached", "live" - ] + ], + "type": "string" } - } + }, + "properties": { + "requirements": { + "anyOf": [ + { + "$ref": "#/definitions/ConfigRequirements" + }, + { + "type": "null" + } + ], + "description": "Null if no requirements are configured (e.g. no requirements.toml/MDM entries)." + } + }, + "title": "ConfigRequirementsReadResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigValueWriteParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigValueWriteParams.json index 46d6625f..000c55a8 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigValueWriteParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigValueWriteParams.json @@ -1,12 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigValueWriteParams", - "type": "object", - "required": [ - "keyPath", - "mergeStrategy", - "value" - ], + "definitions": { + "MergeStrategy": { + "enum": [ + "replace", + "upsert" + ], + "type": "string" + } + }, "properties": { "expectedVersion": { "type": [ @@ -29,13 +31,11 @@ }, "value": true }, - "definitions": { - "MergeStrategy": { - "type": "string", - "enum": [ - "replace", - "upsert" - ] - } - } + "required": [ + "keyPath", + "mergeStrategy", + "value" + ], + "title": "ConfigValueWriteParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigWarningNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigWarningNotification.json index 131d55ee..c89e42a2 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigWarningNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigWarningNotification.json @@ -1,10 +1,43 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigWarningNotification", - "type": "object", - "required": [ - "summary" - ], + "definitions": { + "TextPosition": { + "properties": { + "column": { + "description": "1-based column number (in Unicode scalar values).", + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "line": { + "description": "1-based line number.", + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, + "required": [ + "column", + "line" + ], + "type": "object" + }, + "TextRange": { + "properties": { + "end": { + "$ref": "#/definitions/TextPosition" + }, + "start": { + "$ref": "#/definitions/TextPosition" + } + }, + "required": [ + "end", + "start" + ], + "type": "object" + } + }, "properties": { "details": { "description": "Optional extra guidance or error details.", @@ -21,7 +54,6 @@ ] }, "range": { - "description": "Optional range for the error location inside the config file.", "anyOf": [ { "$ref": "#/definitions/TextRange" @@ -29,49 +61,17 @@ { "type": "null" } - ] + ], + "description": "Optional range for the error location inside the config file." }, "summary": { "description": "Concise summary of the warning.", "type": "string" } }, - "definitions": { - "TextPosition": { - "type": "object", - "required": [ - "column", - "line" - ], - "properties": { - "column": { - "description": "1-based column number (in Unicode scalar values).", - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "line": { - "description": "1-based line number.", - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } - }, - "TextRange": { - "type": "object", - "required": [ - "end", - "start" - ], - "properties": { - "end": { - "$ref": "#/definitions/TextPosition" - }, - "start": { - "$ref": "#/definitions/TextPosition" - } - } - } - } + "required": [ + "summary" + ], + "title": "ConfigWarningNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigWriteResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigWriteResponse.json index 50c35a2f..631318a8 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigWriteResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ConfigWriteResponse.json @@ -1,20 +1,214 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ConfigWriteResponse", - "type": "object", - "required": [ - "filePath", - "status", - "version" - ], + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + }, + "ConfigLayerMetadata": { + "properties": { + "name": { + "$ref": "#/definitions/ConfigLayerSource" + }, + "version": { + "type": "string" + } + }, + "required": [ + "name", + "version" + ], + "type": "object" + }, + "ConfigLayerSource": { + "oneOf": [ + { + "description": "Managed preferences layer delivered by MDM (macOS only).", + "properties": { + "domain": { + "type": "string" + }, + "key": { + "type": "string" + }, + "type": { + "enum": [ + "mdm" + ], + "title": "MdmConfigLayerSourceType", + "type": "string" + } + }, + "required": [ + "domain", + "key", + "type" + ], + "title": "MdmConfigLayerSource", + "type": "object" + }, + { + "description": "Managed config layer from a file (usually `managed_config.toml`).", + "properties": { + "file": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "This is the path to the system config.toml file, though it is not guaranteed to exist." + }, + "type": { + "enum": [ + "system" + ], + "title": "SystemConfigLayerSourceType", + "type": "string" + } + }, + "required": [ + "file", + "type" + ], + "title": "SystemConfigLayerSource", + "type": "object" + }, + { + "description": "User config layer from $CODEX_HOME/config.toml. This layer is special in that it is expected to be: - writable by the user - generally outside the workspace directory", + "properties": { + "file": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "This is the path to the user's config.toml file, though it is not guaranteed to exist." + }, + "type": { + "enum": [ + "user" + ], + "title": "UserConfigLayerSourceType", + "type": "string" + } + }, + "required": [ + "file", + "type" + ], + "title": "UserConfigLayerSource", + "type": "object" + }, + { + "description": "Path to a .codex/ folder within a project. There could be multiple of these between `cwd` and the project/repo root.", + "properties": { + "dotCodexFolder": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": { + "enum": [ + "project" + ], + "title": "ProjectConfigLayerSourceType", + "type": "string" + } + }, + "required": [ + "dotCodexFolder", + "type" + ], + "title": "ProjectConfigLayerSource", + "type": "object" + }, + { + "description": "Session-layer overrides supplied via `-c`/`--config`.", + "properties": { + "type": { + "enum": [ + "sessionFlags" + ], + "title": "SessionFlagsConfigLayerSourceType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "SessionFlagsConfigLayerSource", + "type": "object" + }, + { + "description": "`managed_config.toml` was designed to be a config that was loaded as the last layer on top of everything else. This scheme did not quite work out as intended, but we keep this variant as a \"best effort\" while we phase out `managed_config.toml` in favor of `requirements.toml`.", + "properties": { + "file": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": { + "enum": [ + "legacyManagedConfigTomlFromFile" + ], + "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType", + "type": "string" + } + }, + "required": [ + "file", + "type" + ], + "title": "LegacyManagedConfigTomlFromFileConfigLayerSource", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "legacyManagedConfigTomlFromMdm" + ], + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource", + "type": "object" + } + ] + }, + "OverriddenMetadata": { + "properties": { + "effectiveValue": true, + "message": { + "type": "string" + }, + "overridingLayer": { + "$ref": "#/definitions/ConfigLayerMetadata" + } + }, + "required": [ + "effectiveValue", + "message", + "overridingLayer" + ], + "type": "object" + }, + "WriteStatus": { + "enum": [ + "ok", + "okOverridden" + ], + "type": "string" + } + }, "properties": { "filePath": { - "description": "Canonical path to the config file that was written.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Canonical path to the config file that was written." }, "overriddenMetadata": { "anyOf": [ @@ -33,205 +227,11 @@ "type": "string" } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - }, - "ConfigLayerMetadata": { - "type": "object", - "required": [ - "name", - "version" - ], - "properties": { - "name": { - "$ref": "#/definitions/ConfigLayerSource" - }, - "version": { - "type": "string" - } - } - }, - "ConfigLayerSource": { - "oneOf": [ - { - "description": "Managed preferences layer delivered by MDM (macOS only).", - "type": "object", - "required": [ - "domain", - "key", - "type" - ], - "properties": { - "domain": { - "type": "string" - }, - "key": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "mdm" - ], - "title": "MdmConfigLayerSourceType" - } - }, - "title": "MdmConfigLayerSource" - }, - { - "description": "Managed config layer from a file (usually `managed_config.toml`).", - "type": "object", - "required": [ - "file", - "type" - ], - "properties": { - "file": { - "description": "This is the path to the system config.toml file, though it is not guaranteed to exist.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - }, - "type": { - "type": "string", - "enum": [ - "system" - ], - "title": "SystemConfigLayerSourceType" - } - }, - "title": "SystemConfigLayerSource" - }, - { - "description": "User config layer from $CODEX_HOME/config.toml. This layer is special in that it is expected to be: - writable by the user - generally outside the workspace directory", - "type": "object", - "required": [ - "file", - "type" - ], - "properties": { - "file": { - "description": "This is the path to the user's config.toml file, though it is not guaranteed to exist.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - }, - "type": { - "type": "string", - "enum": [ - "user" - ], - "title": "UserConfigLayerSourceType" - } - }, - "title": "UserConfigLayerSource" - }, - { - "description": "Path to a .codex/ folder within a project. There could be multiple of these between `cwd` and the project/repo root.", - "type": "object", - "required": [ - "dotCodexFolder", - "type" - ], - "properties": { - "dotCodexFolder": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": { - "type": "string", - "enum": [ - "project" - ], - "title": "ProjectConfigLayerSourceType" - } - }, - "title": "ProjectConfigLayerSource" - }, - { - "description": "Session-layer overrides supplied via `-c`/`--config`.", - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "sessionFlags" - ], - "title": "SessionFlagsConfigLayerSourceType" - } - }, - "title": "SessionFlagsConfigLayerSource" - }, - { - "description": "`managed_config.toml` was designed to be a config that was loaded as the last layer on top of everything else. This scheme did not quite work out as intended, but we keep this variant as a \"best effort\" while we phase out `managed_config.toml` in favor of `requirements.toml`.", - "type": "object", - "required": [ - "file", - "type" - ], - "properties": { - "file": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": { - "type": "string", - "enum": [ - "legacyManagedConfigTomlFromFile" - ], - "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType" - } - }, - "title": "LegacyManagedConfigTomlFromFileConfigLayerSource" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "legacyManagedConfigTomlFromMdm" - ], - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType" - } - }, - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource" - } - ] - }, - "OverriddenMetadata": { - "type": "object", - "required": [ - "effectiveValue", - "message", - "overridingLayer" - ], - "properties": { - "effectiveValue": true, - "message": { - "type": "string" - }, - "overridingLayer": { - "$ref": "#/definitions/ConfigLayerMetadata" - } - } - }, - "WriteStatus": { - "type": "string", - "enum": [ - "ok", - "okOverridden" - ] - } - } + "required": [ + "filePath", + "status", + "version" + ], + "title": "ConfigWriteResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ContextCompactedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ContextCompactedNotification.json index 4ca69d25..8d2d4b12 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ContextCompactedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ContextCompactedNotification.json @@ -1,12 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ContextCompactedNotification", "description": "Deprecated: Use `ContextCompaction` item type instead.", - "type": "object", - "required": [ - "threadId", - "turnId" - ], "properties": { "threadId": { "type": "string" @@ -14,5 +8,11 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "threadId", + "turnId" + ], + "title": "ContextCompactedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeprecationNoticeNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeprecationNoticeNotification.json index 6781b4e7..7e6c73b9 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeprecationNoticeNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeprecationNoticeNotification.json @@ -1,10 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeprecationNoticeNotification", - "type": "object", - "required": [ - "summary" - ], "properties": { "details": { "description": "Optional extra guidance, such as migration steps or rationale.", @@ -17,5 +12,10 @@ "description": "Concise summary of what is deprecated.", "type": "string" } - } + }, + "required": [ + "summary" + ], + "title": "DeprecationNoticeNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyCreateParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyCreateParams.json index ca422f8c..fe2c0f08 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyCreateParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyCreateParams.json @@ -1,12 +1,16 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeyCreateParams", + "definitions": { + "DeviceKeyProtectionPolicy": { + "description": "Protection policy for creating or loading a controller-local device key.", + "enum": [ + "hardware_only", + "allow_os_protected_nonextractable" + ], + "type": "string" + } + }, "description": "Create a controller-local device key with a random key id.", - "type": "object", - "required": [ - "accountUserId", - "clientId" - ], "properties": { "accountUserId": { "type": "string" @@ -15,7 +19,6 @@ "type": "string" }, "protectionPolicy": { - "description": "Defaults to `hardware_only` when omitted.", "anyOf": [ { "$ref": "#/definitions/DeviceKeyProtectionPolicy" @@ -23,17 +26,14 @@ { "type": "null" } - ] + ], + "description": "Defaults to `hardware_only` when omitted." } }, - "definitions": { - "DeviceKeyProtectionPolicy": { - "description": "Protection policy for creating or loading a controller-local device key.", - "type": "string", - "enum": [ - "hardware_only", - "allow_os_protected_nonextractable" - ] - } - } + "required": [ + "accountUserId", + "clientId" + ], + "title": "DeviceKeyCreateParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyCreateResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyCreateResponse.json index 62b6498e..12072588 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyCreateResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyCreateResponse.json @@ -1,14 +1,24 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeyCreateResponse", + "definitions": { + "DeviceKeyAlgorithm": { + "description": "Device-key algorithm reported at enrollment and signing boundaries.", + "enum": [ + "ecdsa_p256_sha256" + ], + "type": "string" + }, + "DeviceKeyProtectionClass": { + "description": "Platform protection class for a controller-local device key.", + "enum": [ + "hardware_secure_enclave", + "hardware_tpm", + "os_protected_nonextractable" + ], + "type": "string" + } + }, "description": "Device-key metadata and public key returned by create/public APIs.", - "type": "object", - "required": [ - "algorithm", - "keyId", - "protectionClass", - "publicKeySpkiDerBase64" - ], "properties": { "algorithm": { "$ref": "#/definitions/DeviceKeyAlgorithm" @@ -24,22 +34,12 @@ "type": "string" } }, - "definitions": { - "DeviceKeyAlgorithm": { - "description": "Device-key algorithm reported at enrollment and signing boundaries.", - "type": "string", - "enum": [ - "ecdsa_p256_sha256" - ] - }, - "DeviceKeyProtectionClass": { - "description": "Platform protection class for a controller-local device key.", - "type": "string", - "enum": [ - "hardware_secure_enclave", - "hardware_tpm", - "os_protected_nonextractable" - ] - } - } + "required": [ + "algorithm", + "keyId", + "protectionClass", + "publicKeySpkiDerBase64" + ], + "title": "DeviceKeyCreateResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyPublicParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyPublicParams.json index ea0d4a6f..37cc5fbe 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyPublicParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyPublicParams.json @@ -1,14 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeyPublicParams", "description": "Fetch a controller-local device key public key by id.", - "type": "object", - "required": [ - "keyId" - ], "properties": { "keyId": { "type": "string" } - } + }, + "required": [ + "keyId" + ], + "title": "DeviceKeyPublicParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyPublicResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyPublicResponse.json index bdbe4622..39f98b76 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyPublicResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeyPublicResponse.json @@ -1,14 +1,24 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeyPublicResponse", + "definitions": { + "DeviceKeyAlgorithm": { + "description": "Device-key algorithm reported at enrollment and signing boundaries.", + "enum": [ + "ecdsa_p256_sha256" + ], + "type": "string" + }, + "DeviceKeyProtectionClass": { + "description": "Platform protection class for a controller-local device key.", + "enum": [ + "hardware_secure_enclave", + "hardware_tpm", + "os_protected_nonextractable" + ], + "type": "string" + } + }, "description": "Device-key public metadata returned by `device/key/public`.", - "type": "object", - "required": [ - "algorithm", - "keyId", - "protectionClass", - "publicKeySpkiDerBase64" - ], "properties": { "algorithm": { "$ref": "#/definitions/DeviceKeyAlgorithm" @@ -24,22 +34,12 @@ "type": "string" } }, - "definitions": { - "DeviceKeyAlgorithm": { - "description": "Device-key algorithm reported at enrollment and signing boundaries.", - "type": "string", - "enum": [ - "ecdsa_p256_sha256" - ] - }, - "DeviceKeyProtectionClass": { - "description": "Platform protection class for a controller-local device key.", - "type": "string", - "enum": [ - "hardware_secure_enclave", - "hardware_tpm", - "os_protected_nonextractable" - ] - } - } + "required": [ + "algorithm", + "keyId", + "protectionClass", + "publicKeySpkiDerBase64" + ], + "title": "DeviceKeyPublicResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeySignParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeySignParams.json index 6234fcc4..054765b2 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeySignParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeySignParams.json @@ -1,40 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeySignParams", - "description": "Sign an accepted structured payload with a controller-local device key.", - "type": "object", - "required": [ - "keyId", - "payload" - ], - "properties": { - "keyId": { - "type": "string" - }, - "payload": { - "$ref": "#/definitions/DeviceKeySignPayload" - } - }, "definitions": { "DeviceKeySignPayload": { "description": "Structured payloads accepted by `device/key/sign`.", "oneOf": [ { "description": "Payload bound to one remote-control controller websocket `/client` connection challenge.", - "type": "object", - "required": [ - "accountUserId", - "audience", - "clientId", - "nonce", - "scopes", - "sessionId", - "targetOrigin", - "targetPath", - "tokenExpiresAt", - "tokenSha256Base64url", - "type" - ], "properties": { "accountUserId": { "type": "string" @@ -50,10 +21,10 @@ }, "scopes": { "description": "Must contain exactly `remote_control_controller_websocket`.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "sessionId": { "description": "Backend-issued websocket session id that this proof authorizes.", @@ -69,38 +40,39 @@ }, "tokenExpiresAt": { "description": "Remote-control token expiration as Unix seconds.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "tokenSha256Base64url": { "description": "SHA-256 of the controller-scoped remote-control token, encoded as unpadded base64url.", "type": "string" }, "type": { - "type": "string", "enum": [ "remoteControlClientConnection" ], - "title": "RemoteControlClientConnectionDeviceKeySignPayloadType" + "title": "RemoteControlClientConnectionDeviceKeySignPayloadType", + "type": "string" } }, - "title": "RemoteControlClientConnectionDeviceKeySignPayload" - }, - { - "description": "Payload bound to a remote-control client `/client/enroll` ownership challenge.", - "type": "object", "required": [ "accountUserId", "audience", - "challengeExpiresAt", - "challengeId", "clientId", - "deviceIdentitySha256Base64url", "nonce", + "scopes", + "sessionId", "targetOrigin", "targetPath", + "tokenExpiresAt", + "tokenSha256Base64url", "type" ], + "title": "RemoteControlClientConnectionDeviceKeySignPayload", + "type": "object" + }, + { + "description": "Payload bound to a remote-control client `/client/enroll` ownership challenge.", "properties": { "accountUserId": { "type": "string" @@ -110,8 +82,8 @@ }, "challengeExpiresAt": { "description": "Enrollment challenge expiration as Unix seconds.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "challengeId": { "description": "Backend-issued enrollment challenge id that this proof authorizes.", @@ -136,30 +108,58 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "remoteControlClientEnrollment" ], - "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType" + "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType", + "type": "string" } }, - "title": "RemoteControlClientEnrollmentDeviceKeySignPayload" + "required": [ + "accountUserId", + "audience", + "challengeExpiresAt", + "challengeId", + "clientId", + "deviceIdentitySha256Base64url", + "nonce", + "targetOrigin", + "targetPath", + "type" + ], + "title": "RemoteControlClientEnrollmentDeviceKeySignPayload", + "type": "object" } ] }, "RemoteControlClientConnectionAudience": { "description": "Audience for a remote-control client connection device-key proof.", - "type": "string", "enum": [ "remote_control_client_websocket" - ] + ], + "type": "string" }, "RemoteControlClientEnrollmentAudience": { "description": "Audience for a remote-control client enrollment device-key proof.", - "type": "string", "enum": [ "remote_control_client_enrollment" - ] + ], + "type": "string" } - } + }, + "description": "Sign an accepted structured payload with a controller-local device key.", + "properties": { + "keyId": { + "type": "string" + }, + "payload": { + "$ref": "#/definitions/DeviceKeySignPayload" + } + }, + "required": [ + "keyId", + "payload" + ], + "title": "DeviceKeySignParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeySignResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeySignResponse.json index 777c90a3..83fec903 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeySignResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/DeviceKeySignResponse.json @@ -1,13 +1,15 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "DeviceKeySignResponse", + "definitions": { + "DeviceKeyAlgorithm": { + "description": "Device-key algorithm reported at enrollment and signing boundaries.", + "enum": [ + "ecdsa_p256_sha256" + ], + "type": "string" + } + }, "description": "ASN.1 DER signature returned by `device/key/sign`.", - "type": "object", - "required": [ - "algorithm", - "signatureDerBase64", - "signedPayloadBase64" - ], "properties": { "algorithm": { "$ref": "#/definitions/DeviceKeyAlgorithm" @@ -21,13 +23,11 @@ "type": "string" } }, - "definitions": { - "DeviceKeyAlgorithm": { - "description": "Device-key algorithm reported at enrollment and signing boundaries.", - "type": "string", - "enum": [ - "ecdsa_p256_sha256" - ] - } - } + "required": [ + "algorithm", + "signatureDerBase64", + "signedPayloadBase64" + ], + "title": "DeviceKeySignResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ErrorNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ErrorNotification.json index 244f4d54..032743d5 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ErrorNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ErrorNotification.json @@ -1,33 +1,10 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ErrorNotification", - "type": "object", - "required": [ - "error", - "threadId", - "turnId", - "willRetry" - ], - "properties": { - "error": { - "$ref": "#/definitions/TurnError" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - }, - "willRetry": { - "type": "boolean" - } - }, "definitions": { "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -38,139 +15,136 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -192,7 +166,33 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" } - } + }, + "properties": { + "error": { + "$ref": "#/definitions/TurnError" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + }, + "willRetry": { + "type": "boolean" + } + }, + "required": [ + "error", + "threadId", + "turnId", + "willRetry" + ], + "title": "ErrorNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureEnablementSetParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureEnablementSetParams.json index c21ae87a..9d6bcec9 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureEnablementSetParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureEnablementSetParams.json @@ -1,17 +1,17 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExperimentalFeatureEnablementSetParams", - "type": "object", + "properties": { + "enablement": { + "additionalProperties": { + "type": "boolean" + }, + "description": "Process-wide runtime feature enablement keyed by canonical feature name.\n\nOnly named features are updated. Omitted features are left unchanged. Send an empty map for a no-op.", + "type": "object" + } + }, "required": [ "enablement" ], - "properties": { - "enablement": { - "description": "Process-wide runtime feature enablement keyed by canonical feature name.\n\nOnly named features are updated. Omitted features are left unchanged. Send an empty map for a no-op.", - "type": "object", - "additionalProperties": { - "type": "boolean" - } - } - } + "title": "ExperimentalFeatureEnablementSetParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureEnablementSetResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureEnablementSetResponse.json index d53de60c..9cdbf069 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureEnablementSetResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureEnablementSetResponse.json @@ -1,17 +1,17 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExperimentalFeatureEnablementSetResponse", - "type": "object", + "properties": { + "enablement": { + "additionalProperties": { + "type": "boolean" + }, + "description": "Feature enablement entries updated by this request.", + "type": "object" + } + }, "required": [ "enablement" ], - "properties": { - "enablement": { - "description": "Feature enablement entries updated by this request.", - "type": "object", - "additionalProperties": { - "type": "boolean" - } - } - } + "title": "ExperimentalFeatureEnablementSetResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureListParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureListParams.json index 69d935bb..ab562edb 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureListParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureListParams.json @@ -1,7 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExperimentalFeatureListParams", - "type": "object", "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -12,12 +10,14 @@ }, "limit": { "description": "Optional page size; defaults to a reasonable server-side value.", + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] } - } + }, + "title": "ExperimentalFeatureListParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureListResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureListResponse.json index f9d5efa8..25398fc0 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureListResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ExperimentalFeatureListResponse.json @@ -1,34 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ExperimentalFeatureListResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/ExperimentalFeature" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - }, "definitions": { "ExperimentalFeature": { - "type": "object", - "required": [ - "defaultEnabled", - "enabled", - "name", - "stage" - ], "properties": { "announcement": { "description": "Announcement copy shown to users when the feature is introduced. Null when this feature is not in beta.", @@ -64,53 +37,80 @@ "type": "string" }, "stage": { - "description": "Lifecycle stage of this feature flag.", "allOf": [ { "$ref": "#/definitions/ExperimentalFeatureStage" } - ] + ], + "description": "Lifecycle stage of this feature flag." } - } + }, + "required": [ + "defaultEnabled", + "enabled", + "name", + "stage" + ], + "type": "object" }, "ExperimentalFeatureStage": { "oneOf": [ { "description": "Feature is available for user testing and feedback.", - "type": "string", "enum": [ "beta" - ] + ], + "type": "string" }, { "description": "Feature is still being built and not ready for broad use.", - "type": "string", "enum": [ "underDevelopment" - ] + ], + "type": "string" }, { "description": "Feature is production-ready.", - "type": "string", "enum": [ "stable" - ] + ], + "type": "string" }, { "description": "Feature is deprecated and should be avoided.", - "type": "string", "enum": [ "deprecated" - ] + ], + "type": "string" }, { "description": "Feature flag is retained only for backwards compatibility.", - "type": "string", "enum": [ "removed" - ] + ], + "type": "string" } ] } - } + }, + "properties": { + "data": { + "items": { + "$ref": "#/definitions/ExperimentalFeature" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ExperimentalFeatureListResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadParams.json index 3bb6ddb4..07c20986 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadParams.json @@ -1,23 +1,17 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FeedbackUploadParams", - "type": "object", - "required": [ - "classification", - "includeLogs" - ], "properties": { "classification": { "type": "string" }, "extraLogFiles": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "includeLogs": { "type": "boolean" @@ -29,13 +23,13 @@ ] }, "tags": { + "additionalProperties": { + "type": "string" + }, "type": [ "object", "null" - ], - "additionalProperties": { - "type": "string" - } + ] }, "threadId": { "type": [ @@ -43,5 +37,11 @@ "null" ] } - } + }, + "required": [ + "classification", + "includeLogs" + ], + "title": "FeedbackUploadParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadResponse.json index 73bde860..647b613f 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadResponse.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FeedbackUploadResponse", - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "title": "FeedbackUploadResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FileChangeOutputDeltaNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FileChangeOutputDeltaNotification.json index 989f4458..2b3abd67 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FileChangeOutputDeltaNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FileChangeOutputDeltaNotification.json @@ -1,13 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FileChangeOutputDeltaNotification", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], "properties": { "delta": { "type": "string" @@ -21,5 +13,13 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "FileChangeOutputDeltaNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FileChangePatchUpdatedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FileChangePatchUpdatedNotification.json index b1699f04..0ae44aa9 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FileChangePatchUpdatedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FileChangePatchUpdatedNotification.json @@ -1,19 +1,90 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FileChangePatchUpdatedNotification", - "type": "object", - "required": [ - "changes", - "itemId", - "threadId", - "turnId" - ], + "definitions": { + "FileUpdateChange": { + "properties": { + "diff": { + "type": "string" + }, + "kind": { + "$ref": "#/definitions/PatchChangeKind" + }, + "path": { + "type": "string" + } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" + }, + "PatchChangeKind": { + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "add" + ], + "title": "AddPatchChangeKindType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "delete" + ], + "title": "DeletePatchChangeKindType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { + "properties": { + "move_path": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "update" + ], + "title": "UpdatePatchChangeKindType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" + } + ] + } + }, "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "itemId": { "type": "string" @@ -25,83 +96,12 @@ "type": "string" } }, - "definitions": { - "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], - "properties": { - "diff": { - "type": "string" - }, - "kind": { - "$ref": "#/definitions/PatchChangeKind" - }, - "path": { - "type": "string" - } - } - }, - "PatchChangeKind": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "add" - ], - "title": "AddPatchChangeKindType" - } - }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "delete" - ], - "title": "DeletePatchChangeKindType" - } - }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "move_path": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "update" - ], - "title": "UpdatePatchChangeKindType" - } - }, - "title": "UpdatePatchChangeKind" - } - ] - } - } + "required": [ + "changes", + "itemId", + "threadId", + "turnId" + ], + "title": "FileChangePatchUpdatedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsChangedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsChangedNotification.json index 508b911f..cfb9f4e5 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsChangedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsChangedNotification.json @@ -1,29 +1,29 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsChangedNotification", + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + } + }, "description": "Filesystem watch notification emitted for `fs/watch` subscribers.", - "type": "object", - "required": [ - "changedPaths", - "watchId" - ], "properties": { "changedPaths": { "description": "File or directory paths associated with this event.", - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" }, "watchId": { "description": "Watch identifier previously provided to `fs/watch`.", "type": "string" } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - } - } + "required": [ + "changedPaths", + "watchId" + ], + "title": "FsChangedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCopyParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCopyParams.json index a6cd7066..2994fcac 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCopyParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCopyParams.json @@ -1,38 +1,38 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsCopyParams", + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + } + }, "description": "Copy a file or directory tree on the host filesystem.", - "type": "object", - "required": [ - "destinationPath", - "sourcePath" - ], "properties": { "destinationPath": { - "description": "Absolute destination path.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute destination path." }, "recursive": { "description": "Required for directory copies; ignored for file copies.", "type": "boolean" }, "sourcePath": { - "description": "Absolute source path.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute source path." } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - } - } + "required": [ + "destinationPath", + "sourcePath" + ], + "title": "FsCopyParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCopyResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCopyResponse.json index f36e78ab..b1088b3a 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCopyResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCopyResponse.json @@ -1,6 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsCopyResponse", "description": "Successful response for `fs/copy`.", + "title": "FsCopyResponse", "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCreateDirectoryParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCreateDirectoryParams.json index 9d3afb52..a1ac4a8d 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCreateDirectoryParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCreateDirectoryParams.json @@ -1,19 +1,20 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsCreateDirectoryParams", + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + } + }, "description": "Create a directory on the host filesystem.", - "type": "object", - "required": [ - "path" - ], "properties": { "path": { - "description": "Absolute directory path to create.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute directory path to create." }, "recursive": { "description": "Whether parent directories should also be created. Defaults to `true`.", @@ -23,10 +24,9 @@ ] } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - } - } + "required": [ + "path" + ], + "title": "FsCreateDirectoryParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCreateDirectoryResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCreateDirectoryResponse.json index b822f1a3..d07e1189 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCreateDirectoryResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsCreateDirectoryResponse.json @@ -1,6 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsCreateDirectoryResponse", "description": "Successful response for `fs/createDirectory`.", + "title": "FsCreateDirectoryResponse", "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsGetMetadataParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsGetMetadataParams.json index f8c8ce0b..c7028749 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsGetMetadataParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsGetMetadataParams.json @@ -1,25 +1,25 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsGetMetadataParams", - "description": "Request metadata for an absolute path.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Absolute path to inspect.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" } - } + }, + "description": "Request metadata for an absolute path.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Absolute path to inspect." + } + }, + "required": [ + "path" + ], + "title": "FsGetMetadataParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsGetMetadataResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsGetMetadataResponse.json index 386d248c..82481f57 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsGetMetadataResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsGetMetadataResponse.json @@ -1,20 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsGetMetadataResponse", "description": "Metadata returned by `fs/getMetadata`.", - "type": "object", - "required": [ - "createdAtMs", - "isDirectory", - "isFile", - "isSymlink", - "modifiedAtMs" - ], "properties": { "createdAtMs": { "description": "File creation time in Unix milliseconds when available, otherwise `0`.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "isDirectory": { "description": "Whether the path resolves to a directory.", @@ -30,8 +21,17 @@ }, "modifiedAtMs": { "description": "File modification time in Unix milliseconds when available, otherwise `0`.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } - } + }, + "required": [ + "createdAtMs", + "isDirectory", + "isFile", + "isSymlink", + "modifiedAtMs" + ], + "title": "FsGetMetadataResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadDirectoryParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadDirectoryParams.json index e454f26a..e531fe9f 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadDirectoryParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadDirectoryParams.json @@ -1,25 +1,25 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsReadDirectoryParams", - "description": "List direct child names for a directory.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Absolute directory path to read.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" } - } + }, + "description": "List direct child names for a directory.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Absolute directory path to read." + } + }, + "required": [ + "path" + ], + "title": "FsReadDirectoryParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadDirectoryResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadDirectoryResponse.json index 9e98fbee..61f7a3e6 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadDirectoryResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadDirectoryResponse.json @@ -1,29 +1,8 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsReadDirectoryResponse", - "description": "Directory entries returned by `fs/readDirectory`.", - "type": "object", - "required": [ - "entries" - ], - "properties": { - "entries": { - "description": "Direct child entries in the requested directory.", - "type": "array", - "items": { - "$ref": "#/definitions/FsReadDirectoryEntry" - } - } - }, "definitions": { "FsReadDirectoryEntry": { "description": "A directory entry returned by `fs/readDirectory`.", - "type": "object", - "required": [ - "fileName", - "isDirectory", - "isFile" - ], "properties": { "fileName": { "description": "Direct child entry name only, not an absolute or relative path.", @@ -37,7 +16,28 @@ "description": "Whether this entry resolves to a regular file.", "type": "boolean" } - } + }, + "required": [ + "fileName", + "isDirectory", + "isFile" + ], + "type": "object" } - } + }, + "description": "Directory entries returned by `fs/readDirectory`.", + "properties": { + "entries": { + "description": "Direct child entries in the requested directory.", + "items": { + "$ref": "#/definitions/FsReadDirectoryEntry" + }, + "type": "array" + } + }, + "required": [ + "entries" + ], + "title": "FsReadDirectoryResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadFileParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadFileParams.json index 64074e28..e1df6018 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadFileParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadFileParams.json @@ -1,25 +1,25 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsReadFileParams", - "description": "Read a file from the host filesystem.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Absolute path to read.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" } - } + }, + "description": "Read a file from the host filesystem.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Absolute path to read." + } + }, + "required": [ + "path" + ], + "title": "FsReadFileParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadFileResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadFileResponse.json index 1e7a6a33..c746cf93 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadFileResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsReadFileResponse.json @@ -1,15 +1,15 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsReadFileResponse", "description": "Base64-encoded file contents returned by `fs/readFile`.", - "type": "object", - "required": [ - "dataBase64" - ], "properties": { "dataBase64": { "description": "File contents encoded as base64.", "type": "string" } - } + }, + "required": [ + "dataBase64" + ], + "title": "FsReadFileResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsRemoveParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsRemoveParams.json index bc407263..d6289d46 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsRemoveParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsRemoveParams.json @@ -1,11 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsRemoveParams", + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + } + }, "description": "Remove a file or directory tree from the host filesystem.", - "type": "object", - "required": [ - "path" - ], "properties": { "force": { "description": "Whether missing paths should be ignored. Defaults to `true`.", @@ -15,12 +16,12 @@ ] }, "path": { - "description": "Absolute path to remove.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute path to remove." }, "recursive": { "description": "Whether directory removal should recurse. Defaults to `true`.", @@ -30,10 +31,9 @@ ] } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - } - } + "required": [ + "path" + ], + "title": "FsRemoveParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsRemoveResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsRemoveResponse.json index b52829fb..d1ec5d11 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsRemoveResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsRemoveResponse.json @@ -1,6 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsRemoveResponse", "description": "Successful response for `fs/remove`.", + "title": "FsRemoveResponse", "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsUnwatchParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsUnwatchParams.json index 137d86da..f46800e9 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsUnwatchParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsUnwatchParams.json @@ -1,15 +1,15 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsUnwatchParams", "description": "Stop filesystem watch notifications for a prior `fs/watch`.", - "type": "object", - "required": [ - "watchId" - ], "properties": { "watchId": { "description": "Watch identifier previously provided to `fs/watch`.", "type": "string" } - } + }, + "required": [ + "watchId" + ], + "title": "FsUnwatchParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsUnwatchResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsUnwatchResponse.json index 1cf264c3..daa80ad6 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsUnwatchResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsUnwatchResponse.json @@ -1,6 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsUnwatchResponse", "description": "Successful response for `fs/unwatch`.", + "title": "FsUnwatchResponse", "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWatchParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWatchParams.json index 4ee07ba1..29a1ceea 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWatchParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWatchParams.json @@ -1,30 +1,30 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsWatchParams", + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + } + }, "description": "Start filesystem watch notifications for an absolute path.", - "type": "object", - "required": [ - "path", - "watchId" - ], "properties": { "path": { - "description": "Absolute file or directory path to watch.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute file or directory path to watch." }, "watchId": { "description": "Connection-scoped watch identifier used for `fs/unwatch` and `fs/changed`.", "type": "string" } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - } - } + "required": [ + "path", + "watchId" + ], + "title": "FsWatchParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWatchResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWatchResponse.json index b3cce432..abc7d466 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWatchResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWatchResponse.json @@ -1,25 +1,25 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsWatchResponse", - "description": "Successful response for `fs/watch`.", - "type": "object", - "required": [ - "path" - ], - "properties": { - "path": { - "description": "Canonicalized path associated with the watch.", - "allOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - } - ] - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" } - } + }, + "description": "Successful response for `fs/watch`.", + "properties": { + "path": { + "allOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + } + ], + "description": "Canonicalized path associated with the watch." + } + }, + "required": [ + "path" + ], + "title": "FsWatchResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWriteFileParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWriteFileParams.json index 774c190b..e1b5eabd 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWriteFileParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWriteFileParams.json @@ -1,30 +1,30 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsWriteFileParams", + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + } + }, "description": "Write a file on the host filesystem.", - "type": "object", - "required": [ - "dataBase64", - "path" - ], "properties": { "dataBase64": { "description": "File contents encoded as base64.", "type": "string" }, "path": { - "description": "Absolute path to write.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Absolute path to write." } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - } - } + "required": [ + "dataBase64", + "path" + ], + "title": "FsWriteFileParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWriteFileResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWriteFileResponse.json index ba9a84fe..07ba35cd 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWriteFileResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/FsWriteFileResponse.json @@ -1,6 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "FsWriteFileResponse", "description": "Successful response for `fs/writeFile`.", + "title": "FsWriteFileResponse", "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountParams.json index f5ea18de..ca18a451 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountParams.json @@ -1,12 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "GetAccountParams", - "type": "object", "properties": { "refreshToken": { - "description": "When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.", "default": false, + "description": "When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.", "type": "boolean" } - } + }, + "title": "GetAccountParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountRateLimitsResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountRateLimitsResponse.json index 0f0a327f..8f7db24e 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountRateLimitsResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountRateLimitsResponse.json @@ -1,37 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "GetAccountRateLimitsResponse", - "type": "object", - "required": [ - "rateLimits" - ], - "properties": { - "rateLimits": { - "description": "Backward-compatible single-bucket view; mirrors the historical payload.", - "allOf": [ - { - "$ref": "#/definitions/RateLimitSnapshot" - } - ] - }, - "rateLimitsByLimitId": { - "description": "Multi-bucket view keyed by metered `limit_id` (for example, `codex`).", - "type": [ - "object", - "null" - ], - "additionalProperties": { - "$ref": "#/definitions/RateLimitSnapshot" - } - } - }, "definitions": { "CreditsSnapshot": { - "type": "object", - "required": [ - "hasCredits", - "unlimited" - ], "properties": { "balance": { "type": [ @@ -45,10 +15,14 @@ "unlimited": { "type": "boolean" } - } + }, + "required": [ + "hasCredits", + "unlimited" + ], + "type": "object" }, "PlanType": { - "type": "string", "enum": [ "free", "go", @@ -62,20 +36,20 @@ "enterprise", "edu", "unknown" - ] + ], + "type": "string" }, "RateLimitReachedType": { - "type": "string", "enum": [ "rate_limit_reached", "workspace_owner_credits_depleted", "workspace_member_credits_depleted", "workspace_owner_usage_limit_reached", "workspace_member_usage_limit_reached" - ] + ], + "type": "string" }, "RateLimitSnapshot": { - "type": "object", "properties": { "credits": { "anyOf": [ @@ -139,33 +113,59 @@ } ] } - } + }, + "type": "object" }, "RateLimitWindow": { - "type": "object", + "properties": { + "resetsAt": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "usedPercent": { + "format": "int32", + "type": "integer" + }, + "windowDurationMins": { + "format": "int64", + "type": [ + "integer", + "null" + ] + } + }, "required": [ "usedPercent" ], - "properties": { - "resetsAt": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "usedPercent": { - "type": "integer", - "format": "int32" - }, - "windowDurationMins": { - "type": [ - "integer", - "null" - ], - "format": "int64" - } - } + "type": "object" } - } + }, + "properties": { + "rateLimits": { + "allOf": [ + { + "$ref": "#/definitions/RateLimitSnapshot" + } + ], + "description": "Backward-compatible single-bucket view; mirrors the historical payload." + }, + "rateLimitsByLimitId": { + "additionalProperties": { + "$ref": "#/definitions/RateLimitSnapshot" + }, + "description": "Multi-bucket view keyed by metered `limit_id` (for example, `codex`).", + "type": [ + "object", + "null" + ] + } + }, + "required": [ + "rateLimits" + ], + "title": "GetAccountRateLimitsResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountResponse.json index 6b4ed1da..85349271 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GetAccountResponse.json @@ -1,10 +1,68 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "GetAccountResponse", - "type": "object", - "required": [ - "requiresOpenaiAuth" - ], + "definitions": { + "Account": { + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "apiKey" + ], + "title": "ApiKeyAccountType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "ApiKeyAccount", + "type": "object" + }, + { + "properties": { + "email": { + "type": "string" + }, + "planType": { + "$ref": "#/definitions/PlanType" + }, + "type": { + "enum": [ + "chatgpt" + ], + "title": "ChatgptAccountType", + "type": "string" + } + }, + "required": [ + "email", + "planType", + "type" + ], + "title": "ChatgptAccount", + "type": "object" + } + ] + }, + "PlanType": { + "enum": [ + "free", + "go", + "plus", + "pro", + "prolite", + "team", + "self_serve_business_usage_based", + "business", + "enterprise_cbp_usage_based", + "enterprise", + "edu", + "unknown" + ], + "type": "string" + } + }, "properties": { "account": { "anyOf": [ @@ -20,67 +78,9 @@ "type": "boolean" } }, - "definitions": { - "Account": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "apiKey" - ], - "title": "ApiKeyAccountType" - } - }, - "title": "ApiKeyAccount" - }, - { - "type": "object", - "required": [ - "email", - "planType", - "type" - ], - "properties": { - "email": { - "type": "string" - }, - "planType": { - "$ref": "#/definitions/PlanType" - }, - "type": { - "type": "string", - "enum": [ - "chatgpt" - ], - "title": "ChatgptAccountType" - } - }, - "title": "ChatgptAccount" - } - ] - }, - "PlanType": { - "type": "string", - "enum": [ - "free", - "go", - "plus", - "pro", - "prolite", - "team", - "self_serve_business_usage_based", - "business", - "enterprise_cbp_usage_based", - "enterprise", - "edu", - "unknown" - ] - } - } + "required": [ + "requiresOpenaiAuth" + ], + "title": "GetAccountResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GuardianWarningNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GuardianWarningNotification.json index 14608eb6..5a4ef82f 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GuardianWarningNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/GuardianWarningNotification.json @@ -1,11 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "GuardianWarningNotification", - "type": "object", - "required": [ - "message", - "threadId" - ], "properties": { "message": { "description": "Concise guardian warning message for the user.", @@ -15,5 +9,11 @@ "description": "Thread target for the guardian warning.", "type": "string" } - } + }, + "required": [ + "message", + "threadId" + ], + "title": "GuardianWarningNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/HookCompletedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/HookCompletedNotification.json index 3233134d..a4d37864 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/HookCompletedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/HookCompletedNotification.json @@ -1,32 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "HookCompletedNotification", - "type": "object", - "required": [ - "run", - "threadId" - ], - "properties": { - "run": { - "$ref": "#/definitions/HookRunSummary" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": [ - "string", - "null" - ] - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "HookEventName": { - "type": "string", "enum": [ "preToolUse", "permissionRequest", @@ -34,29 +13,25 @@ "sessionStart", "userPromptSubmit", "stop" - ] + ], + "type": "string" }, "HookExecutionMode": { - "type": "string", "enum": [ "sync", "async" - ] + ], + "type": "string" }, "HookHandlerType": { - "type": "string", "enum": [ "command", "prompt", "agent" - ] + ], + "type": "string" }, "HookOutputEntry": { - "type": "object", - "required": [ - "kind", - "text" - ], "properties": { "kind": { "$ref": "#/definitions/HookOutputEntryKind" @@ -64,66 +39,58 @@ "text": { "type": "string" } - } + }, + "required": [ + "kind", + "text" + ], + "type": "object" }, "HookOutputEntryKind": { - "type": "string", "enum": [ "warning", "stop", "feedback", "context", "error" - ] + ], + "type": "string" }, "HookRunStatus": { - "type": "string", "enum": [ "running", "completed", "failed", "blocked", "stopped" - ] + ], + "type": "string" }, "HookRunSummary": { - "type": "object", - "required": [ - "displayOrder", - "entries", - "eventName", - "executionMode", - "handlerType", - "id", - "scope", - "sourcePath", - "startedAt", - "status" - ], "properties": { "completedAt": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "displayOrder": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "durationMs": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "entries": { - "type": "array", "items": { "$ref": "#/definitions/HookOutputEntry" - } + }, + "type": "array" }, "eventName": { "$ref": "#/definitions/HookEventName" @@ -141,19 +108,19 @@ "$ref": "#/definitions/HookScope" }, "source": { - "default": "unknown", "allOf": [ { "$ref": "#/definitions/HookSource" } - ] + ], + "default": "unknown" }, "sourcePath": { "$ref": "#/definitions/AbsolutePathBuf" }, "startedAt": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "status": { "$ref": "#/definitions/HookRunStatus" @@ -164,17 +131,29 @@ "null" ] } - } + }, + "required": [ + "displayOrder", + "entries", + "eventName", + "executionMode", + "handlerType", + "id", + "scope", + "sourcePath", + "startedAt", + "status" + ], + "type": "object" }, "HookScope": { - "type": "string", "enum": [ "thread", "turn" - ] + ], + "type": "string" }, "HookSource": { - "type": "string", "enum": [ "system", "user", @@ -184,7 +163,28 @@ "legacyManagedConfigFile", "legacyManagedConfigMdm", "unknown" + ], + "type": "string" + } + }, + "properties": { + "run": { + "$ref": "#/definitions/HookRunSummary" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": [ + "string", + "null" ] } - } + }, + "required": [ + "run", + "threadId" + ], + "title": "HookCompletedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/HookStartedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/HookStartedNotification.json index 12e7cc9e..ac77d616 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/HookStartedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/HookStartedNotification.json @@ -1,32 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "HookStartedNotification", - "type": "object", - "required": [ - "run", - "threadId" - ], - "properties": { - "run": { - "$ref": "#/definitions/HookRunSummary" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": [ - "string", - "null" - ] - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "HookEventName": { - "type": "string", "enum": [ "preToolUse", "permissionRequest", @@ -34,29 +13,25 @@ "sessionStart", "userPromptSubmit", "stop" - ] + ], + "type": "string" }, "HookExecutionMode": { - "type": "string", "enum": [ "sync", "async" - ] + ], + "type": "string" }, "HookHandlerType": { - "type": "string", "enum": [ "command", "prompt", "agent" - ] + ], + "type": "string" }, "HookOutputEntry": { - "type": "object", - "required": [ - "kind", - "text" - ], "properties": { "kind": { "$ref": "#/definitions/HookOutputEntryKind" @@ -64,66 +39,58 @@ "text": { "type": "string" } - } + }, + "required": [ + "kind", + "text" + ], + "type": "object" }, "HookOutputEntryKind": { - "type": "string", "enum": [ "warning", "stop", "feedback", "context", "error" - ] + ], + "type": "string" }, "HookRunStatus": { - "type": "string", "enum": [ "running", "completed", "failed", "blocked", "stopped" - ] + ], + "type": "string" }, "HookRunSummary": { - "type": "object", - "required": [ - "displayOrder", - "entries", - "eventName", - "executionMode", - "handlerType", - "id", - "scope", - "sourcePath", - "startedAt", - "status" - ], "properties": { "completedAt": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "displayOrder": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "durationMs": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "entries": { - "type": "array", "items": { "$ref": "#/definitions/HookOutputEntry" - } + }, + "type": "array" }, "eventName": { "$ref": "#/definitions/HookEventName" @@ -141,19 +108,19 @@ "$ref": "#/definitions/HookScope" }, "source": { - "default": "unknown", "allOf": [ { "$ref": "#/definitions/HookSource" } - ] + ], + "default": "unknown" }, "sourcePath": { "$ref": "#/definitions/AbsolutePathBuf" }, "startedAt": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "status": { "$ref": "#/definitions/HookRunStatus" @@ -164,17 +131,29 @@ "null" ] } - } + }, + "required": [ + "displayOrder", + "entries", + "eventName", + "executionMode", + "handlerType", + "id", + "scope", + "sourcePath", + "startedAt", + "status" + ], + "type": "object" }, "HookScope": { - "type": "string", "enum": [ "thread", "turn" - ] + ], + "type": "string" }, "HookSource": { - "type": "string", "enum": [ "system", "user", @@ -184,7 +163,28 @@ "legacyManagedConfigFile", "legacyManagedConfigMdm", "unknown" + ], + "type": "string" + } + }, + "properties": { + "run": { + "$ref": "#/definitions/HookRunSummary" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": [ + "string", + "null" ] } - } + }, + "required": [ + "run", + "threadId" + ], + "title": "HookStartedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemCompletedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemCompletedNotification.json index f8ac6aa5..fecaccb5 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemCompletedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemCompletedNotification.json @@ -1,52 +1,30 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ItemCompletedNotification", - "type": "object", - "required": [ - "item", - "threadId", - "turnId" - ], - "properties": { - "item": { - "$ref": "#/definitions/ThreadItem" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -57,10 +35,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -69,36 +50,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -110,21 +85,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -136,21 +113,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -168,114 +145,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -286,14 +262,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -301,80 +278,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -382,75 +357,78 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -459,20 +437,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -480,21 +461,18 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -503,77 +481,74 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -581,10 +556,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -592,29 +567,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -623,59 +599,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -690,34 +663,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -730,40 +703,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -772,34 +747,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -840,42 +813,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -899,33 +873,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -946,7 +918,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -954,52 +925,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -1018,22 +994,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1042,23 +1018,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1086,22 +1061,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1110,22 +1086,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1134,114 +1110,114 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -1250,33 +1226,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -1285,27 +1263,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1314,13 +1292,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -1329,11 +1307,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1342,25 +1320,47 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "item": { + "$ref": "#/definitions/ThreadItem" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "item", + "threadId", + "turnId" + ], + "title": "ItemCompletedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemGuardianApprovalReviewCompletedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemGuardianApprovalReviewCompletedNotification.json index 90eafb6a..27716e59 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemGuardianApprovalReviewCompletedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemGuardianApprovalReviewCompletedNotification.json @@ -1,91 +1,51 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ItemGuardianApprovalReviewCompletedNotification", - "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", - "type": "object", - "required": [ - "action", - "decisionSource", - "review", - "reviewId", - "threadId", - "turnId" - ], - "properties": { - "action": { - "$ref": "#/definitions/GuardianApprovalReviewAction" - }, - "decisionSource": { - "$ref": "#/definitions/AutoReviewDecisionSource" - }, - "review": { - "$ref": "#/definitions/GuardianApprovalReview" - }, - "reviewId": { - "description": "Stable identifier for this review.", - "type": "string" - }, - "targetItemId": { - "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "AdditionalFileSystemPermissions": { - "type": "object", "properties": { "entries": { + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - } + ] }, "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 1.0 + ] }, "read": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } + ] }, "write": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } + ] } - } + }, + "type": "object" }, "AdditionalNetworkPermissions": { - "type": "object", "properties": { "enabled": { "type": [ @@ -93,93 +53,89 @@ "null" ] } - } + }, + "type": "object" }, "AutoReviewDecisionSource": { "description": "[UNSTABLE] Source that produced a terminal approval auto-review decision.", - "type": "string", "enum": [ "agent" - ] + ], + "type": "string" }, "FileSystemAccessMode": { - "type": "string", "enum": [ "read", "write", "none" - ] + ], + "type": "string" }, "FileSystemPath": { "oneOf": [ { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "path" ], - "title": "PathFileSystemPathType" + "title": "PathFileSystemPathType", + "type": "string" } }, - "title": "PathFileSystemPath" - }, - { - "type": "object", "required": [ - "pattern", + "path", "type" ], + "title": "PathFileSystemPath", + "type": "object" + }, + { "properties": { "pattern": { "type": "string" }, "type": { - "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType" + "title": "GlobPatternFileSystemPathType", + "type": "string" } }, - "title": "GlobPatternFileSystemPath" + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType" + "title": "SpecialFileSystemPathType", + "type": "string" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "title": "SpecialFileSystemPath" + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" } ] }, "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -187,66 +143,67 @@ "path": { "$ref": "#/definitions/FileSystemPath" } - } + }, + "required": [ + "access", + "path" + ], + "type": "object" }, "FileSystemSpecialPath": { "oneOf": [ { - "type": "object", - "required": [ - "kind" - ], "properties": { "kind": { - "type": "string", "enum": [ "root" - ] + ], + "type": "string" } }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "minimal" - ] + ], + "type": "string" } }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "current_working_directory" - ] + ], + "type": "string" } }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "project_roots" - ] + ], + "type": "string" }, "subpath": { "type": [ @@ -255,50 +212,49 @@ ] } }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "tmpdir" - ] + ], + "type": "string" } }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" }, { - "type": "object", - "required": [ - "kind", - "path" - ], "properties": { "kind": { - "type": "string", "enum": [ "unknown" - ] + ], + "type": "string" }, "path": { "type": "string" @@ -309,16 +265,17 @@ "null" ] } - } + }, + "required": [ + "kind", + "path" + ], + "type": "object" } ] }, "GuardianApprovalReview": { "description": "[UNSTABLE] Temporary approval auto-review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.", - "type": "object", - "required": [ - "status" - ], "properties": { "rationale": { "type": [ @@ -349,18 +306,15 @@ } ] } - } + }, + "required": [ + "status" + ], + "type": "object" }, "GuardianApprovalReviewAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "cwd", - "source", - "type" - ], "properties": { "command": { "type": "string" @@ -372,30 +326,29 @@ "$ref": "#/definitions/GuardianCommandSource" }, "type": { - "type": "string", "enum": [ "command" ], - "title": "CommandGuardianApprovalReviewActionType" + "title": "CommandGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "CommandGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "argv", + "command", "cwd", - "program", "source", "type" ], + "title": "CommandGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "argv": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "cwd": { "$ref": "#/definitions/AbsolutePathBuf" @@ -407,59 +360,59 @@ "$ref": "#/definitions/GuardianCommandSource" }, "type": { - "type": "string", "enum": [ "execve" ], - "title": "ExecveGuardianApprovalReviewActionType" + "title": "ExecveGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "ExecveGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ + "argv", "cwd", - "files", + "program", + "source", "type" ], + "title": "ExecveGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "cwd": { "$ref": "#/definitions/AbsolutePathBuf" }, "files": { - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "applyPatch" ], - "title": "ApplyPatchGuardianApprovalReviewActionType" + "title": "ApplyPatchGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "ApplyPatchGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "host", - "port", - "protocol", - "target", + "cwd", + "files", "type" ], + "title": "ApplyPatchGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "host": { "type": "string" }, "port": { - "type": "integer", "format": "uint16", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "protocol": { "$ref": "#/definitions/NetworkApprovalProtocol" @@ -468,22 +421,24 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "networkAccess" ], - "title": "NetworkAccessGuardianApprovalReviewActionType" + "title": "NetworkAccessGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "NetworkAccessGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "server", - "toolName", + "host", + "port", + "protocol", + "target", "type" ], + "title": "NetworkAccessGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "connectorId": { "type": [ @@ -510,21 +465,22 @@ ] }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallGuardianApprovalReviewActionType" + "title": "McpToolCallGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "McpToolCallGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "permissions", + "server", + "toolName", "type" ], + "title": "McpToolCallGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "permissions": { "$ref": "#/definitions/RequestPermissionProfile" @@ -536,66 +492,71 @@ ] }, "type": { - "type": "string", "enum": [ "requestPermissions" ], - "title": "RequestPermissionsGuardianApprovalReviewActionType" + "title": "RequestPermissionsGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "RequestPermissionsGuardianApprovalReviewAction" + "required": [ + "permissions", + "type" + ], + "title": "RequestPermissionsGuardianApprovalReviewAction", + "type": "object" } ] }, "GuardianApprovalReviewStatus": { "description": "[UNSTABLE] Lifecycle state for an approval auto-review.", - "type": "string", "enum": [ "inProgress", "approved", "denied", "timedOut", "aborted" - ] + ], + "type": "string" }, "GuardianCommandSource": { - "type": "string", "enum": [ "shell", "unifiedExec" - ] + ], + "type": "string" }, "GuardianRiskLevel": { "description": "[UNSTABLE] Risk level assigned by approval auto-review.", - "type": "string", "enum": [ "low", "medium", "high", "critical" - ] + ], + "type": "string" }, "GuardianUserAuthorization": { "description": "[UNSTABLE] Authorization level assigned by approval auto-review.", - "type": "string", "enum": [ "unknown", "low", "medium", "high" - ] + ], + "type": "string" }, "NetworkApprovalProtocol": { - "type": "string", "enum": [ "http", "https", "socks5Tcp", "socks5Udp" - ] + ], + "type": "string" }, "RequestPermissionProfile": { - "type": "object", + "additionalProperties": false, "properties": { "fileSystem": { "anyOf": [ @@ -618,7 +579,46 @@ ] } }, - "additionalProperties": false + "type": "object" } - } + }, + "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", + "properties": { + "action": { + "$ref": "#/definitions/GuardianApprovalReviewAction" + }, + "decisionSource": { + "$ref": "#/definitions/AutoReviewDecisionSource" + }, + "review": { + "$ref": "#/definitions/GuardianApprovalReview" + }, + "reviewId": { + "description": "Stable identifier for this review.", + "type": "string" + }, + "targetItemId": { + "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", + "type": [ + "string", + "null" + ] + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "action", + "decisionSource", + "review", + "reviewId", + "threadId", + "turnId" + ], + "title": "ItemGuardianApprovalReviewCompletedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemGuardianApprovalReviewStartedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemGuardianApprovalReviewStartedNotification.json index 216afce5..c039f219 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemGuardianApprovalReviewStartedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemGuardianApprovalReviewStartedNotification.json @@ -1,87 +1,51 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ItemGuardianApprovalReviewStartedNotification", - "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", - "type": "object", - "required": [ - "action", - "review", - "reviewId", - "threadId", - "turnId" - ], - "properties": { - "action": { - "$ref": "#/definitions/GuardianApprovalReviewAction" - }, - "review": { - "$ref": "#/definitions/GuardianApprovalReview" - }, - "reviewId": { - "description": "Stable identifier for this review.", - "type": "string" - }, - "targetItemId": { - "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", - "type": [ - "string", - "null" - ] - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "AdditionalFileSystemPermissions": { - "type": "object", "properties": { "entries": { + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - } + ] }, "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 1.0 + ] }, "read": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } + ] }, "write": { + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } + ] } - } + }, + "type": "object" }, "AdditionalNetworkPermissions": { - "type": "object", "properties": { "enabled": { "type": [ @@ -89,86 +53,82 @@ "null" ] } - } + }, + "type": "object" }, "FileSystemAccessMode": { - "type": "string", "enum": [ "read", "write", "none" - ] + ], + "type": "string" }, "FileSystemPath": { "oneOf": [ { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "path" ], - "title": "PathFileSystemPathType" + "title": "PathFileSystemPathType", + "type": "string" } }, - "title": "PathFileSystemPath" - }, - { - "type": "object", "required": [ - "pattern", + "path", "type" ], + "title": "PathFileSystemPath", + "type": "object" + }, + { "properties": { "pattern": { "type": "string" }, "type": { - "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType" + "title": "GlobPatternFileSystemPathType", + "type": "string" } }, - "title": "GlobPatternFileSystemPath" + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType" + "title": "SpecialFileSystemPathType", + "type": "string" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "title": "SpecialFileSystemPath" + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" } ] }, "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -176,66 +136,67 @@ "path": { "$ref": "#/definitions/FileSystemPath" } - } + }, + "required": [ + "access", + "path" + ], + "type": "object" }, "FileSystemSpecialPath": { "oneOf": [ { - "type": "object", - "required": [ - "kind" - ], "properties": { "kind": { - "type": "string", "enum": [ "root" - ] + ], + "type": "string" } }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "minimal" - ] + ], + "type": "string" } }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "current_working_directory" - ] + ], + "type": "string" } }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "project_roots" - ] + ], + "type": "string" }, "subpath": { "type": [ @@ -244,50 +205,49 @@ ] } }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "tmpdir" - ] + ], + "type": "string" } }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" }, { - "type": "object", - "required": [ - "kind", - "path" - ], "properties": { "kind": { - "type": "string", "enum": [ "unknown" - ] + ], + "type": "string" }, "path": { "type": "string" @@ -298,16 +258,17 @@ "null" ] } - } + }, + "required": [ + "kind", + "path" + ], + "type": "object" } ] }, "GuardianApprovalReview": { "description": "[UNSTABLE] Temporary approval auto-review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.", - "type": "object", - "required": [ - "status" - ], "properties": { "rationale": { "type": [ @@ -338,18 +299,15 @@ } ] } - } + }, + "required": [ + "status" + ], + "type": "object" }, "GuardianApprovalReviewAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "cwd", - "source", - "type" - ], "properties": { "command": { "type": "string" @@ -361,30 +319,29 @@ "$ref": "#/definitions/GuardianCommandSource" }, "type": { - "type": "string", "enum": [ "command" ], - "title": "CommandGuardianApprovalReviewActionType" + "title": "CommandGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "CommandGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "argv", + "command", "cwd", - "program", "source", "type" ], + "title": "CommandGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "argv": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "cwd": { "$ref": "#/definitions/AbsolutePathBuf" @@ -396,59 +353,59 @@ "$ref": "#/definitions/GuardianCommandSource" }, "type": { - "type": "string", "enum": [ "execve" ], - "title": "ExecveGuardianApprovalReviewActionType" + "title": "ExecveGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "ExecveGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ + "argv", "cwd", - "files", + "program", + "source", "type" ], + "title": "ExecveGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "cwd": { "$ref": "#/definitions/AbsolutePathBuf" }, "files": { - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "applyPatch" ], - "title": "ApplyPatchGuardianApprovalReviewActionType" + "title": "ApplyPatchGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "ApplyPatchGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "host", - "port", - "protocol", - "target", + "cwd", + "files", "type" ], + "title": "ApplyPatchGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "host": { "type": "string" }, "port": { - "type": "integer", "format": "uint16", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "protocol": { "$ref": "#/definitions/NetworkApprovalProtocol" @@ -457,22 +414,24 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "networkAccess" ], - "title": "NetworkAccessGuardianApprovalReviewActionType" + "title": "NetworkAccessGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "NetworkAccessGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "server", - "toolName", + "host", + "port", + "protocol", + "target", "type" ], + "title": "NetworkAccessGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "connectorId": { "type": [ @@ -499,21 +458,22 @@ ] }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallGuardianApprovalReviewActionType" + "title": "McpToolCallGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "McpToolCallGuardianApprovalReviewAction" - }, - { - "type": "object", "required": [ - "permissions", + "server", + "toolName", "type" ], + "title": "McpToolCallGuardianApprovalReviewAction", + "type": "object" + }, + { "properties": { "permissions": { "$ref": "#/definitions/RequestPermissionProfile" @@ -525,66 +485,71 @@ ] }, "type": { - "type": "string", "enum": [ "requestPermissions" ], - "title": "RequestPermissionsGuardianApprovalReviewActionType" + "title": "RequestPermissionsGuardianApprovalReviewActionType", + "type": "string" } }, - "title": "RequestPermissionsGuardianApprovalReviewAction" + "required": [ + "permissions", + "type" + ], + "title": "RequestPermissionsGuardianApprovalReviewAction", + "type": "object" } ] }, "GuardianApprovalReviewStatus": { "description": "[UNSTABLE] Lifecycle state for an approval auto-review.", - "type": "string", "enum": [ "inProgress", "approved", "denied", "timedOut", "aborted" - ] + ], + "type": "string" }, "GuardianCommandSource": { - "type": "string", "enum": [ "shell", "unifiedExec" - ] + ], + "type": "string" }, "GuardianRiskLevel": { "description": "[UNSTABLE] Risk level assigned by approval auto-review.", - "type": "string", "enum": [ "low", "medium", "high", "critical" - ] + ], + "type": "string" }, "GuardianUserAuthorization": { "description": "[UNSTABLE] Authorization level assigned by approval auto-review.", - "type": "string", "enum": [ "unknown", "low", "medium", "high" - ] + ], + "type": "string" }, "NetworkApprovalProtocol": { - "type": "string", "enum": [ "http", "https", "socks5Tcp", "socks5Udp" - ] + ], + "type": "string" }, "RequestPermissionProfile": { - "type": "object", + "additionalProperties": false, "properties": { "fileSystem": { "anyOf": [ @@ -607,7 +572,42 @@ ] } }, - "additionalProperties": false + "type": "object" } - } + }, + "description": "[UNSTABLE] Temporary notification payload for approval auto-review. This shape is expected to change soon.", + "properties": { + "action": { + "$ref": "#/definitions/GuardianApprovalReviewAction" + }, + "review": { + "$ref": "#/definitions/GuardianApprovalReview" + }, + "reviewId": { + "description": "Stable identifier for this review.", + "type": "string" + }, + "targetItemId": { + "description": "Identifier for the reviewed item or tool call when one exists.\n\nIn most cases, one review maps to one target item. The exceptions are - execve reviews, where a single command may contain multiple execve calls to review (only possible when using the shell_zsh_fork feature) - network policy reviews, where there is no target item\n\nA network call is triggered by a CommandExecution item, so having a target_item_id set to the CommandExecution item would be misleading because the review is about the network call, not the command execution. Therefore, target_item_id is set to None for network policy reviews.", + "type": [ + "string", + "null" + ] + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "action", + "review", + "reviewId", + "threadId", + "turnId" + ], + "title": "ItemGuardianApprovalReviewStartedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemStartedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemStartedNotification.json index 7b51e4a4..6a7f975c 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemStartedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ItemStartedNotification.json @@ -1,52 +1,30 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ItemStartedNotification", - "type": "object", - "required": [ - "item", - "threadId", - "turnId" - ], - "properties": { - "item": { - "$ref": "#/definitions/ThreadItem" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -57,10 +35,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -69,36 +50,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -110,21 +85,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -136,21 +113,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -168,114 +145,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -286,14 +262,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -301,80 +278,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -382,75 +357,78 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -459,20 +437,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -480,21 +461,18 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -503,77 +481,74 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -581,10 +556,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -592,29 +567,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -623,59 +599,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -690,34 +663,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -730,40 +703,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -772,34 +747,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -840,42 +813,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -899,33 +873,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -946,7 +918,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -954,52 +925,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -1018,22 +994,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1042,23 +1018,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1086,22 +1061,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1110,22 +1086,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1134,114 +1110,114 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -1250,33 +1226,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -1285,27 +1263,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1314,13 +1292,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -1329,11 +1307,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1342,25 +1320,47 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "item": { + "$ref": "#/definitions/ThreadItem" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "item", + "threadId", + "turnId" + ], + "title": "ItemStartedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusParams.json index ca6c7490..52149d9f 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusParams.json @@ -1,7 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ListMcpServerStatusParams", - "type": "object", + "definitions": { + "McpServerStatusDetail": { + "enum": [ + "full", + "toolsAndAuthOnly" + ], + "type": "string" + } + }, "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -11,7 +18,6 @@ ] }, "detail": { - "description": "Controls how much MCP inventory data to fetch for each server. Defaults to `Full` when omitted.", "anyOf": [ { "$ref": "#/definitions/McpServerStatusDetail" @@ -19,25 +25,19 @@ { "type": "null" } - ] + ], + "description": "Controls how much MCP inventory data to fetch for each server. Defaults to `Full` when omitted." }, "limit": { "description": "Optional page size; defaults to a server-defined value.", + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 - } - }, - "definitions": { - "McpServerStatusDetail": { - "type": "string", - "enum": [ - "full", - "toolsAndAuthOnly" ] } - } + }, + "title": "ListMcpServerStatusParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusResponse.json index 5f129f84..fc181c27 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusResponse.json @@ -1,44 +1,16 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ListMcpServerStatusResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/McpServerStatus" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - }, "definitions": { "McpAuthStatus": { - "type": "string", "enum": [ "unsupported", "notLoggedIn", "bearerToken", "oAuth" - ] + ], + "type": "string" }, "McpServerStatus": { - "type": "object", - "required": [ - "authStatus", - "name", - "resourceTemplates", - "resources", - "tools" - ], "properties": { "authStatus": { "$ref": "#/definitions/McpAuthStatus" @@ -47,32 +19,35 @@ "type": "string" }, "resourceTemplates": { - "type": "array", "items": { "$ref": "#/definitions/ResourceTemplate" - } + }, + "type": "array" }, "resources": { - "type": "array", "items": { "$ref": "#/definitions/Resource" - } + }, + "type": "array" }, "tools": { - "type": "object", "additionalProperties": { "$ref": "#/definitions/Tool" - } + }, + "type": "object" } - } + }, + "required": [ + "authStatus", + "name", + "resourceTemplates", + "resources", + "tools" + ], + "type": "object" }, "Resource": { "description": "A known resource that the server is capable of reading.", - "type": "object", - "required": [ - "name", - "uri" - ], "properties": { "_meta": true, "annotations": true, @@ -83,11 +58,11 @@ ] }, "icons": { + "items": true, "type": [ "array", "null" - ], - "items": true + ] }, "mimeType": { "type": [ @@ -99,11 +74,11 @@ "type": "string" }, "size": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "title": { "type": [ @@ -114,15 +89,15 @@ "uri": { "type": "string" } - } + }, + "required": [ + "name", + "uri" + ], + "type": "object" }, "ResourceTemplate": { "description": "A template description for resources available on the server.", - "type": "object", - "required": [ - "name", - "uriTemplate" - ], "properties": { "annotations": true, "description": { @@ -149,15 +124,15 @@ "uriTemplate": { "type": "string" } - } + }, + "required": [ + "name", + "uriTemplate" + ], + "type": "object" }, "Tool": { "description": "Definition for a tool the client can call.", - "type": "object", - "required": [ - "inputSchema", - "name" - ], "properties": { "_meta": true, "annotations": true, @@ -168,11 +143,11 @@ ] }, "icons": { + "items": true, "type": [ "array", "null" - ], - "items": true + ] }, "inputSchema": true, "name": { @@ -185,7 +160,32 @@ "null" ] } - } + }, + "required": [ + "inputSchema", + "name" + ], + "type": "object" } - } + }, + "properties": { + "data": { + "items": { + "$ref": "#/definitions/McpServerStatus" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ListMcpServerStatusResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/LoginAccountParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/LoginAccountParams.json index 9f3be7ff..a933b71a 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/LoginAccountParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/LoginAccountParams.json @@ -1,67 +1,60 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "LoginAccountParams", "oneOf": [ { - "type": "object", - "required": [ - "apiKey", - "type" - ], "properties": { "apiKey": { "type": "string" }, "type": { - "type": "string", "enum": [ "apiKey" ], - "title": "ApiKeyv2::LoginAccountParamsType" + "title": "ApiKeyv2::LoginAccountParamsType", + "type": "string" } }, - "title": "ApiKeyv2::LoginAccountParams" - }, - { - "type": "object", "required": [ + "apiKey", "type" ], + "title": "ApiKeyv2::LoginAccountParams", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "chatgpt" ], - "title": "Chatgptv2::LoginAccountParamsType" + "title": "Chatgptv2::LoginAccountParamsType", + "type": "string" } }, - "title": "Chatgptv2::LoginAccountParams" - }, - { - "type": "object", "required": [ "type" ], + "title": "Chatgptv2::LoginAccountParams", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "chatgptDeviceCode" ], - "title": "ChatgptDeviceCodev2::LoginAccountParamsType" + "title": "ChatgptDeviceCodev2::LoginAccountParamsType", + "type": "string" } }, - "title": "ChatgptDeviceCodev2::LoginAccountParams" + "required": [ + "type" + ], + "title": "ChatgptDeviceCodev2::LoginAccountParams", + "type": "object" }, { "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE. The access token must contain the same scopes that Codex-managed ChatGPT auth tokens have.", - "type": "object", - "required": [ - "accessToken", - "chatgptAccountId", - "type" - ], "properties": { "accessToken": { "description": "Access token (JWT) supplied by the client. This token is used for backend API requests and email extraction.", @@ -79,14 +72,21 @@ ] }, "type": { - "type": "string", "enum": [ "chatgptAuthTokens" ], - "title": "ChatgptAuthTokensv2::LoginAccountParamsType" + "title": "ChatgptAuthTokensv2::LoginAccountParamsType", + "type": "string" } }, - "title": "ChatgptAuthTokensv2::LoginAccountParams" + "required": [ + "accessToken", + "chatgptAccountId", + "type" + ], + "title": "ChatgptAuthTokensv2::LoginAccountParams", + "type": "object" } - ] + ], + "title": "LoginAccountParams" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/LoginAccountResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/LoginAccountResponse.json index b98fb05c..a800bffc 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/LoginAccountResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/LoginAccountResponse.json @@ -1,30 +1,23 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "LoginAccountResponse", "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "apiKey" ], - "title": "ApiKeyv2::LoginAccountResponseType" + "title": "ApiKeyv2::LoginAccountResponseType", + "type": "string" } }, - "title": "ApiKeyv2::LoginAccountResponse" - }, - { - "type": "object", "required": [ - "authUrl", - "loginId", "type" ], + "title": "ApiKeyv2::LoginAccountResponse", + "type": "object" + }, + { "properties": { "authUrl": { "description": "URL the client should open in a browser to initiate the OAuth flow.", @@ -34,33 +27,32 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "chatgpt" ], - "title": "Chatgptv2::LoginAccountResponseType" + "title": "Chatgptv2::LoginAccountResponseType", + "type": "string" } }, - "title": "Chatgptv2::LoginAccountResponse" + "required": [ + "authUrl", + "loginId", + "type" + ], + "title": "Chatgptv2::LoginAccountResponse", + "type": "object" }, { - "type": "object", - "required": [ - "loginId", - "type", - "userCode", - "verificationUrl" - ], "properties": { "loginId": { "type": "string" }, "type": { - "type": "string", "enum": [ "chatgptDeviceCode" ], - "title": "ChatgptDeviceCodev2::LoginAccountResponseType" + "title": "ChatgptDeviceCodev2::LoginAccountResponseType", + "type": "string" }, "userCode": { "description": "One-time code the user must enter after signing in.", @@ -71,23 +63,31 @@ "type": "string" } }, - "title": "ChatgptDeviceCodev2::LoginAccountResponse" + "required": [ + "loginId", + "type", + "userCode", + "verificationUrl" + ], + "title": "ChatgptDeviceCodev2::LoginAccountResponse", + "type": "object" }, { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "chatgptAuthTokens" ], - "title": "ChatgptAuthTokensv2::LoginAccountResponseType" + "title": "ChatgptAuthTokensv2::LoginAccountResponseType", + "type": "string" } }, - "title": "ChatgptAuthTokensv2::LoginAccountResponse" + "required": [ + "type" + ], + "title": "ChatgptAuthTokensv2::LoginAccountResponse", + "type": "object" } - ] + ], + "title": "LoginAccountResponse" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpResourceReadParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpResourceReadParams.json index 9fc87fd1..2fe58155 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpResourceReadParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpResourceReadParams.json @@ -1,11 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpResourceReadParams", - "type": "object", - "required": [ - "server", - "uri" - ], "properties": { "server": { "type": "string" @@ -19,5 +13,11 @@ "uri": { "type": "string" } - } + }, + "required": [ + "server", + "uri" + ], + "title": "McpResourceReadParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpResourceReadResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpResourceReadResponse.json index 4bd9d22b..b1a40123 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpResourceReadResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpResourceReadResponse.json @@ -1,28 +1,9 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpResourceReadResponse", - "type": "object", - "required": [ - "contents" - ], - "properties": { - "contents": { - "type": "array", - "items": { - "$ref": "#/definitions/ResourceContent" - } - } - }, "definitions": { "ResourceContent": { - "description": "Contents returned when reading a resource from an MCP server.", "anyOf": [ { - "type": "object", - "required": [ - "text", - "uri" - ], "properties": { "_meta": true, "mimeType": { @@ -38,14 +19,14 @@ "description": "The URI of this resource.", "type": "string" } - } - }, - { - "type": "object", + }, "required": [ - "blob", + "text", "uri" ], + "type": "object" + }, + { "properties": { "_meta": true, "blob": { @@ -61,9 +42,28 @@ "description": "The URI of this resource.", "type": "string" } - } + }, + "required": [ + "blob", + "uri" + ], + "type": "object" } - ] + ], + "description": "Contents returned when reading a resource from an MCP server." } - } + }, + "properties": { + "contents": { + "items": { + "$ref": "#/definitions/ResourceContent" + }, + "type": "array" + } + }, + "required": [ + "contents" + ], + "title": "McpResourceReadResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginCompletedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginCompletedNotification.json index 3a89236c..35efd2ba 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginCompletedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginCompletedNotification.json @@ -1,11 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerOauthLoginCompletedNotification", - "type": "object", - "required": [ - "name", - "success" - ], "properties": { "error": { "type": [ @@ -19,5 +13,11 @@ "success": { "type": "boolean" } - } + }, + "required": [ + "name", + "success" + ], + "title": "McpServerOauthLoginCompletedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginParams.json index 0c7343c9..4370f444 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginParams.json @@ -1,29 +1,29 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerOauthLoginParams", - "type": "object", - "required": [ - "name" - ], "properties": { "name": { "type": "string" }, "scopes": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "timeoutSecs": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] } - } + }, + "required": [ + "name" + ], + "title": "McpServerOauthLoginParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginResponse.json index d65af19b..efeb612d 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginResponse.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerOauthLoginResponse", - "type": "object", - "required": [ - "authorizationUrl" - ], "properties": { "authorizationUrl": { "type": "string" } - } + }, + "required": [ + "authorizationUrl" + ], + "title": "McpServerOauthLoginResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerStatusUpdatedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerStatusUpdatedNotification.json index 9e2708c0..b0e2cd5a 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerStatusUpdatedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerStatusUpdatedNotification.json @@ -1,11 +1,16 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerStatusUpdatedNotification", - "type": "object", - "required": [ - "name", - "status" - ], + "definitions": { + "McpServerStartupState": { + "enum": [ + "starting", + "ready", + "failed", + "cancelled" + ], + "type": "string" + } + }, "properties": { "error": { "type": [ @@ -20,15 +25,10 @@ "$ref": "#/definitions/McpServerStartupState" } }, - "definitions": { - "McpServerStartupState": { - "type": "string", - "enum": [ - "starting", - "ready", - "failed", - "cancelled" - ] - } - } + "required": [ + "name", + "status" + ], + "title": "McpServerStatusUpdatedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerToolCallParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerToolCallParams.json index bc1de9c0..3465e60c 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerToolCallParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerToolCallParams.json @@ -1,12 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerToolCallParams", - "type": "object", - "required": [ - "server", - "threadId", - "tool" - ], "properties": { "_meta": true, "arguments": true, @@ -19,5 +12,12 @@ "tool": { "type": "string" } - } + }, + "required": [ + "server", + "threadId", + "tool" + ], + "title": "McpServerToolCallParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerToolCallResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerToolCallResponse.json index 2fedb1ee..0e5ecdf7 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerToolCallResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpServerToolCallResponse.json @@ -1,15 +1,10 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpServerToolCallResponse", - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "isError": { "type": [ @@ -18,5 +13,10 @@ ] }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "title": "McpServerToolCallResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpToolCallProgressNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpToolCallProgressNotification.json index ce627dc7..419cab74 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpToolCallProgressNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/McpToolCallProgressNotification.json @@ -1,13 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "McpToolCallProgressNotification", - "type": "object", - "required": [ - "itemId", - "message", - "threadId", - "turnId" - ], "properties": { "itemId": { "type": "string" @@ -21,5 +13,13 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "itemId", + "message", + "threadId", + "turnId" + ], + "title": "McpToolCallProgressNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ModelListParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ModelListParams.json index cd7bb256..11a34762 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ModelListParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ModelListParams.json @@ -1,7 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ModelListParams", - "type": "object", "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -19,12 +17,14 @@ }, "limit": { "description": "Optional page size; defaults to a reasonable server-side value.", + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] } - } + }, + "title": "ModelListParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ModelListResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ModelListResponse.json index e29eb31c..dc60c5b7 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ModelListResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ModelListResponse.json @@ -1,64 +1,33 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ModelListResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/Model" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - }, "definitions": { "InputModality": { "description": "Canonical user-input modality tags advertised by a model.", "oneOf": [ { "description": "Plain text turns and tool payloads.", - "type": "string", "enum": [ "text" - ] + ], + "type": "string" }, { "description": "Image attachments included in user turns.", - "type": "string", "enum": [ "image" - ] + ], + "type": "string" } ] }, "Model": { - "type": "object", - "required": [ - "defaultReasoningEffort", - "description", - "displayName", - "hidden", - "id", - "isDefault", - "model", - "supportedReasoningEfforts" - ], "properties": { "additionalSpeedTiers": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "availabilityNux": { "anyOf": [ @@ -90,10 +59,10 @@ "text", "image" ], - "type": "array", "items": { "$ref": "#/definitions/InputModality" - } + }, + "type": "array" }, "isDefault": { "type": "boolean" @@ -102,10 +71,10 @@ "type": "string" }, "supportedReasoningEfforts": { - "type": "array", "items": { "$ref": "#/definitions/ReasoningEffortOption" - } + }, + "type": "array" }, "supportsPersonality": { "default": false, @@ -127,24 +96,31 @@ } ] } - } + }, + "required": [ + "defaultReasoningEffort", + "description", + "displayName", + "hidden", + "id", + "isDefault", + "model", + "supportedReasoningEfforts" + ], + "type": "object" }, "ModelAvailabilityNux": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "ModelUpgradeInfo": { - "type": "object", - "required": [ - "model" - ], "properties": { "migrationMarkdown": { "type": [ @@ -167,11 +143,14 @@ "null" ] } - } + }, + "required": [ + "model" + ], + "type": "object" }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -179,14 +158,10 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "ReasoningEffortOption": { - "type": "object", - "required": [ - "description", - "reasoningEffort" - ], "properties": { "description": { "type": "string" @@ -194,7 +169,32 @@ "reasoningEffort": { "$ref": "#/definitions/ReasoningEffort" } - } + }, + "required": [ + "description", + "reasoningEffort" + ], + "type": "object" } - } + }, + "properties": { + "data": { + "items": { + "$ref": "#/definitions/Model" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ModelListResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ModelReroutedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ModelReroutedNotification.json index 1de3b92e..b9bcc491 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ModelReroutedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ModelReroutedNotification.json @@ -1,14 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ModelReroutedNotification", - "type": "object", - "required": [ - "fromModel", - "reason", - "threadId", - "toModel", - "turnId" - ], + "definitions": { + "ModelRerouteReason": { + "enum": [ + "highRiskCyberActivity" + ], + "type": "string" + } + }, "properties": { "fromModel": { "type": "string" @@ -26,12 +25,13 @@ "type": "string" } }, - "definitions": { - "ModelRerouteReason": { - "type": "string", - "enum": [ - "highRiskCyberActivity" - ] - } - } + "required": [ + "fromModel", + "reason", + "threadId", + "toModel", + "turnId" + ], + "title": "ModelReroutedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/PlanDeltaNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/PlanDeltaNotification.json index baf0c8eb..64463926 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/PlanDeltaNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/PlanDeltaNotification.json @@ -1,14 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "PlanDeltaNotification", "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items. Clients should not assume concatenated deltas match the completed plan item content.", - "type": "object", - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], "properties": { "delta": { "type": "string" @@ -22,5 +14,13 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "PlanDeltaNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/RawResponseItemCompletedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/RawResponseItemCompletedNotification.json index 0a982ef5..956e3b25 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/RawResponseItemCompletedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/RawResponseItemCompletedNotification.json @@ -1,52 +1,29 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "RawResponseItemCompletedNotification", - "type": "object", - "required": [ - "item", - "threadId", - "turnId" - ], - "properties": { - "item": { - "$ref": "#/definitions/ResponseItem" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - }, "definitions": { "ContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "input_text" ], - "title": "InputTextContentItemType" + "title": "InputTextContentItemType", + "type": "string" } }, - "title": "InputTextContentItem" - }, - { - "type": "object", "required": [ - "image_url", + "text", "type" ], + "title": "InputTextContentItem", + "type": "object" + }, + { "properties": { "detail": { "anyOf": [ @@ -62,34 +39,39 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "input_image" ], - "title": "InputImageContentItemType" + "title": "InputImageContentItemType", + "type": "string" } }, - "title": "InputImageContentItem" - }, - { - "type": "object", "required": [ - "text", + "image_url", "type" ], + "title": "InputImageContentItem", + "type": "object" + }, + { "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "output_text" ], - "title": "OutputTextContentItemType" + "title": "OutputTextContentItemType", + "type": "string" } }, - "title": "OutputTextContentItem" + "required": [ + "text", + "type" + ], + "title": "OutputTextContentItem", + "type": "object" } ] }, @@ -99,10 +81,10 @@ "type": "string" }, { - "type": "array", "items": { "$ref": "#/definitions/FunctionCallOutputContentItem" - } + }, + "type": "array" } ] }, @@ -110,31 +92,26 @@ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.", "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "input_text" ], - "title": "InputTextFunctionCallOutputContentItemType" + "title": "InputTextFunctionCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextFunctionCallOutputContentItem" - }, - { - "type": "object", "required": [ - "image_url", + "text", "type" ], + "title": "InputTextFunctionCallOutputContentItem", + "type": "object" + }, + { "properties": { "detail": { "anyOf": [ @@ -150,25 +127,24 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "input_image" ], - "title": "InputImageFunctionCallOutputContentItemType" + "title": "InputImageFunctionCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageFunctionCallOutputContentItem" + "required": [ + "image_url", + "type" + ], + "title": "InputImageFunctionCallOutputContentItem", + "type": "object" } ] }, "GhostCommit": { "description": "Details of a ghost commit created from a repository state.", - "type": "object", - "required": [ - "id", - "preexisting_untracked_dirs", - "preexisting_untracked_files" - ], "properties": { "id": { "type": "string" @@ -180,66 +156,67 @@ ] }, "preexisting_untracked_dirs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "preexisting_untracked_files": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "required": [ + "id", + "preexisting_untracked_dirs", + "preexisting_untracked_files" + ], + "type": "object" }, "ImageDetail": { - "type": "string", "enum": [ "auto", "low", "high", "original" - ] + ], + "type": "string" }, "LocalShellAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "type" - ], "properties": { "command": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "env": { + "additionalProperties": { + "type": "string" + }, "type": [ "object", "null" - ], - "additionalProperties": { - "type": "string" - } + ] }, "timeout_ms": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "type": { - "type": "string", "enum": [ "exec" ], - "title": "ExecLocalShellActionType" + "title": "ExecLocalShellActionType", + "type": "string" }, "user": { "type": [ @@ -254,120 +231,119 @@ ] } }, - "title": "ExecLocalShellAction" + "required": [ + "command", + "type" + ], + "title": "ExecLocalShellAction", + "type": "object" } ] }, "LocalShellStatus": { - "type": "string", "enum": [ "completed", "in_progress", "incomplete" - ] + ], + "type": "string" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "ReasoningItemContent": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "reasoning_text" ], - "title": "ReasoningTextReasoningItemContentType" + "title": "ReasoningTextReasoningItemContentType", + "type": "string" } }, - "title": "ReasoningTextReasoningItemContent" - }, - { - "type": "object", "required": [ "text", "type" ], + "title": "ReasoningTextReasoningItemContent", + "type": "object" + }, + { "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextReasoningItemContentType" + "title": "TextReasoningItemContentType", + "type": "string" } }, - "title": "TextReasoningItemContent" + "required": [ + "text", + "type" + ], + "title": "TextReasoningItemContent", + "type": "object" } ] }, "ReasoningItemReasoningSummary": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "summary_text" ], - "title": "SummaryTextReasoningItemReasoningSummaryType" + "title": "SummaryTextReasoningItemReasoningSummaryType", + "type": "string" } }, - "title": "SummaryTextReasoningItemReasoningSummary" + "required": [ + "text", + "type" + ], + "title": "SummaryTextReasoningItemReasoningSummary", + "type": "object" } ] }, "ResponseItem": { "oneOf": [ { - "type": "object", - "required": [ - "content", - "role", - "type" - ], "properties": { "content": { - "type": "array", "items": { "$ref": "#/definitions/ContentItem" - } + }, + "type": "array" }, "end_turn": { "type": [ @@ -376,11 +352,11 @@ ] }, "id": { - "writeOnly": true, "type": [ "string", "null" - ] + ], + "writeOnly": true }, "phase": { "anyOf": [ @@ -396,31 +372,32 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "message" ], - "title": "MessageResponseItemType" + "title": "MessageResponseItemType", + "type": "string" } }, - "title": "MessageResponseItem" - }, - { - "type": "object", "required": [ - "summary", + "content", + "role", "type" ], + "title": "MessageResponseItem", + "type": "object" + }, + { "properties": { "content": { "default": null, + "items": { + "$ref": "#/definitions/ReasoningItemContent" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/ReasoningItemContent" - } + ] }, "encrypted_content": { "type": [ @@ -429,28 +406,27 @@ ] }, "summary": { - "type": "array", "items": { "$ref": "#/definitions/ReasoningItemReasoningSummary" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningResponseItemType" + "title": "ReasoningResponseItemType", + "type": "string" } }, - "title": "ReasoningResponseItem" - }, - { - "type": "object", "required": [ - "action", - "status", + "summary", "type" ], + "title": "ReasoningResponseItem", + "type": "object" + }, + { "properties": { "action": { "$ref": "#/definitions/LocalShellAction" @@ -464,33 +440,32 @@ }, "id": { "description": "Legacy id field retained for compatibility with older payloads.", - "writeOnly": true, "type": [ "string", "null" - ] + ], + "writeOnly": true }, "status": { "$ref": "#/definitions/LocalShellStatus" }, "type": { - "type": "string", "enum": [ "local_shell_call" ], - "title": "LocalShellCallResponseItemType" + "title": "LocalShellCallResponseItemType", + "type": "string" } }, - "title": "LocalShellCallResponseItem" - }, - { - "type": "object", "required": [ - "arguments", - "call_id", - "name", + "action", + "status", "type" ], + "title": "LocalShellCallResponseItem", + "type": "object" + }, + { "properties": { "arguments": { "type": "string" @@ -499,11 +474,11 @@ "type": "string" }, "id": { - "writeOnly": true, "type": [ "string", "null" - ] + ], + "writeOnly": true }, "name": { "type": "string" @@ -515,22 +490,23 @@ ] }, "type": { - "type": "string", "enum": [ "function_call" ], - "title": "FunctionCallResponseItemType" + "title": "FunctionCallResponseItemType", + "type": "string" } }, - "title": "FunctionCallResponseItem" - }, - { - "type": "object", "required": [ "arguments", - "execution", + "call_id", + "name", "type" ], + "title": "FunctionCallResponseItem", + "type": "object" + }, + { "properties": { "arguments": true, "call_id": { @@ -543,11 +519,11 @@ "type": "string" }, "id": { - "writeOnly": true, "type": [ "string", "null" - ] + ], + "writeOnly": true }, "status": { "type": [ @@ -556,22 +532,22 @@ ] }, "type": { - "type": "string", "enum": [ "tool_search_call" ], - "title": "ToolSearchCallResponseItemType" + "title": "ToolSearchCallResponseItemType", + "type": "string" } }, - "title": "ToolSearchCallResponseItem" - }, - { - "type": "object", "required": [ - "call_id", - "output", + "arguments", + "execution", "type" ], + "title": "ToolSearchCallResponseItem", + "type": "object" + }, + { "properties": { "call_id": { "type": "string" @@ -580,33 +556,32 @@ "$ref": "#/definitions/FunctionCallOutputBody" }, "type": { - "type": "string", "enum": [ "function_call_output" ], - "title": "FunctionCallOutputResponseItemType" + "title": "FunctionCallOutputResponseItemType", + "type": "string" } }, - "title": "FunctionCallOutputResponseItem" - }, - { - "type": "object", "required": [ "call_id", - "input", - "name", + "output", "type" ], + "title": "FunctionCallOutputResponseItem", + "type": "object" + }, + { "properties": { "call_id": { "type": "string" }, "id": { - "writeOnly": true, "type": [ "string", "null" - ] + ], + "writeOnly": true }, "input": { "type": "string" @@ -621,22 +596,23 @@ ] }, "type": { - "type": "string", "enum": [ "custom_tool_call" ], - "title": "CustomToolCallResponseItemType" + "title": "CustomToolCallResponseItemType", + "type": "string" } }, - "title": "CustomToolCallResponseItem" - }, - { - "type": "object", "required": [ "call_id", - "output", + "input", + "name", "type" ], + "title": "CustomToolCallResponseItem", + "type": "object" + }, + { "properties": { "call_id": { "type": "string" @@ -651,23 +627,22 @@ "$ref": "#/definitions/FunctionCallOutputBody" }, "type": { - "type": "string", "enum": [ "custom_tool_call_output" ], - "title": "CustomToolCallOutputResponseItemType" + "title": "CustomToolCallOutputResponseItemType", + "type": "string" } }, - "title": "CustomToolCallOutputResponseItem" - }, - { - "type": "object", "required": [ - "execution", - "status", - "tools", + "call_id", + "output", "type" ], + "title": "CustomToolCallOutputResponseItem", + "type": "object" + }, + { "properties": { "call_id": { "type": [ @@ -682,24 +657,27 @@ "type": "string" }, "tools": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "type": { - "type": "string", "enum": [ "tool_search_output" ], - "title": "ToolSearchOutputResponseItemType" + "title": "ToolSearchOutputResponseItemType", + "type": "string" } }, - "title": "ToolSearchOutputResponseItem" - }, - { - "type": "object", "required": [ + "execution", + "status", + "tools", "type" ], + "title": "ToolSearchOutputResponseItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -712,11 +690,11 @@ ] }, "id": { - "writeOnly": true, "type": [ "string", "null" - ] + ], + "writeOnly": true }, "status": { "type": [ @@ -725,23 +703,20 @@ ] }, "type": { - "type": "string", "enum": [ "web_search_call" ], - "title": "WebSearchCallResponseItemType" + "title": "WebSearchCallResponseItemType", + "type": "string" } }, - "title": "WebSearchCallResponseItem" - }, - { - "type": "object", "required": [ - "id", - "result", - "status", "type" ], + "title": "WebSearchCallResponseItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -759,89 +734,92 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "image_generation_call" ], - "title": "ImageGenerationCallResponseItemType" + "title": "ImageGenerationCallResponseItemType", + "type": "string" } }, - "title": "ImageGenerationCallResponseItem" - }, - { - "type": "object", "required": [ - "ghost_commit", + "id", + "result", + "status", "type" ], + "title": "ImageGenerationCallResponseItem", + "type": "object" + }, + { "properties": { "ghost_commit": { "$ref": "#/definitions/GhostCommit" }, "type": { - "type": "string", "enum": [ "ghost_snapshot" ], - "title": "GhostSnapshotResponseItemType" + "title": "GhostSnapshotResponseItemType", + "type": "string" } }, - "title": "GhostSnapshotResponseItem" - }, - { - "type": "object", "required": [ - "encrypted_content", + "ghost_commit", "type" ], + "title": "GhostSnapshotResponseItem", + "type": "object" + }, + { "properties": { "encrypted_content": { "type": "string" }, "type": { - "type": "string", "enum": [ "compaction" ], - "title": "CompactionResponseItemType" + "title": "CompactionResponseItemType", + "type": "string" } }, - "title": "CompactionResponseItem" - }, - { - "type": "object", "required": [ + "encrypted_content", "type" ], + "title": "CompactionResponseItem", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherResponseItemType" + "title": "OtherResponseItemType", + "type": "string" } }, - "title": "OtherResponseItem" + "required": [ + "type" + ], + "title": "OtherResponseItem", + "type": "object" } ] }, "ResponsesApiWebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -850,27 +828,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchResponsesApiWebSearchActionType" + "title": "SearchResponsesApiWebSearchActionType", + "type": "string" } }, - "title": "SearchResponsesApiWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchResponsesApiWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "open_page" ], - "title": "OpenPageResponsesApiWebSearchActionType" + "title": "OpenPageResponsesApiWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -879,13 +857,13 @@ ] } }, - "title": "OpenPageResponsesApiWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageResponsesApiWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -894,11 +872,11 @@ ] }, "type": { - "type": "string", "enum": [ "find_in_page" ], - "title": "FindInPageResponsesApiWebSearchActionType" + "title": "FindInPageResponsesApiWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -907,25 +885,47 @@ ] } }, - "title": "FindInPageResponsesApiWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageResponsesApiWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherResponsesApiWebSearchActionType" + "title": "OtherResponsesApiWebSearchActionType", + "type": "string" } }, - "title": "OtherResponsesApiWebSearchAction" + "required": [ + "type" + ], + "title": "OtherResponsesApiWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "item": { + "$ref": "#/definitions/ResponseItem" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + }, + "required": [ + "item", + "threadId", + "turnId" + ], + "title": "RawResponseItemCompletedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryPartAddedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryPartAddedNotification.json index b9e449ef..33debf2a 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryPartAddedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryPartAddedNotification.json @@ -1,20 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReasoningSummaryPartAddedNotification", - "type": "object", - "required": [ - "itemId", - "summaryIndex", - "threadId", - "turnId" - ], "properties": { "itemId": { "type": "string" }, "summaryIndex": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "threadId": { "type": "string" @@ -22,5 +14,13 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "itemId", + "summaryIndex", + "threadId", + "turnId" + ], + "title": "ReasoningSummaryPartAddedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryTextDeltaNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryTextDeltaNotification.json index 419c3a4d..6f50a840 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryTextDeltaNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryTextDeltaNotification.json @@ -1,14 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReasoningSummaryTextDeltaNotification", - "type": "object", - "required": [ - "delta", - "itemId", - "summaryIndex", - "threadId", - "turnId" - ], "properties": { "delta": { "type": "string" @@ -17,8 +8,8 @@ "type": "string" }, "summaryIndex": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "threadId": { "type": "string" @@ -26,5 +17,14 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "delta", + "itemId", + "summaryIndex", + "threadId", + "turnId" + ], + "title": "ReasoningSummaryTextDeltaNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReasoningTextDeltaNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReasoningTextDeltaNotification.json index d68ad40a..ebfd5dc8 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReasoningTextDeltaNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReasoningTextDeltaNotification.json @@ -1,18 +1,9 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReasoningTextDeltaNotification", - "type": "object", - "required": [ - "contentIndex", - "delta", - "itemId", - "threadId", - "turnId" - ], "properties": { "contentIndex": { - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "delta": { "type": "string" @@ -26,5 +17,14 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "contentIndex", + "delta", + "itemId", + "threadId", + "turnId" + ], + "title": "ReasoningTextDeltaNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReviewStartParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReviewStartParams.json index 9b799790..0089d464 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReviewStartParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReviewStartParams.json @@ -1,86 +1,55 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReviewStartParams", - "type": "object", - "required": [ - "target", - "threadId" - ], - "properties": { - "delivery": { - "description": "Where to run the review: inline (default) on the current thread or detached on a new thread (returned in `reviewThreadId`).", - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/ReviewDelivery" - }, - { - "type": "null" - } - ] - }, - "target": { - "$ref": "#/definitions/ReviewTarget" - }, - "threadId": { - "type": "string" - } - }, "definitions": { "ReviewDelivery": { - "type": "string", "enum": [ "inline", "detached" - ] + ], + "type": "string" }, "ReviewTarget": { "oneOf": [ { "description": "Review the working tree: staged, unstaged, and untracked files.", - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "uncommittedChanges" ], - "title": "UncommittedChangesReviewTargetType" + "title": "UncommittedChangesReviewTargetType", + "type": "string" } }, - "title": "UncommittedChangesReviewTarget" + "required": [ + "type" + ], + "title": "UncommittedChangesReviewTarget", + "type": "object" }, { "description": "Review changes between the current branch and the given base branch.", - "type": "object", - "required": [ - "branch", - "type" - ], "properties": { "branch": { "type": "string" }, "type": { - "type": "string", "enum": [ "baseBranch" ], - "title": "BaseBranchReviewTargetType" + "title": "BaseBranchReviewTargetType", + "type": "string" } }, - "title": "BaseBranchReviewTarget" + "required": [ + "branch", + "type" + ], + "title": "BaseBranchReviewTarget", + "type": "object" }, { "description": "Review the changes introduced by a specific commit.", - "type": "object", - "required": [ - "sha", - "type" - ], "properties": { "sha": { "type": "string" @@ -93,37 +62,68 @@ ] }, "type": { - "type": "string", "enum": [ "commit" ], - "title": "CommitReviewTargetType" + "title": "CommitReviewTargetType", + "type": "string" } }, - "title": "CommitReviewTarget" + "required": [ + "sha", + "type" + ], + "title": "CommitReviewTarget", + "type": "object" }, { "description": "Arbitrary instructions, equivalent to the old free-form prompt.", - "type": "object", - "required": [ - "instructions", - "type" - ], "properties": { "instructions": { "type": "string" }, "type": { - "type": "string", "enum": [ "custom" ], - "title": "CustomReviewTargetType" + "title": "CustomReviewTargetType", + "type": "string" } }, - "title": "CustomReviewTarget" + "required": [ + "instructions", + "type" + ], + "title": "CustomReviewTarget", + "type": "object" } ] } - } + }, + "properties": { + "delivery": { + "anyOf": [ + { + "$ref": "#/definitions/ReviewDelivery" + }, + { + "type": "null" + } + ], + "default": null, + "description": "Where to run the review: inline (default) on the current thread or detached on a new thread (returned in `reviewThreadId`)." + }, + "target": { + "$ref": "#/definitions/ReviewTarget" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "target", + "threadId" + ], + "title": "ReviewStartParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json index b29fd46d..01a1be20 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json @@ -1,49 +1,33 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ReviewStartResponse", - "type": "object", - "required": [ - "reviewThreadId", - "turn" - ], - "properties": { - "reviewThreadId": { - "description": "Identifies the thread where the review runs.\n\nFor inline reviews, this is the original thread id. For detached reviews, this is the id of the new review thread.", - "type": "string" - }, - "turn": { - "$ref": "#/definitions/Turn" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -54,132 +38,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -190,10 +171,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -202,36 +186,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -243,21 +221,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -269,21 +249,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -301,114 +281,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -419,14 +398,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -434,80 +414,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -515,82 +493,85 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -599,20 +580,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -620,21 +604,18 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -643,77 +624,74 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -721,10 +699,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -732,29 +710,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -763,59 +742,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -830,34 +806,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -870,40 +846,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -912,34 +890,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -980,42 +956,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -1039,33 +1016,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -1086,7 +1061,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -1094,52 +1068,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -1158,22 +1137,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1182,23 +1161,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1226,22 +1204,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1250,22 +1229,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1274,63 +1253,62 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -1338,36 +1316,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -1389,94 +1370,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -1485,33 +1464,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -1520,27 +1501,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1549,13 +1530,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -1564,11 +1545,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1577,25 +1558,44 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "reviewThreadId": { + "description": "Identifies the thread where the review runs.\n\nFor inline reviews, this is the original thread id. For detached reviews, this is the id of the new review thread.", + "type": "string" + }, + "turn": { + "$ref": "#/definitions/Turn" + } + }, + "required": [ + "reviewThreadId", + "turn" + ], + "title": "ReviewStartResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SendAddCreditsNudgeEmailParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SendAddCreditsNudgeEmailParams.json index 43f566f1..c3c63ede 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SendAddCreditsNudgeEmailParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SendAddCreditsNudgeEmailParams.json @@ -1,22 +1,22 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "SendAddCreditsNudgeEmailParams", - "type": "object", - "required": [ - "creditType" - ], + "definitions": { + "AddCreditsNudgeCreditType": { + "enum": [ + "credits", + "usage_limit" + ], + "type": "string" + } + }, "properties": { "creditType": { "$ref": "#/definitions/AddCreditsNudgeCreditType" } }, - "definitions": { - "AddCreditsNudgeCreditType": { - "type": "string", - "enum": [ - "credits", - "usage_limit" - ] - } - } + "required": [ + "creditType" + ], + "title": "SendAddCreditsNudgeEmailParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SendAddCreditsNudgeEmailResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SendAddCreditsNudgeEmailResponse.json index 57487b09..bfeba322 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SendAddCreditsNudgeEmailResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SendAddCreditsNudgeEmailResponse.json @@ -1,22 +1,22 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "SendAddCreditsNudgeEmailResponse", - "type": "object", - "required": [ - "status" - ], + "definitions": { + "AddCreditsNudgeEmailStatus": { + "enum": [ + "sent", + "cooldown_active" + ], + "type": "string" + } + }, "properties": { "status": { "$ref": "#/definitions/AddCreditsNudgeEmailStatus" } }, - "definitions": { - "AddCreditsNudgeEmailStatus": { - "type": "string", - "enum": [ - "sent", - "cooldown_active" - ] - } - } + "required": [ + "status" + ], + "title": "SendAddCreditsNudgeEmailResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ServerRequestResolvedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ServerRequestResolvedNotification.json index f0f21d75..18a5e760 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ServerRequestResolvedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ServerRequestResolvedNotification.json @@ -1,11 +1,18 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ServerRequestResolvedNotification", - "type": "object", - "required": [ - "requestId", - "threadId" - ], + "definitions": { + "RequestId": { + "anyOf": [ + { + "type": "string" + }, + { + "format": "int64", + "type": "integer" + } + ] + } + }, "properties": { "requestId": { "$ref": "#/definitions/RequestId" @@ -14,17 +21,10 @@ "type": "string" } }, - "definitions": { - "RequestId": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "integer", - "format": "int64" - } - ] - } - } + "required": [ + "requestId", + "threadId" + ], + "title": "ServerRequestResolvedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TerminalInteractionNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TerminalInteractionNotification.json index 823daeeb..ca2648a3 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TerminalInteractionNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TerminalInteractionNotification.json @@ -1,14 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TerminalInteractionNotification", - "type": "object", - "required": [ - "itemId", - "processId", - "stdin", - "threadId", - "turnId" - ], "properties": { "itemId": { "type": "string" @@ -25,5 +16,14 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "itemId", + "processId", + "stdin", + "threadId", + "turnId" + ], + "title": "TerminalInteractionNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadApproveGuardianDeniedActionParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadApproveGuardianDeniedActionParams.json index c9d4bfe2..3938815e 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadApproveGuardianDeniedActionParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadApproveGuardianDeniedActionParams.json @@ -1,11 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadApproveGuardianDeniedActionParams", - "type": "object", - "required": [ - "event", - "threadId" - ], "properties": { "event": { "description": "Serialized `codex_protocol::protocol::GuardianAssessmentEvent`." @@ -13,5 +7,11 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "event", + "threadId" + ], + "title": "ThreadApproveGuardianDeniedActionParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadArchiveParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadArchiveParams.json index 3784f876..49322b60 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadArchiveParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadArchiveParams.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadArchiveParams", - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "title": "ThreadArchiveParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadArchivedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadArchivedNotification.json index 83126d36..cd24f957 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadArchivedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadArchivedNotification.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadArchivedNotification", - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "title": "ThreadArchivedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadClosedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadClosedNotification.json index 0d2cf8ad..13e7f577 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadClosedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadClosedNotification.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadClosedNotification", - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "title": "ThreadClosedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadCompactStartParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadCompactStartParams.json index 0662c96b..a174ff95 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadCompactStartParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadCompactStartParams.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadCompactStartParams", - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "title": "ThreadCompactStartParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadEpiphanyJobsUpdatedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadEpiphanyJobsUpdatedNotification.json index b0a82ab1..90049743 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadEpiphanyJobsUpdatedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadEpiphanyJobsUpdatedNotification.json @@ -1,49 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadEpiphanyJobsUpdatedNotification", - "type": "object", - "required": [ - "source", - "threadId" - ], - "properties": { - "jobs": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanyJob" - } - }, - "source": { - "$ref": "#/definitions/ThreadEpiphanyJobsUpdatedSource" - }, - "stateRevision": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "threadId": { - "type": "string" - } - }, "definitions": { "ThreadEpiphanyJob": { - "type": "object", - "required": [ - "id", - "kind", - "ownerRole", - "scope", - "status" - ], "properties": { "activeThreadIds": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "authorityScope": { "type": [ @@ -67,30 +31,30 @@ "type": "string" }, "itemsProcessed": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "itemsTotal": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "kind": { "$ref": "#/definitions/ThreadEpiphanyJobKind" }, "lastCheckpointAtUnixSeconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "launcherJobId": { "type": [ @@ -99,16 +63,16 @@ ] }, "linkedGraphNodeIds": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linkedSubgoalIds": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "ownerRole": { "type": "string" @@ -125,19 +89,26 @@ "status": { "$ref": "#/definitions/ThreadEpiphanyJobStatus" } - } + }, + "required": [ + "id", + "kind", + "ownerRole", + "scope", + "status" + ], + "type": "object" }, "ThreadEpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "ThreadEpiphanyJobStatus": { - "type": "string", "enum": [ "idle", "needed", @@ -148,13 +119,42 @@ "cancelled", "blocked", "unavailable" - ] + ], + "type": "string" }, "ThreadEpiphanyJobsUpdatedSource": { - "type": "string", "enum": [ "runtimeProgress" - ] + ], + "type": "string" } - } + }, + "properties": { + "jobs": { + "items": { + "$ref": "#/definitions/ThreadEpiphanyJob" + }, + "type": "array" + }, + "source": { + "$ref": "#/definitions/ThreadEpiphanyJobsUpdatedSource" + }, + "stateRevision": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "source", + "threadId" + ], + "title": "ThreadEpiphanyJobsUpdatedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadEpiphanyStateUpdatedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadEpiphanyStateUpdatedNotification.json index 739318d3..548fca40 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadEpiphanyStateUpdatedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadEpiphanyStateUpdatedNotification.json @@ -1,49 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadEpiphanyStateUpdatedNotification", - "type": "object", - "required": [ - "changedFields", - "epiphanyState", - "revision", - "source", - "threadId" - ], - "properties": { - "changedFields": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadEpiphanyStateUpdatedField" - } - }, - "epiphanyState": { - "$ref": "#/definitions/EpiphanyThreadState" - }, - "revision": { - "type": "integer", - "format": "uint64", - "minimum": 0.0 - }, - "source": { - "$ref": "#/definitions/ThreadEpiphanyStateUpdatedSource" - }, - "threadId": { - "type": "string" - } - }, "definitions": { "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], "properties": { "accepted_at": { "type": "string" @@ -87,42 +45,41 @@ "surface": { "type": "string" } - } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" }, "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], "properties": { "acceptance_sketch": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "blockers": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": "string" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "duplicate_of": { "type": [ @@ -131,10 +88,10 @@ ] }, "evidence_refs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "horizon": { "type": "string" @@ -146,10 +103,10 @@ "type": "string" }, "lane_hints": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -158,10 +115,10 @@ "type": "string" }, "source_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } + }, + "type": "array" }, "status": { "type": "string" @@ -178,14 +135,21 @@ "null" ] } - } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], "properties": { "diff_pressure": { "type": "string" @@ -200,12 +164,12 @@ "type": "string" }, "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "warning": { "type": [ @@ -213,21 +177,22 @@ "null" ] } - } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" }, "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], "properties": { "end_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "note": { "type": [ @@ -239,12 +204,12 @@ "type": "string" }, "start_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "symbol": { "type": [ @@ -252,22 +217,19 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -281,57 +243,59 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyGraph": { - "type": "object", "properties": { "edges": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphEdge" - } + }, + "type": "array" }, "nodes": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphNode" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], "properties": { "checkpoint_id": { "type": "string" }, "frontier_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "graph_revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -339,21 +303,20 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" }, "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": [ @@ -382,58 +345,59 @@ "target_id": { "type": "string" } - } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" }, "EpiphanyGraphFrontier": { - "type": "object", "properties": { "active_edge_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "active_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], "properties": { "architecture_node_id": { "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "dataflow_node_id": { "type": "string" @@ -444,21 +408,20 @@ "null" ] } - } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" }, "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -487,10 +450,15 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" }, "EpiphanyGraphs": { - "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -499,20 +467,15 @@ "$ref": "#/definitions/EpiphanyGraph" }, "links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphLink" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], "properties": { "description": { "type": "string" @@ -529,16 +492,15 @@ "status": { "type": "string" } - } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" }, "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], "properties": { "captured_at_turn_id": { "type": [ @@ -550,19 +512,19 @@ "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "disposition": { "$ref": "#/definitions/EpiphanyInvestigationDisposition" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "focus": { "type": "string" @@ -577,10 +539,10 @@ ] }, "open_questions": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -588,23 +550,23 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" }, "EpiphanyInvestigationDisposition": { - "type": "string", "enum": [ "resume_ready", "regather_required" - ] + ], + "type": "string" }, "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], "properties": { "authority_scope": { "type": [ @@ -625,16 +587,16 @@ "$ref": "#/definitions/EpiphanyJobKind" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "owner_role": { "type": "string" @@ -642,29 +604,32 @@ "scope": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" }, "EpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "EpiphanyModeKind": { - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], "properties": { "kind": { "anyOf": [ @@ -679,36 +644,31 @@ "name": { "type": "string" } - } + }, + "required": [ + "name" + ], + "type": "object" }, "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], "properties": { "acceptance_criteria": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "evidence_required": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -717,25 +677,25 @@ "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" }, "review_gates": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "risks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "scope": { "$ref": "#/definitions/EpiphanyObjectiveDraftScope" }, "source_item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "status": { "type": "string" @@ -746,10 +706,18 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyObjectiveDraftLanePlan": { - "type": "object", "properties": { "body": { "type": [ @@ -787,45 +755,39 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyObjectiveDraftScope": { - "type": "object", "properties": { "excludes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -839,17 +801,16 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], "properties": { "body": { "type": [ @@ -882,10 +843,10 @@ "type": "string" }, "tags": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": "string" @@ -896,20 +857,23 @@ "null" ] } - } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" }, "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], "properties": { "blocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": [ @@ -939,10 +903,10 @@ ] }, "unblocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "urgency": { "type": [ @@ -953,19 +917,20 @@ "value": { "type": "string" } - } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" }, "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], "properties": { "assignees": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "author": { "type": [ @@ -986,11 +951,11 @@ ] }, "database_id": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "external_id": { "type": [ @@ -1011,21 +976,21 @@ ] }, "issue_number": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "kind": { "type": "string" }, "labels": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "milestone": { "type": [ @@ -1075,34 +1040,37 @@ "null" ] } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "EpiphanyPlanningState": { - "type": "object", "properties": { "backlog_items": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyBacklogItem" - } + }, + "type": "array" }, "captures": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningCapture" - } + }, + "type": "array" }, "objective_drafts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObjectiveDraft" - } + }, + "type": "array" }, "roadmap_streams": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRoadmapStream" - } + }, + "type": "array" }, "workspace_root": { "type": [ @@ -1110,33 +1078,29 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], "properties": { "exact_available": { "type": "boolean" }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "path_prefix": { "type": "string" @@ -1148,26 +1112,27 @@ "type": "string" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" } - } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" }, "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], "properties": { "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "index_revision": { "type": [ @@ -1176,82 +1141,79 @@ ] }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "last_indexed_at_unix_seconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "semantic_available": { "type": "boolean" }, "shards": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRetrievalShardSummary" - } + }, + "type": "array" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" }, "workspace_root": { "type": "string" } - } + }, + "required": [ + "workspace_root" + ], + "type": "object" }, "EpiphanyRetrievalStatus": { - "type": "string", "enum": [ "unavailable", "ready", "stale", "indexing" - ] + ], + "type": "string" }, "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], "properties": { "blocked_by": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "near_term_focus": { "type": [ @@ -1274,18 +1236,16 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" }, "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], "properties": { "authority_scope": { "type": "string" @@ -1297,16 +1257,16 @@ "type": "string" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "role_id": { "type": "string" @@ -1323,10 +1283,18 @@ "surface": { "type": "string" } - } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" }, "EpiphanyScratchPad": { - "type": "object", "properties": { "hypothesis": { "type": [ @@ -1341,10 +1309,10 @@ ] }, "notes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1352,15 +1320,10 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], "properties": { "id": { "type": "string" @@ -1377,19 +1340,21 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" }, "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], "properties": { "acceptance_receipts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } + }, + "type": "array" }, "active_subgoal_id": { "type": [ @@ -1431,10 +1396,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - } + }, + "type": "array" }, "investigation_checkpoint": { "anyOf": [ @@ -1447,10 +1412,10 @@ ] }, "job_bindings": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - } + }, + "type": "array" }, "last_updated_turn_id": { "type": [ @@ -1475,19 +1440,19 @@ ] }, "observations": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - } + }, + "type": "array" }, "planning": { "$ref": "#/definitions/EpiphanyPlanningState" }, "recent_evidence": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - } + }, + "type": "array" }, "retrieval": { "anyOf": [ @@ -1500,15 +1465,15 @@ ] }, "revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "runtime_links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - } + }, + "type": "array" }, "scratch": { "anyOf": [ @@ -1521,15 +1486,18 @@ ] }, "subgoals": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - } + }, + "type": "array" } - } + }, + "required": [ + "revision" + ], + "type": "object" }, "ThreadEpiphanyStateUpdatedField": { - "type": "string", "enum": [ "objective", "activeSubgoalId", @@ -1548,10 +1516,10 @@ "churn", "mode", "planning" - ] + ], + "type": "string" }, "ThreadEpiphanyStateUpdatedSource": { - "type": "string", "enum": [ "update", "promote", @@ -1559,7 +1527,39 @@ "jobInterrupt", "reorientAccept", "roleAccept" - ] + ], + "type": "string" } - } + }, + "properties": { + "changedFields": { + "items": { + "$ref": "#/definitions/ThreadEpiphanyStateUpdatedField" + }, + "type": "array" + }, + "epiphanyState": { + "$ref": "#/definitions/EpiphanyThreadState" + }, + "revision": { + "format": "uint64", + "minimum": 0.0, + "type": "integer" + }, + "source": { + "$ref": "#/definitions/ThreadEpiphanyStateUpdatedSource" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "changedFields", + "epiphanyState", + "revision", + "source", + "threadId" + ], + "title": "ThreadEpiphanyStateUpdatedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadForkParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadForkParams.json index ed7f5364..4c17037b 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadForkParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadForkParams.json @@ -1,11 +1,351 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadForkParams", + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + }, + "ApprovalsReviewer": { + "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", + "enum": [ + "user", + "auto_review", + "guardian_subagent" + ], + "type": "string" + }, + "AskForApproval": { + "oneOf": [ + { + "enum": [ + "untrusted", + "on-failure", + "on-request", + "never" + ], + "type": "string" + }, + { + "additionalProperties": false, + "properties": { + "granular": { + "properties": { + "mcp_elicitations": { + "type": "boolean" + }, + "request_permissions": { + "default": false, + "type": "boolean" + }, + "rules": { + "type": "boolean" + }, + "sandbox_approval": { + "type": "boolean" + } + }, + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], + "type": "object" + } + }, + "required": [ + "granular" + ], + "title": "GranularAskForApproval", + "type": "object" + } + ] + }, + "FileSystemAccessMode": { + "enum": [ + "read", + "write", + "none" + ], + "type": "string" + }, + "FileSystemPath": { + "oneOf": [ + { + "properties": { + "path": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": { + "enum": [ + "path" + ], + "title": "PathFileSystemPathType", + "type": "string" + } + }, + "required": [ + "path", + "type" + ], + "title": "PathFileSystemPath", + "type": "object" + }, + { + "properties": { + "pattern": { + "type": "string" + }, + "type": { + "enum": [ + "glob_pattern" + ], + "title": "GlobPatternFileSystemPathType", + "type": "string" + } + }, + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "special" + ], + "title": "SpecialFileSystemPathType", + "type": "string" + }, + "value": { + "$ref": "#/definitions/FileSystemSpecialPath" + } + }, + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" + } + ] + }, + "FileSystemSandboxEntry": { + "properties": { + "access": { + "$ref": "#/definitions/FileSystemAccessMode" + }, + "path": { + "$ref": "#/definitions/FileSystemPath" + } + }, + "required": [ + "access", + "path" + ], + "type": "object" + }, + "FileSystemSpecialPath": { + "oneOf": [ + { + "properties": { + "kind": { + "enum": [ + "root" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "minimal" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "current_working_directory" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "project_roots" + ], + "type": "string" + }, + "subpath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind" + ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "tmpdir" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "unknown" + ], + "type": "string" + }, + "path": { + "type": "string" + }, + "subpath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind", + "path" + ], + "type": "object" + } + ] + }, + "PermissionProfile": { + "properties": { + "fileSystem": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfileFileSystemPermissions" + }, + { + "type": "null" + } + ] + }, + "network": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfileNetworkPermissions" + }, + { + "type": "null" + } + ] + } + }, + "type": "object" + }, + "PermissionProfileFileSystemPermissions": { + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + }, + "type": "array" + }, + "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "entries" + ], + "type": "object" + }, + "PermissionProfileNetworkPermissions": { + "properties": { + "enabled": { + "type": [ + "boolean", + "null" + ] + } + }, + "type": "object" + }, + "SandboxMode": { + "enum": [ + "read-only", + "workspace-write", + "danger-full-access" + ], + "type": "string" + }, + "ServiceTier": { + "enum": [ + "fast", + "flex" + ], + "type": "string" + } + }, "description": "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", - "type": "object", - "required": [ - "threadId" - ], "properties": { "approvalPolicy": { "anyOf": [ @@ -18,7 +358,6 @@ ] }, "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this thread and subsequent turns.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -26,7 +365,8 @@ { "type": "null" } - ] + ], + "description": "Override where approval requests are routed for review on this thread and subsequent turns." }, "baseInstructions": { "type": [ @@ -35,11 +375,11 @@ ] }, "config": { + "additionalProperties": true, "type": [ "object", "null" - ], - "additionalProperties": true + ] }, "cwd": { "type": [ @@ -69,6 +409,27 @@ "null" ] }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Full permissions override for the forked thread. Cannot be combined with `sandbox`." + }, + "sandbox": { + "anyOf": [ + { + "$ref": "#/definitions/SandboxMode" + }, + { + "type": "null" + } + ] + }, "serviceTier": { "anyOf": [ { @@ -86,374 +447,13 @@ } ] }, - "permissionProfile": { - "description": "Full permissions override for the forked thread. Cannot be combined with `sandbox`.", - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, "threadId": { "type": "string" - }, - "sandbox": { - "anyOf": [ - { - "$ref": "#/definitions/SandboxMode" - }, - { - "type": "null" - } - ] } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - }, - "ApprovalsReviewer": { - "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", - "type": "string", - "enum": [ - "user", - "auto_review", - "guardian_subagent" - ] - }, - "AskForApproval": { - "oneOf": [ - { - "type": "string", - "enum": [ - "untrusted", - "on-failure", - "on-request", - "never" - ] - }, - { - "type": "object", - "required": [ - "granular" - ], - "properties": { - "granular": { - "type": "object", - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "properties": { - "mcp_elicitations": { - "type": "boolean" - }, - "request_permissions": { - "default": false, - "type": "boolean" - }, - "rules": { - "type": "boolean" - }, - "sandbox_approval": { - "type": "boolean" - } - } - } - }, - "additionalProperties": false, - "title": "GranularAskForApproval" - } - ] - }, - "FileSystemAccessMode": { - "type": "string", - "enum": [ - "read", - "write", - "none" - ] - }, - "FileSystemPath": { - "oneOf": [ - { - "type": "object", - "required": [ - "path", - "type" - ], - "properties": { - "path": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": { - "type": "string", - "enum": [ - "path" - ], - "title": "PathFileSystemPathType" - } - }, - "title": "PathFileSystemPath" - }, - { - "type": "object", - "required": [ - "pattern", - "type" - ], - "properties": { - "pattern": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "glob_pattern" - ], - "title": "GlobPatternFileSystemPathType" - } - }, - "title": "GlobPatternFileSystemPath" - }, - { - "type": "object", - "required": [ - "type", - "value" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "special" - ], - "title": "SpecialFileSystemPathType" - }, - "value": { - "$ref": "#/definitions/FileSystemSpecialPath" - } - }, - "title": "SpecialFileSystemPath" - } - ] - }, - "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], - "properties": { - "access": { - "$ref": "#/definitions/FileSystemAccessMode" - }, - "path": { - "$ref": "#/definitions/FileSystemPath" - } - } - }, - "FileSystemSpecialPath": { - "oneOf": [ - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "root" - ] - } - }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "minimal" - ] - } - }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "current_working_directory" - ] - } - }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "project_roots" - ] - }, - "subpath": { - "type": [ - "string", - "null" - ] - } - }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "tmpdir" - ] - } - }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind", - "path" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "unknown" - ] - }, - "path": { - "type": "string" - }, - "subpath": { - "type": [ - "string", - "null" - ] - } - } - } - ] - }, - "PermissionProfile": { - "type": "object", - "properties": { - "fileSystem": { - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfileFileSystemPermissions" - }, - { - "type": "null" - } - ] - }, - "network": { - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfileNetworkPermissions" - }, - { - "type": "null" - } - ] - } - } - }, - "PermissionProfileFileSystemPermissions": { - "type": "object", - "required": [ - "entries" - ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - } - }, - "globScanMaxDepth": { - "type": [ - "integer", - "null" - ], - "format": "uint", - "minimum": 1.0 - } - } - }, - "PermissionProfileNetworkPermissions": { - "type": "object", - "properties": { - "enabled": { - "type": [ - "boolean", - "null" - ] - } - } - }, - "SandboxMode": { - "type": "string", - "enum": [ - "read-only", - "workspace-write", - "danger-full-access" - ] - }, - "ServiceTier": { - "type": "string", - "enum": [ - "fast", - "flex" - ] - } - } + "required": [ + "threadId" + ], + "title": "ThreadForkParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json index 910a8486..8cb0c5f2 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json @@ -1,89 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadForkResponse", - "type": "object", - "required": [ - "approvalPolicy", - "approvalsReviewer", - "cwd", - "model", - "modelProvider", - "sandbox", - "thread" - ], - "properties": { - "approvalPolicy": { - "$ref": "#/definitions/AskForApproval" - }, - "approvalsReviewer": { - "description": "Reviewer currently used for approval requests on this thread.", - "allOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - } - ] - }, - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "instructionSources": { - "description": "Instruction source files currently loaded for this thread.", - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "model": { - "type": "string" - }, - "modelProvider": { - "type": "string" - }, - "permissionProfile": { - "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`.", - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "reasoningEffort": { - "anyOf": [ - { - "$ref": "#/definitions/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "sandbox": { - "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view.", - "allOf": [ - { - "$ref": "#/definitions/SandboxPolicy" - } - ] - }, - "serviceTier": { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - "thread": { - "$ref": "#/definitions/Thread" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", @@ -94,37 +10,28 @@ }, "ApprovalsReviewer": { "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", - "type": "string", "enum": [ "user", "auto_review", "guardian_subagent" - ] + ], + "type": "string" }, "AskForApproval": { "oneOf": [ { - "type": "string", "enum": [ "untrusted", "on-failure", "on-request", "never" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "granular" - ], + "additionalProperties": false, "properties": { "granular": { - "type": "object", - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -139,38 +46,46 @@ "sandbox_approval": { "type": "boolean" } - } + }, + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "GranularAskForApproval" + "required": [ + "granular" + ], + "title": "GranularAskForApproval", + "type": "object" } ] }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -181,132 +96,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -317,10 +229,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -329,36 +244,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -370,21 +279,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -396,21 +307,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -428,119 +339,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], "properties": { "accepted_at": { "type": "string" @@ -584,42 +489,41 @@ "surface": { "type": "string" } - } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" }, "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], "properties": { "acceptance_sketch": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "blockers": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": "string" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "duplicate_of": { "type": [ @@ -628,10 +532,10 @@ ] }, "evidence_refs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "horizon": { "type": "string" @@ -643,10 +547,10 @@ "type": "string" }, "lane_hints": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -655,10 +559,10 @@ "type": "string" }, "source_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } + }, + "type": "array" }, "status": { "type": "string" @@ -675,14 +579,21 @@ "null" ] } - } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], "properties": { "diff_pressure": { "type": "string" @@ -697,12 +608,12 @@ "type": "string" }, "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "warning": { "type": [ @@ -710,21 +621,22 @@ "null" ] } - } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" }, "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], "properties": { "end_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "note": { "type": [ @@ -736,12 +648,12 @@ "type": "string" }, "start_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "symbol": { "type": [ @@ -749,22 +661,19 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -778,57 +687,59 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyGraph": { - "type": "object", "properties": { "edges": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphEdge" - } + }, + "type": "array" }, "nodes": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphNode" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], "properties": { "checkpoint_id": { "type": "string" }, "frontier_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "graph_revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -836,21 +747,20 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" }, "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": [ @@ -879,58 +789,59 @@ "target_id": { "type": "string" } - } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" }, "EpiphanyGraphFrontier": { - "type": "object", "properties": { "active_edge_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "active_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], "properties": { "architecture_node_id": { "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "dataflow_node_id": { "type": "string" @@ -941,21 +852,20 @@ "null" ] } - } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" }, "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -984,10 +894,15 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" }, "EpiphanyGraphs": { - "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -996,20 +911,15 @@ "$ref": "#/definitions/EpiphanyGraph" }, "links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphLink" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], "properties": { "description": { "type": "string" @@ -1026,16 +936,15 @@ "status": { "type": "string" } - } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" }, "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], "properties": { "captured_at_turn_id": { "type": [ @@ -1047,19 +956,19 @@ "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "disposition": { "$ref": "#/definitions/EpiphanyInvestigationDisposition" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "focus": { "type": "string" @@ -1074,10 +983,10 @@ ] }, "open_questions": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1085,23 +994,23 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" }, "EpiphanyInvestigationDisposition": { - "type": "string", "enum": [ "resume_ready", "regather_required" - ] + ], + "type": "string" }, "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], "properties": { "authority_scope": { "type": [ @@ -1122,16 +1031,16 @@ "$ref": "#/definitions/EpiphanyJobKind" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "owner_role": { "type": "string" @@ -1139,29 +1048,32 @@ "scope": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" }, "EpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "EpiphanyModeKind": { - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], "properties": { "kind": { "anyOf": [ @@ -1176,36 +1088,31 @@ "name": { "type": "string" } - } + }, + "required": [ + "name" + ], + "type": "object" }, "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], "properties": { "acceptance_criteria": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "evidence_required": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1214,25 +1121,25 @@ "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" }, "review_gates": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "risks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "scope": { "$ref": "#/definitions/EpiphanyObjectiveDraftScope" }, "source_item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "status": { "type": "string" @@ -1243,10 +1150,18 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyObjectiveDraftLanePlan": { - "type": "object", "properties": { "body": { "type": [ @@ -1284,45 +1199,39 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyObjectiveDraftScope": { - "type": "object", "properties": { "excludes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1336,17 +1245,16 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], "properties": { "body": { "type": [ @@ -1379,10 +1287,10 @@ "type": "string" }, "tags": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": "string" @@ -1393,20 +1301,23 @@ "null" ] } - } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" }, "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], "properties": { "blocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": [ @@ -1436,10 +1347,10 @@ ] }, "unblocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "urgency": { "type": [ @@ -1450,19 +1361,20 @@ "value": { "type": "string" } - } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" }, "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], "properties": { "assignees": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "author": { "type": [ @@ -1483,11 +1395,11 @@ ] }, "database_id": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "external_id": { "type": [ @@ -1508,21 +1420,21 @@ ] }, "issue_number": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "kind": { "type": "string" }, "labels": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "milestone": { "type": [ @@ -1572,34 +1484,37 @@ "null" ] } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "EpiphanyPlanningState": { - "type": "object", "properties": { "backlog_items": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyBacklogItem" - } + }, + "type": "array" }, "captures": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningCapture" - } + }, + "type": "array" }, "objective_drafts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObjectiveDraft" - } + }, + "type": "array" }, "roadmap_streams": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRoadmapStream" - } + }, + "type": "array" }, "workspace_root": { "type": [ @@ -1607,33 +1522,29 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], "properties": { "exact_available": { "type": "boolean" }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "path_prefix": { "type": "string" @@ -1645,26 +1556,27 @@ "type": "string" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" } - } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" }, "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], "properties": { "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "index_revision": { "type": [ @@ -1673,82 +1585,79 @@ ] }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "last_indexed_at_unix_seconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "semantic_available": { "type": "boolean" }, "shards": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRetrievalShardSummary" - } + }, + "type": "array" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" }, "workspace_root": { "type": "string" } - } + }, + "required": [ + "workspace_root" + ], + "type": "object" }, "EpiphanyRetrievalStatus": { - "type": "string", "enum": [ "unavailable", "ready", "stale", "indexing" - ] + ], + "type": "string" }, "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], "properties": { "blocked_by": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "near_term_focus": { "type": [ @@ -1771,18 +1680,16 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" }, "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], "properties": { "authority_scope": { "type": "string" @@ -1794,16 +1701,16 @@ "type": "string" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "role_id": { "type": "string" @@ -1820,10 +1727,18 @@ "surface": { "type": "string" } - } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" }, "EpiphanyScratchPad": { - "type": "object", "properties": { "hypothesis": { "type": [ @@ -1838,10 +1753,10 @@ ] }, "notes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1849,15 +1764,10 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], "properties": { "id": { "type": "string" @@ -1874,19 +1784,21 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" }, "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], "properties": { "acceptance_receipts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } + }, + "type": "array" }, "active_subgoal_id": { "type": [ @@ -1928,10 +1840,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - } + }, + "type": "array" }, "investigation_checkpoint": { "anyOf": [ @@ -1944,10 +1856,10 @@ ] }, "job_bindings": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - } + }, + "type": "array" }, "last_updated_turn_id": { "type": [ @@ -1972,19 +1884,19 @@ ] }, "observations": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - } + }, + "type": "array" }, "planning": { "$ref": "#/definitions/EpiphanyPlanningState" }, "recent_evidence": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - } + }, + "type": "array" }, "retrieval": { "anyOf": [ @@ -1997,15 +1909,15 @@ ] }, "revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "runtime_links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - } + }, + "type": "array" }, "scratch": { "anyOf": [ @@ -2018,91 +1930,90 @@ ] }, "subgoals": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - } + }, + "type": "array" } - } + }, + "required": [ + "revision" + ], + "type": "object" }, "FileSystemAccessMode": { - "type": "string", "enum": [ "read", "write", "none" - ] + ], + "type": "string" }, "FileSystemPath": { "oneOf": [ { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "path" ], - "title": "PathFileSystemPathType" + "title": "PathFileSystemPathType", + "type": "string" } }, - "title": "PathFileSystemPath" - }, - { - "type": "object", "required": [ - "pattern", + "path", "type" ], + "title": "PathFileSystemPath", + "type": "object" + }, + { "properties": { "pattern": { "type": "string" }, "type": { - "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType" + "title": "GlobPatternFileSystemPathType", + "type": "string" } }, - "title": "GlobPatternFileSystemPath" + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType" + "title": "SpecialFileSystemPathType", + "type": "string" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "title": "SpecialFileSystemPath" + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" } ] }, "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -2110,66 +2021,67 @@ "path": { "$ref": "#/definitions/FileSystemPath" } - } + }, + "required": [ + "access", + "path" + ], + "type": "object" }, "FileSystemSpecialPath": { "oneOf": [ { - "type": "object", - "required": [ - "kind" - ], "properties": { "kind": { - "type": "string", "enum": [ "root" - ] + ], + "type": "string" } }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "minimal" - ] + ], + "type": "string" } }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "current_working_directory" - ] + ], + "type": "string" } }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "project_roots" - ] + ], + "type": "string" }, "subpath": { "type": [ @@ -2178,50 +2090,49 @@ ] } }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "tmpdir" - ] + ], + "type": "string" } }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" }, { - "type": "object", - "required": [ - "kind", - "path" - ], "properties": { "kind": { - "type": "string", "enum": [ "unknown" - ] + ], + "type": "string" }, "path": { "type": "string" @@ -2232,17 +2143,16 @@ "null" ] } - } + }, + "required": [ + "kind", + "path" + ], + "type": "object" } ] }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -2253,10 +2163,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "GitInfo": { - "type": "object", "properties": { "branch": { "type": [ @@ -2276,14 +2191,10 @@ "null" ] } - } + }, + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -2291,80 +2202,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -2372,89 +2281,92 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NetworkAccess": { - "type": "string", "enum": [ "restricted", "enabled" - ] + ], + "type": "string" }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -2463,19 +2375,22 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "PermissionProfile": { - "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -2497,32 +2412,32 @@ } ] } - } + }, + "type": "object" }, "PermissionProfileFileSystemPermissions": { - "type": "object", - "required": [ - "entries" - ], "properties": { "entries": { - "type": "array", "items": { "$ref": "#/definitions/FileSystemSandboxEntry" - } + }, + "type": "array" }, "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 1.0 + ] } - } + }, + "required": [ + "entries" + ], + "type": "object" }, "PermissionProfileNetworkPermissions": { - "type": "object", "properties": { "enabled": { "type": [ @@ -2530,15 +2445,12 @@ "null" ] } - } + }, + "type": "object" }, "ReadOnlyAccess": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "includePlatformDefaults": { "default": true, @@ -2546,42 +2458,45 @@ }, "readableRoots": { "default": [], - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "restricted" ], - "title": "RestrictedReadOnlyAccessType" + "title": "RestrictedReadOnlyAccessType", + "type": "string" } }, - "title": "RestrictedReadOnlyAccess" - }, - { - "type": "object", "required": [ "type" ], + "title": "RestrictedReadOnlyAccess", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "fullAccess" ], - "title": "FullAccessReadOnlyAccessType" + "title": "FullAccessReadOnlyAccessType", + "type": "string" } }, - "title": "FullAccessReadOnlyAccess" + "required": [ + "type" + ], + "title": "FullAccessReadOnlyAccess", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -2589,85 +2504,82 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "SandboxPolicy": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "dangerFullAccess" ], - "title": "DangerFullAccessSandboxPolicyType" + "title": "DangerFullAccessSandboxPolicyType", + "type": "string" } }, - "title": "DangerFullAccessSandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "DangerFullAccessSandboxPolicy", + "type": "object" + }, + { "properties": { "access": { - "default": { - "type": "fullAccess" - }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ] + ], + "default": { + "type": "fullAccess" + } }, "networkAccess": { "default": false, "type": "boolean" }, "type": { - "type": "string", "enum": [ "readOnly" ], - "title": "ReadOnlySandboxPolicyType" + "title": "ReadOnlySandboxPolicyType", + "type": "string" } }, - "title": "ReadOnlySandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "ReadOnlySandboxPolicy", + "type": "object" + }, + { "properties": { "networkAccess": { - "default": "restricted", "allOf": [ { "$ref": "#/definitions/NetworkAccess" } - ] + ], + "default": "restricted" }, "type": { - "type": "string", "enum": [ "externalSandbox" ], - "title": "ExternalSandboxSandboxPolicyType" + "title": "ExternalSandboxSandboxPolicyType", + "type": "string" } }, - "title": "ExternalSandboxSandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "ExternalSandboxSandboxPolicy", + "type": "object" + }, + { "properties": { "excludeSlashTmp": { "default": false, @@ -2682,103 +2594,99 @@ "type": "boolean" }, "readOnlyAccess": { - "default": { - "type": "fullAccess" - }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ] + ], + "default": { + "type": "fullAccess" + } }, "type": { - "type": "string", "enum": [ "workspaceWrite" ], - "title": "WorkspaceWriteSandboxPolicyType" + "title": "WorkspaceWriteSandboxPolicyType", + "type": "string" }, "writableRoots": { "default": [], - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" } }, - "title": "WorkspaceWriteSandboxPolicy" + "required": [ + "type" + ], + "title": "WorkspaceWriteSandboxPolicy", + "type": "object" } ] }, "ServiceTier": { - "type": "string", "enum": [ "fast", "flex" - ] + ], + "type": "string" }, "SessionSource": { "oneOf": [ { - "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "custom" - ], + "additionalProperties": false, "properties": { "custom": { "type": "string" } }, - "additionalProperties": false, - "title": "CustomSessionSource" + "required": [ + "custom" + ], + "title": "CustomSessionSource", + "type": "object" }, { - "type": "object", - "required": [ - "subAgent" - ], + "additionalProperties": false, "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "additionalProperties": false, - "title": "SubAgentSessionSource" + "required": [ + "subAgent" + ], + "title": "SubAgentSessionSource", + "type": "object" } ] }, "SubAgentSource": { "oneOf": [ { - "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "thread_spawn" - ], + "additionalProperties": false, "properties": { "thread_spawn": { - "type": "object", - "required": [ - "depth", - "parent_thread_id" - ], "properties": { "agent_nickname": { "default": null, @@ -2788,7 +2696,6 @@ ] }, "agent_path": { - "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2796,7 +2703,8 @@ { "type": "null" } - ] + ], + "default": null }, "agent_role": { "default": null, @@ -2806,46 +2714,50 @@ ] }, "depth": { - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - } + }, + "required": [ + "depth", + "parent_thread_id" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ThreadSpawnSubAgentSource" + "required": [ + "thread_spawn" + ], + "title": "ThreadSpawnSubAgentSource", + "type": "object" }, { - "type": "object", - "required": [ - "other" - ], + "additionalProperties": false, "properties": { "other": { "type": "string" } }, - "additionalProperties": false, - "title": "OtherSubAgentSource" + "required": [ + "other" + ], + "title": "OtherSubAgentSource", + "type": "object" } ] }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -2854,23 +2766,13 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "Thread": { - "type": "object", - "required": [ - "cliVersion", - "createdAt", - "cwd", - "ephemeral", - "id", - "modelProvider", - "preview", - "source", - "status", - "turns", - "updatedAt" - ], "properties": { "agentNickname": { "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", @@ -2892,23 +2794,22 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "cwd": { - "description": "Working directory captured for the thread.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Working directory captured for the thread." }, "ephemeral": { "description": "Whether the thread is ephemeral and should not be materialized on disk.", "type": "boolean" }, "epiphanyState": { - "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads.", "anyOf": [ { "$ref": "#/definitions/EpiphanyThreadState" @@ -2916,7 +2817,8 @@ { "type": "null" } - ] + ], + "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads." }, "forkedFromId": { "description": "Source thread id when this thread was created by forking another thread.", @@ -2926,7 +2828,6 @@ ] }, "gitInfo": { - "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2934,7 +2835,8 @@ { "type": "null" } - ] + ], + "description": "Optional Git metadata captured when the thread was created." }, "id": { "type": "string" @@ -2962,41 +2864,55 @@ "type": "string" }, "source": { - "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).", "allOf": [ { "$ref": "#/definitions/SessionSource" } - ] + ], + "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." }, "status": { - "description": "Current runtime status for the thread.", "allOf": [ { "$ref": "#/definitions/ThreadStatus" } - ] + ], + "description": "Current runtime status for the thread." }, "turns": { "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/Turn" - } + }, + "type": "array" }, "updatedAt": { "description": "Unix timestamp (in seconds) when the thread was last updated.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } - } + }, + "required": [ + "cliVersion", + "createdAt", + "cwd", + "ephemeral", + "id", + "modelProvider", + "preview", + "source", + "status", + "turns", + "updatedAt" + ], + "type": "object" }, "ThreadActiveFlag": { - "type": "string", "enum": [ "waitingOnApproval", "waitingOnUserInput" - ] + ], + "type": "string" }, "ThreadId": { "type": "string" @@ -3004,72 +2920,65 @@ "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -3077,10 +2986,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -3088,29 +2997,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -3119,59 +3029,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -3186,34 +3093,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -3226,40 +3133,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -3268,34 +3177,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -3336,42 +3243,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -3395,33 +3303,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -3442,7 +3348,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -3450,52 +3355,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -3514,22 +3424,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3538,23 +3448,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3582,22 +3491,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3606,22 +3516,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3630,138 +3540,137 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "ThreadStatus": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType" + "title": "NotLoadedThreadStatusType", + "type": "string" } }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType" + "title": "IdleThreadStatusType", + "type": "string" } }, - "title": "IdleThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "IdleThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType" + "title": "SystemErrorThreadStatusType", + "type": "string" } }, - "title": "SystemErrorThreadStatus" + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" }, { - "type": "object", + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, "required": [ "activeFlags", "type" ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" + "title": "ActiveThreadStatus", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -3769,36 +3678,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -3820,94 +3732,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -3916,33 +3826,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -3951,27 +3863,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3980,13 +3892,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -3995,11 +3907,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -4008,25 +3920,113 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "approvalPolicy": { + "$ref": "#/definitions/AskForApproval" + }, + "approvalsReviewer": { + "allOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + } + ], + "description": "Reviewer currently used for approval requests on this thread." + }, + "cwd": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "instructionSources": { + "default": [], + "description": "Instruction source files currently loaded for this thread.", + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": "array" + }, + "model": { + "type": "string" + }, + "modelProvider": { + "type": "string" + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "default": null, + "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`." + }, + "reasoningEffort": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningEffort" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "allOf": [ + { + "$ref": "#/definitions/SandboxPolicy" + } + ], + "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view." + }, + "serviceTier": { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "approvalPolicy", + "approvalsReviewer", + "cwd", + "model", + "modelProvider", + "sandbox", + "thread" + ], + "title": "ThreadForkResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadInjectItemsParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadInjectItemsParams.json index 53afb30b..d117f3ae 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadInjectItemsParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadInjectItemsParams.json @@ -1,19 +1,19 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadInjectItemsParams", - "type": "object", - "required": [ - "items", - "threadId" - ], "properties": { "items": { "description": "Raw Responses API items to append to the thread's model-visible history.", - "type": "array", - "items": true + "items": true, + "type": "array" }, "threadId": { "type": "string" } - } + }, + "required": [ + "items", + "threadId" + ], + "title": "ThreadInjectItemsParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadListParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadListParams.json index 46a8683e..789d9b61 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadListParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadListParams.json @@ -1,7 +1,49 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadListParams", - "type": "object", + "definitions": { + "SortDirection": { + "enum": [ + "asc", + "desc" + ], + "type": "string" + }, + "ThreadListCwdFilter": { + "anyOf": [ + { + "type": "string" + }, + { + "items": { + "type": "string" + }, + "type": "array" + } + ] + }, + "ThreadSortKey": { + "enum": [ + "created_at", + "updated_at" + ], + "type": "string" + }, + "ThreadSourceKind": { + "enum": [ + "cli", + "vscode", + "exec", + "appServer", + "subAgent", + "subAgentReview", + "subAgentCompact", + "subAgentThreadSpawn", + "subAgentOther", + "unknown" + ], + "type": "string" + } + }, "properties": { "archived": { "description": "Optional archived filter; when set to true, only archived threads are returned. If false or null, only non-archived threads are returned.", @@ -18,7 +60,6 @@ ] }, "cwd": { - "description": "Optional cwd filter or filters; when set, only threads whose session cwd exactly matches one of these paths are returned.", "anyOf": [ { "$ref": "#/definitions/ThreadListCwdFilter" @@ -26,26 +67,27 @@ { "type": "null" } - ] + ], + "description": "Optional cwd filter or filters; when set, only threads whose session cwd exactly matches one of these paths are returned." }, "limit": { "description": "Optional page size; defaults to a reasonable server-side value.", + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "modelProviders": { "description": "Optional provider filter; when set, only sessions recorded under these providers are returned. When present but empty, includes all providers.", + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "searchTerm": { "description": "Optional substring filter for the extracted thread title.", @@ -55,7 +97,6 @@ ] }, "sortDirection": { - "description": "Optional sort direction; defaults to descending (newest first).", "anyOf": [ { "$ref": "#/definitions/SortDirection" @@ -63,10 +104,10 @@ { "type": "null" } - ] + ], + "description": "Optional sort direction; defaults to descending (newest first)." }, "sortKey": { - "description": "Optional sort key; defaults to created_at.", "anyOf": [ { "$ref": "#/definitions/ThreadSortKey" @@ -74,65 +115,24 @@ { "type": "null" } - ] + ], + "description": "Optional sort key; defaults to created_at." }, "sourceKinds": { "description": "Optional source filter; when set, only sessions from these source kinds are returned. When omitted or empty, defaults to interactive sources.", + "items": { + "$ref": "#/definitions/ThreadSourceKind" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/ThreadSourceKind" - } + ] }, "useStateDbOnly": { "description": "If true, return from the state DB without scanning JSONL rollouts to repair thread metadata. Omitted or false preserves scan-and-repair behavior.", "type": "boolean" } }, - "definitions": { - "SortDirection": { - "type": "string", - "enum": [ - "asc", - "desc" - ] - }, - "ThreadListCwdFilter": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string" - } - } - ] - }, - "ThreadSortKey": { - "type": "string", - "enum": [ - "created_at", - "updated_at" - ] - }, - "ThreadSourceKind": { - "type": "string", - "enum": [ - "cli", - "vscode", - "exec", - "appServer", - "subAgent", - "subAgentReview", - "subAgentCompact", - "subAgentThreadSpawn", - "subAgentOther", - "unknown" - ] - } - } + "title": "ThreadListParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json index 2a2306f2..2f3ae361 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json @@ -1,32 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadListResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "backwardsCursor": { - "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one thread. Use it with the opposite `sortDirection`; for timestamp sorts it anchors at the start of the page timestamp so same-second updates are not skipped.", - "type": [ - "string", - "null" - ] - }, - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/Thread" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.", - "type": [ - "string", - "null" - ] - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", @@ -36,29 +9,28 @@ "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -69,132 +41,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -205,10 +174,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -217,36 +189,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -258,21 +224,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -284,21 +252,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -316,119 +284,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], "properties": { "accepted_at": { "type": "string" @@ -472,42 +434,41 @@ "surface": { "type": "string" } - } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" }, "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], "properties": { "acceptance_sketch": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "blockers": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": "string" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "duplicate_of": { "type": [ @@ -516,10 +477,10 @@ ] }, "evidence_refs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "horizon": { "type": "string" @@ -531,10 +492,10 @@ "type": "string" }, "lane_hints": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -543,10 +504,10 @@ "type": "string" }, "source_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } + }, + "type": "array" }, "status": { "type": "string" @@ -563,14 +524,21 @@ "null" ] } - } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], "properties": { "diff_pressure": { "type": "string" @@ -585,12 +553,12 @@ "type": "string" }, "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "warning": { "type": [ @@ -598,21 +566,22 @@ "null" ] } - } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" }, "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], "properties": { "end_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "note": { "type": [ @@ -624,12 +593,12 @@ "type": "string" }, "start_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "symbol": { "type": [ @@ -637,22 +606,19 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -666,57 +632,59 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyGraph": { - "type": "object", "properties": { "edges": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphEdge" - } + }, + "type": "array" }, "nodes": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphNode" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], "properties": { "checkpoint_id": { "type": "string" }, "frontier_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "graph_revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -724,21 +692,20 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" }, "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": [ @@ -767,58 +734,59 @@ "target_id": { "type": "string" } - } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" }, "EpiphanyGraphFrontier": { - "type": "object", "properties": { "active_edge_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "active_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], "properties": { "architecture_node_id": { "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "dataflow_node_id": { "type": "string" @@ -829,21 +797,20 @@ "null" ] } - } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" }, "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -872,10 +839,15 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" }, "EpiphanyGraphs": { - "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -884,20 +856,15 @@ "$ref": "#/definitions/EpiphanyGraph" }, "links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphLink" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], "properties": { "description": { "type": "string" @@ -914,16 +881,15 @@ "status": { "type": "string" } - } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" }, "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], "properties": { "captured_at_turn_id": { "type": [ @@ -935,19 +901,19 @@ "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "disposition": { "$ref": "#/definitions/EpiphanyInvestigationDisposition" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "focus": { "type": "string" @@ -962,10 +928,10 @@ ] }, "open_questions": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -973,23 +939,23 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" }, "EpiphanyInvestigationDisposition": { - "type": "string", "enum": [ "resume_ready", "regather_required" - ] + ], + "type": "string" }, "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], "properties": { "authority_scope": { "type": [ @@ -1010,16 +976,16 @@ "$ref": "#/definitions/EpiphanyJobKind" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "owner_role": { "type": "string" @@ -1027,29 +993,32 @@ "scope": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" }, "EpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "EpiphanyModeKind": { - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], "properties": { "kind": { "anyOf": [ @@ -1064,36 +1033,31 @@ "name": { "type": "string" } - } + }, + "required": [ + "name" + ], + "type": "object" }, "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], "properties": { "acceptance_criteria": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "evidence_required": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1102,25 +1066,25 @@ "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" }, "review_gates": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "risks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "scope": { "$ref": "#/definitions/EpiphanyObjectiveDraftScope" }, "source_item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "status": { "type": "string" @@ -1131,10 +1095,18 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyObjectiveDraftLanePlan": { - "type": "object", "properties": { "body": { "type": [ @@ -1172,45 +1144,39 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyObjectiveDraftScope": { - "type": "object", "properties": { "excludes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1224,17 +1190,16 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], "properties": { "body": { "type": [ @@ -1267,10 +1232,10 @@ "type": "string" }, "tags": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": "string" @@ -1281,20 +1246,23 @@ "null" ] } - } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" }, "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], "properties": { "blocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": [ @@ -1324,10 +1292,10 @@ ] }, "unblocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "urgency": { "type": [ @@ -1338,19 +1306,20 @@ "value": { "type": "string" } - } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" }, "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], "properties": { "assignees": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "author": { "type": [ @@ -1371,11 +1340,11 @@ ] }, "database_id": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "external_id": { "type": [ @@ -1396,21 +1365,21 @@ ] }, "issue_number": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "kind": { "type": "string" }, "labels": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "milestone": { "type": [ @@ -1460,34 +1429,37 @@ "null" ] } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "EpiphanyPlanningState": { - "type": "object", "properties": { "backlog_items": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyBacklogItem" - } + }, + "type": "array" }, "captures": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningCapture" - } + }, + "type": "array" }, "objective_drafts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObjectiveDraft" - } + }, + "type": "array" }, "roadmap_streams": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRoadmapStream" - } + }, + "type": "array" }, "workspace_root": { "type": [ @@ -1495,33 +1467,29 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], "properties": { "exact_available": { "type": "boolean" }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "path_prefix": { "type": "string" @@ -1533,26 +1501,27 @@ "type": "string" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" } - } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" }, "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], "properties": { "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "index_revision": { "type": [ @@ -1561,82 +1530,79 @@ ] }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "last_indexed_at_unix_seconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "semantic_available": { "type": "boolean" }, "shards": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRetrievalShardSummary" - } + }, + "type": "array" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" }, "workspace_root": { "type": "string" } - } + }, + "required": [ + "workspace_root" + ], + "type": "object" }, "EpiphanyRetrievalStatus": { - "type": "string", "enum": [ "unavailable", "ready", "stale", "indexing" - ] + ], + "type": "string" }, "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], "properties": { "blocked_by": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "near_term_focus": { "type": [ @@ -1659,18 +1625,16 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" }, "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], "properties": { "authority_scope": { "type": "string" @@ -1682,16 +1646,16 @@ "type": "string" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "role_id": { "type": "string" @@ -1708,10 +1672,18 @@ "surface": { "type": "string" } - } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" }, "EpiphanyScratchPad": { - "type": "object", "properties": { "hypothesis": { "type": [ @@ -1726,10 +1698,10 @@ ] }, "notes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1737,15 +1709,10 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], "properties": { "id": { "type": "string" @@ -1762,19 +1729,21 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" }, "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], "properties": { "acceptance_receipts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } + }, + "type": "array" }, "active_subgoal_id": { "type": [ @@ -1816,10 +1785,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - } + }, + "type": "array" }, "investigation_checkpoint": { "anyOf": [ @@ -1832,10 +1801,10 @@ ] }, "job_bindings": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - } + }, + "type": "array" }, "last_updated_turn_id": { "type": [ @@ -1860,19 +1829,19 @@ ] }, "observations": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - } + }, + "type": "array" }, "planning": { "$ref": "#/definitions/EpiphanyPlanningState" }, "recent_evidence": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - } + }, + "type": "array" }, "retrieval": { "anyOf": [ @@ -1885,15 +1854,15 @@ ] }, "revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "runtime_links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - } + }, + "type": "array" }, "scratch": { "anyOf": [ @@ -1906,20 +1875,18 @@ ] }, "subgoals": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - } + }, + "type": "array" } - } + }, + "required": [ + "revision" + ], + "type": "object" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -1930,10 +1897,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "GitInfo": { - "type": "object", "properties": { "branch": { "type": [ @@ -1953,14 +1925,10 @@ "null" ] } - } + }, + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -1968,80 +1936,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -2049,82 +2015,85 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -2133,20 +2102,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -2154,70 +2126,63 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "SessionSource": { "oneOf": [ { - "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "custom" - ], + "additionalProperties": false, "properties": { "custom": { "type": "string" } }, - "additionalProperties": false, - "title": "CustomSessionSource" + "required": [ + "custom" + ], + "title": "CustomSessionSource", + "type": "object" }, { - "type": "object", - "required": [ - "subAgent" - ], + "additionalProperties": false, "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "additionalProperties": false, - "title": "SubAgentSessionSource" + "required": [ + "subAgent" + ], + "title": "SubAgentSessionSource", + "type": "object" } ] }, "SubAgentSource": { "oneOf": [ { - "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "thread_spawn" - ], + "additionalProperties": false, "properties": { "thread_spawn": { - "type": "object", - "required": [ - "depth", - "parent_thread_id" - ], "properties": { "agent_nickname": { "default": null, @@ -2227,7 +2192,6 @@ ] }, "agent_path": { - "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2235,7 +2199,8 @@ { "type": "null" } - ] + ], + "default": null }, "agent_role": { "default": null, @@ -2245,46 +2210,50 @@ ] }, "depth": { - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - } + }, + "required": [ + "depth", + "parent_thread_id" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ThreadSpawnSubAgentSource" + "required": [ + "thread_spawn" + ], + "title": "ThreadSpawnSubAgentSource", + "type": "object" }, { - "type": "object", - "required": [ - "other" - ], + "additionalProperties": false, "properties": { "other": { "type": "string" } }, - "additionalProperties": false, - "title": "OtherSubAgentSource" + "required": [ + "other" + ], + "title": "OtherSubAgentSource", + "type": "object" } ] }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -2293,23 +2262,13 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "Thread": { - "type": "object", - "required": [ - "cliVersion", - "createdAt", - "cwd", - "ephemeral", - "id", - "modelProvider", - "preview", - "source", - "status", - "turns", - "updatedAt" - ], "properties": { "agentNickname": { "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", @@ -2331,23 +2290,22 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "cwd": { - "description": "Working directory captured for the thread.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Working directory captured for the thread." }, "ephemeral": { "description": "Whether the thread is ephemeral and should not be materialized on disk.", "type": "boolean" }, "epiphanyState": { - "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads.", "anyOf": [ { "$ref": "#/definitions/EpiphanyThreadState" @@ -2355,7 +2313,8 @@ { "type": "null" } - ] + ], + "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads." }, "forkedFromId": { "description": "Source thread id when this thread was created by forking another thread.", @@ -2365,7 +2324,6 @@ ] }, "gitInfo": { - "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2373,7 +2331,8 @@ { "type": "null" } - ] + ], + "description": "Optional Git metadata captured when the thread was created." }, "id": { "type": "string" @@ -2401,41 +2360,55 @@ "type": "string" }, "source": { - "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).", "allOf": [ { "$ref": "#/definitions/SessionSource" } - ] + ], + "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." }, "status": { - "description": "Current runtime status for the thread.", "allOf": [ { "$ref": "#/definitions/ThreadStatus" } - ] + ], + "description": "Current runtime status for the thread." }, "turns": { "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/Turn" - } + }, + "type": "array" }, "updatedAt": { "description": "Unix timestamp (in seconds) when the thread was last updated.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } - } + }, + "required": [ + "cliVersion", + "createdAt", + "cwd", + "ephemeral", + "id", + "modelProvider", + "preview", + "source", + "status", + "turns", + "updatedAt" + ], + "type": "object" }, "ThreadActiveFlag": { - "type": "string", "enum": [ "waitingOnApproval", "waitingOnUserInput" - ] + ], + "type": "string" }, "ThreadId": { "type": "string" @@ -2443,72 +2416,65 @@ "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -2516,10 +2482,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -2527,29 +2493,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -2558,59 +2525,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -2625,34 +2589,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -2665,40 +2629,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2707,34 +2673,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -2775,42 +2739,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -2834,33 +2799,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -2881,7 +2844,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -2889,52 +2851,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -2953,22 +2920,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -2977,23 +2944,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3021,22 +2987,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3045,22 +3012,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3069,138 +3036,137 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "ThreadStatus": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType" + "title": "NotLoadedThreadStatusType", + "type": "string" } }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType" + "title": "IdleThreadStatusType", + "type": "string" } }, - "title": "IdleThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "IdleThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType" + "title": "SystemErrorThreadStatusType", + "type": "string" } }, - "title": "SystemErrorThreadStatus" + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" }, { - "type": "object", + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, "required": [ "activeFlags", "type" ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" + "title": "ActiveThreadStatus", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -3208,36 +3174,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -3259,94 +3228,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -3355,33 +3322,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -3390,27 +3359,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3419,13 +3388,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -3434,11 +3403,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3447,25 +3416,56 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "backwardsCursor": { + "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one thread. Use it with the opposite `sortDirection`; for timestamp sorts it anchors at the start of the page timestamp so same-second updates are not skipped.", + "type": [ + "string", + "null" + ] + }, + "data": { + "items": { + "$ref": "#/definitions/Thread" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ThreadListResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListParams.json index 7c4e08c7..d10ee7ed 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListParams.json @@ -1,7 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadLoadedListParams", - "type": "object", "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -12,12 +10,14 @@ }, "limit": { "description": "Optional page size; defaults to no limit.", + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] } - } + }, + "title": "ThreadLoadedListParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListResponse.json index 7a1bbcde..cfd90fb8 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListResponse.json @@ -1,17 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadLoadedListResponse", - "type": "object", - "required": [ - "data" - ], "properties": { "data": { "description": "Thread ids for sessions currently loaded in memory.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "nextCursor": { "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.", @@ -20,5 +15,10 @@ "null" ] } - } + }, + "required": [ + "data" + ], + "title": "ThreadLoadedListResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateParams.json index 313a7626..c6679568 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateParams.json @@ -1,29 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadMetadataUpdateParams", - "type": "object", - "required": [ - "threadId" - ], - "properties": { - "gitInfo": { - "description": "Patch the stored Git metadata for this thread. Omit a field to leave it unchanged, set it to `null` to clear it, or provide a string to replace the stored value.", - "anyOf": [ - { - "$ref": "#/definitions/ThreadMetadataGitInfoUpdateParams" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - } - }, "definitions": { "ThreadMetadataGitInfoUpdateParams": { - "type": "object", "properties": { "branch": { "description": "Omit to leave the stored branch unchanged, set to `null` to clear it, or provide a non-empty string to replace it.", @@ -46,7 +24,29 @@ "null" ] } - } + }, + "type": "object" } - } + }, + "properties": { + "gitInfo": { + "anyOf": [ + { + "$ref": "#/definitions/ThreadMetadataGitInfoUpdateParams" + }, + { + "type": "null" + } + ], + "description": "Patch the stored Git metadata for this thread. Omit a field to leave it unchanged, set it to `null` to clear it, or provide a string to replace the stored value." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "threadId" + ], + "title": "ThreadMetadataUpdateParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateResponse.json index 8088377d..1846b3bd 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateResponse.json @@ -1,15 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadMetadataUpdateResponse", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "$ref": "#/definitions/Thread" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", @@ -19,29 +9,28 @@ "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -52,132 +41,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -188,10 +174,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -200,36 +189,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -241,21 +224,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -267,21 +252,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -299,119 +284,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], "properties": { "accepted_at": { "type": "string" @@ -455,42 +434,41 @@ "surface": { "type": "string" } - } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" }, "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], "properties": { "acceptance_sketch": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "blockers": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": "string" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "duplicate_of": { "type": [ @@ -499,10 +477,10 @@ ] }, "evidence_refs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "horizon": { "type": "string" @@ -514,10 +492,10 @@ "type": "string" }, "lane_hints": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -526,10 +504,10 @@ "type": "string" }, "source_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } + }, + "type": "array" }, "status": { "type": "string" @@ -546,14 +524,21 @@ "null" ] } - } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], "properties": { "diff_pressure": { "type": "string" @@ -568,12 +553,12 @@ "type": "string" }, "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "warning": { "type": [ @@ -581,21 +566,22 @@ "null" ] } - } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" }, "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], "properties": { "end_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "note": { "type": [ @@ -607,12 +593,12 @@ "type": "string" }, "start_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "symbol": { "type": [ @@ -620,22 +606,19 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -649,57 +632,59 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyGraph": { - "type": "object", "properties": { "edges": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphEdge" - } + }, + "type": "array" }, "nodes": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphNode" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], "properties": { "checkpoint_id": { "type": "string" }, "frontier_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "graph_revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -707,21 +692,20 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" }, "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": [ @@ -750,58 +734,59 @@ "target_id": { "type": "string" } - } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" }, "EpiphanyGraphFrontier": { - "type": "object", "properties": { "active_edge_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "active_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], "properties": { "architecture_node_id": { "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "dataflow_node_id": { "type": "string" @@ -812,21 +797,20 @@ "null" ] } - } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" }, "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -855,10 +839,15 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" }, "EpiphanyGraphs": { - "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -867,20 +856,15 @@ "$ref": "#/definitions/EpiphanyGraph" }, "links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphLink" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], "properties": { "description": { "type": "string" @@ -897,16 +881,15 @@ "status": { "type": "string" } - } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" }, "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], "properties": { "captured_at_turn_id": { "type": [ @@ -918,19 +901,19 @@ "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "disposition": { "$ref": "#/definitions/EpiphanyInvestigationDisposition" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "focus": { "type": "string" @@ -945,10 +928,10 @@ ] }, "open_questions": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -956,23 +939,23 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" }, "EpiphanyInvestigationDisposition": { - "type": "string", "enum": [ "resume_ready", "regather_required" - ] + ], + "type": "string" }, "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], "properties": { "authority_scope": { "type": [ @@ -993,16 +976,16 @@ "$ref": "#/definitions/EpiphanyJobKind" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "owner_role": { "type": "string" @@ -1010,29 +993,32 @@ "scope": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" }, "EpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "EpiphanyModeKind": { - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], "properties": { "kind": { "anyOf": [ @@ -1047,36 +1033,31 @@ "name": { "type": "string" } - } + }, + "required": [ + "name" + ], + "type": "object" }, "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], "properties": { "acceptance_criteria": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "evidence_required": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1085,25 +1066,25 @@ "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" }, "review_gates": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "risks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "scope": { "$ref": "#/definitions/EpiphanyObjectiveDraftScope" }, "source_item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "status": { "type": "string" @@ -1114,10 +1095,18 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyObjectiveDraftLanePlan": { - "type": "object", "properties": { "body": { "type": [ @@ -1155,45 +1144,39 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyObjectiveDraftScope": { - "type": "object", "properties": { "excludes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1207,17 +1190,16 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], "properties": { "body": { "type": [ @@ -1250,10 +1232,10 @@ "type": "string" }, "tags": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": "string" @@ -1264,20 +1246,23 @@ "null" ] } - } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" }, "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], "properties": { "blocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": [ @@ -1307,10 +1292,10 @@ ] }, "unblocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "urgency": { "type": [ @@ -1321,19 +1306,20 @@ "value": { "type": "string" } - } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" }, "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], "properties": { "assignees": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "author": { "type": [ @@ -1354,11 +1340,11 @@ ] }, "database_id": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "external_id": { "type": [ @@ -1379,21 +1365,21 @@ ] }, "issue_number": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "kind": { "type": "string" }, "labels": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "milestone": { "type": [ @@ -1443,34 +1429,37 @@ "null" ] } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "EpiphanyPlanningState": { - "type": "object", "properties": { "backlog_items": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyBacklogItem" - } + }, + "type": "array" }, "captures": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningCapture" - } + }, + "type": "array" }, "objective_drafts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObjectiveDraft" - } + }, + "type": "array" }, "roadmap_streams": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRoadmapStream" - } + }, + "type": "array" }, "workspace_root": { "type": [ @@ -1478,33 +1467,29 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], "properties": { "exact_available": { "type": "boolean" }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "path_prefix": { "type": "string" @@ -1516,26 +1501,27 @@ "type": "string" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" } - } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" }, "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], "properties": { "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "index_revision": { "type": [ @@ -1544,82 +1530,79 @@ ] }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "last_indexed_at_unix_seconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "semantic_available": { "type": "boolean" }, "shards": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRetrievalShardSummary" - } + }, + "type": "array" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" }, "workspace_root": { "type": "string" } - } + }, + "required": [ + "workspace_root" + ], + "type": "object" }, "EpiphanyRetrievalStatus": { - "type": "string", "enum": [ "unavailable", "ready", "stale", "indexing" - ] + ], + "type": "string" }, "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], "properties": { "blocked_by": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "near_term_focus": { "type": [ @@ -1642,18 +1625,16 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" }, "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], "properties": { "authority_scope": { "type": "string" @@ -1665,16 +1646,16 @@ "type": "string" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "role_id": { "type": "string" @@ -1691,10 +1672,18 @@ "surface": { "type": "string" } - } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" }, "EpiphanyScratchPad": { - "type": "object", "properties": { "hypothesis": { "type": [ @@ -1709,10 +1698,10 @@ ] }, "notes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1720,15 +1709,10 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], "properties": { "id": { "type": "string" @@ -1745,19 +1729,21 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" }, "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], "properties": { "acceptance_receipts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } + }, + "type": "array" }, "active_subgoal_id": { "type": [ @@ -1799,10 +1785,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - } + }, + "type": "array" }, "investigation_checkpoint": { "anyOf": [ @@ -1815,10 +1801,10 @@ ] }, "job_bindings": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - } + }, + "type": "array" }, "last_updated_turn_id": { "type": [ @@ -1843,19 +1829,19 @@ ] }, "observations": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - } + }, + "type": "array" }, "planning": { "$ref": "#/definitions/EpiphanyPlanningState" }, "recent_evidence": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - } + }, + "type": "array" }, "retrieval": { "anyOf": [ @@ -1868,15 +1854,15 @@ ] }, "revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "runtime_links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - } + }, + "type": "array" }, "scratch": { "anyOf": [ @@ -1889,20 +1875,18 @@ ] }, "subgoals": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - } + }, + "type": "array" } - } + }, + "required": [ + "revision" + ], + "type": "object" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -1913,10 +1897,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "GitInfo": { - "type": "object", "properties": { "branch": { "type": [ @@ -1936,14 +1925,10 @@ "null" ] } - } + }, + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -1951,80 +1936,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -2032,82 +2015,85 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -2116,20 +2102,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -2137,70 +2126,63 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "SessionSource": { "oneOf": [ { - "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "custom" - ], + "additionalProperties": false, "properties": { "custom": { "type": "string" } }, - "additionalProperties": false, - "title": "CustomSessionSource" + "required": [ + "custom" + ], + "title": "CustomSessionSource", + "type": "object" }, { - "type": "object", - "required": [ - "subAgent" - ], + "additionalProperties": false, "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "additionalProperties": false, - "title": "SubAgentSessionSource" + "required": [ + "subAgent" + ], + "title": "SubAgentSessionSource", + "type": "object" } ] }, "SubAgentSource": { "oneOf": [ { - "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "thread_spawn" - ], + "additionalProperties": false, "properties": { "thread_spawn": { - "type": "object", - "required": [ - "depth", - "parent_thread_id" - ], "properties": { "agent_nickname": { "default": null, @@ -2210,7 +2192,6 @@ ] }, "agent_path": { - "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2218,7 +2199,8 @@ { "type": "null" } - ] + ], + "default": null }, "agent_role": { "default": null, @@ -2228,46 +2210,50 @@ ] }, "depth": { - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - } + }, + "required": [ + "depth", + "parent_thread_id" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ThreadSpawnSubAgentSource" + "required": [ + "thread_spawn" + ], + "title": "ThreadSpawnSubAgentSource", + "type": "object" }, { - "type": "object", - "required": [ - "other" - ], + "additionalProperties": false, "properties": { "other": { "type": "string" } }, - "additionalProperties": false, - "title": "OtherSubAgentSource" + "required": [ + "other" + ], + "title": "OtherSubAgentSource", + "type": "object" } ] }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -2276,23 +2262,13 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "Thread": { - "type": "object", - "required": [ - "cliVersion", - "createdAt", - "cwd", - "ephemeral", - "id", - "modelProvider", - "preview", - "source", - "status", - "turns", - "updatedAt" - ], "properties": { "agentNickname": { "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", @@ -2314,23 +2290,22 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "cwd": { - "description": "Working directory captured for the thread.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Working directory captured for the thread." }, "ephemeral": { "description": "Whether the thread is ephemeral and should not be materialized on disk.", "type": "boolean" }, "epiphanyState": { - "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads.", "anyOf": [ { "$ref": "#/definitions/EpiphanyThreadState" @@ -2338,7 +2313,8 @@ { "type": "null" } - ] + ], + "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads." }, "forkedFromId": { "description": "Source thread id when this thread was created by forking another thread.", @@ -2348,7 +2324,6 @@ ] }, "gitInfo": { - "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2356,7 +2331,8 @@ { "type": "null" } - ] + ], + "description": "Optional Git metadata captured when the thread was created." }, "id": { "type": "string" @@ -2384,41 +2360,55 @@ "type": "string" }, "source": { - "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).", "allOf": [ { "$ref": "#/definitions/SessionSource" } - ] + ], + "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." }, "status": { - "description": "Current runtime status for the thread.", "allOf": [ { "$ref": "#/definitions/ThreadStatus" } - ] + ], + "description": "Current runtime status for the thread." }, "turns": { "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/Turn" - } + }, + "type": "array" }, "updatedAt": { "description": "Unix timestamp (in seconds) when the thread was last updated.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } - } + }, + "required": [ + "cliVersion", + "createdAt", + "cwd", + "ephemeral", + "id", + "modelProvider", + "preview", + "source", + "status", + "turns", + "updatedAt" + ], + "type": "object" }, "ThreadActiveFlag": { - "type": "string", "enum": [ "waitingOnApproval", "waitingOnUserInput" - ] + ], + "type": "string" }, "ThreadId": { "type": "string" @@ -2426,72 +2416,65 @@ "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -2499,10 +2482,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -2510,29 +2493,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -2541,59 +2525,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -2608,34 +2589,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -2648,40 +2629,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2690,34 +2673,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -2758,42 +2739,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -2817,33 +2799,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -2864,7 +2844,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -2872,52 +2851,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -2936,22 +2920,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -2960,23 +2944,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3004,22 +2987,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3028,22 +3012,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3052,138 +3036,137 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "ThreadStatus": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType" + "title": "NotLoadedThreadStatusType", + "type": "string" } }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType" + "title": "IdleThreadStatusType", + "type": "string" } }, - "title": "IdleThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "IdleThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType" + "title": "SystemErrorThreadStatusType", + "type": "string" } }, - "title": "SystemErrorThreadStatus" + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" }, { - "type": "object", + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, "required": [ "activeFlags", "type" ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" + "title": "ActiveThreadStatus", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -3191,36 +3174,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -3242,94 +3228,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -3338,33 +3322,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -3373,27 +3359,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3402,13 +3388,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -3417,11 +3403,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3430,25 +3416,39 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "thread" + ], + "title": "ThreadMetadataUpdateResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadNameUpdatedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadNameUpdatedNotification.json index 705cd8b0..8c3b2095 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadNameUpdatedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadNameUpdatedNotification.json @@ -1,10 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadNameUpdatedNotification", - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" @@ -15,5 +10,10 @@ "null" ] } - } + }, + "required": [ + "threadId" + ], + "title": "ThreadNameUpdatedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadReadParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadReadParams.json index 76ce44a9..f5e5503c 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadReadParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadReadParams.json @@ -1,18 +1,18 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadReadParams", - "type": "object", - "required": [ - "threadId" - ], "properties": { "includeTurns": { - "description": "When true, include turns and their items from rollout history.", "default": false, + "description": "When true, include turns and their items from rollout history.", "type": "boolean" }, "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "title": "ThreadReadParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json index 68c0e574..5e46c5de 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json @@ -1,15 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadReadResponse", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "$ref": "#/definitions/Thread" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", @@ -19,29 +9,28 @@ "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -52,132 +41,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -188,10 +174,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -200,36 +189,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -241,21 +224,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -267,21 +252,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -299,119 +284,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], "properties": { "accepted_at": { "type": "string" @@ -455,42 +434,41 @@ "surface": { "type": "string" } - } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" }, "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], "properties": { "acceptance_sketch": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "blockers": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": "string" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "duplicate_of": { "type": [ @@ -499,10 +477,10 @@ ] }, "evidence_refs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "horizon": { "type": "string" @@ -514,10 +492,10 @@ "type": "string" }, "lane_hints": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -526,10 +504,10 @@ "type": "string" }, "source_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } + }, + "type": "array" }, "status": { "type": "string" @@ -546,14 +524,21 @@ "null" ] } - } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], "properties": { "diff_pressure": { "type": "string" @@ -568,12 +553,12 @@ "type": "string" }, "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "warning": { "type": [ @@ -581,21 +566,22 @@ "null" ] } - } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" }, "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], "properties": { "end_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "note": { "type": [ @@ -607,12 +593,12 @@ "type": "string" }, "start_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "symbol": { "type": [ @@ -620,22 +606,19 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -649,57 +632,59 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyGraph": { - "type": "object", "properties": { "edges": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphEdge" - } + }, + "type": "array" }, "nodes": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphNode" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], "properties": { "checkpoint_id": { "type": "string" }, "frontier_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "graph_revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -707,21 +692,20 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" }, "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": [ @@ -750,58 +734,59 @@ "target_id": { "type": "string" } - } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" }, "EpiphanyGraphFrontier": { - "type": "object", "properties": { "active_edge_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "active_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], "properties": { "architecture_node_id": { "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "dataflow_node_id": { "type": "string" @@ -812,21 +797,20 @@ "null" ] } - } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" }, "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -855,10 +839,15 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" }, "EpiphanyGraphs": { - "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -867,20 +856,15 @@ "$ref": "#/definitions/EpiphanyGraph" }, "links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphLink" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], "properties": { "description": { "type": "string" @@ -897,16 +881,15 @@ "status": { "type": "string" } - } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" }, "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], "properties": { "captured_at_turn_id": { "type": [ @@ -918,19 +901,19 @@ "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "disposition": { "$ref": "#/definitions/EpiphanyInvestigationDisposition" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "focus": { "type": "string" @@ -945,10 +928,10 @@ ] }, "open_questions": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -956,23 +939,23 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" }, "EpiphanyInvestigationDisposition": { - "type": "string", "enum": [ "resume_ready", "regather_required" - ] + ], + "type": "string" }, "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], "properties": { "authority_scope": { "type": [ @@ -993,16 +976,16 @@ "$ref": "#/definitions/EpiphanyJobKind" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "owner_role": { "type": "string" @@ -1010,29 +993,32 @@ "scope": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" }, "EpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "EpiphanyModeKind": { - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], "properties": { "kind": { "anyOf": [ @@ -1047,36 +1033,31 @@ "name": { "type": "string" } - } + }, + "required": [ + "name" + ], + "type": "object" }, "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], "properties": { "acceptance_criteria": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "evidence_required": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1085,25 +1066,25 @@ "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" }, "review_gates": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "risks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "scope": { "$ref": "#/definitions/EpiphanyObjectiveDraftScope" }, "source_item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "status": { "type": "string" @@ -1114,10 +1095,18 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyObjectiveDraftLanePlan": { - "type": "object", "properties": { "body": { "type": [ @@ -1155,45 +1144,39 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyObjectiveDraftScope": { - "type": "object", "properties": { "excludes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1207,17 +1190,16 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], "properties": { "body": { "type": [ @@ -1250,10 +1232,10 @@ "type": "string" }, "tags": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": "string" @@ -1264,20 +1246,23 @@ "null" ] } - } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" }, "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], "properties": { "blocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": [ @@ -1307,10 +1292,10 @@ ] }, "unblocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "urgency": { "type": [ @@ -1321,19 +1306,20 @@ "value": { "type": "string" } - } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" }, "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], "properties": { "assignees": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "author": { "type": [ @@ -1354,11 +1340,11 @@ ] }, "database_id": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "external_id": { "type": [ @@ -1379,21 +1365,21 @@ ] }, "issue_number": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "kind": { "type": "string" }, "labels": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "milestone": { "type": [ @@ -1443,34 +1429,37 @@ "null" ] } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "EpiphanyPlanningState": { - "type": "object", "properties": { "backlog_items": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyBacklogItem" - } + }, + "type": "array" }, "captures": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningCapture" - } + }, + "type": "array" }, "objective_drafts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObjectiveDraft" - } + }, + "type": "array" }, "roadmap_streams": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRoadmapStream" - } + }, + "type": "array" }, "workspace_root": { "type": [ @@ -1478,33 +1467,29 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], "properties": { "exact_available": { "type": "boolean" }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "path_prefix": { "type": "string" @@ -1516,26 +1501,27 @@ "type": "string" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" } - } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" }, "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], "properties": { "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "index_revision": { "type": [ @@ -1544,82 +1530,79 @@ ] }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "last_indexed_at_unix_seconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "semantic_available": { "type": "boolean" }, "shards": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRetrievalShardSummary" - } + }, + "type": "array" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" }, "workspace_root": { "type": "string" } - } + }, + "required": [ + "workspace_root" + ], + "type": "object" }, "EpiphanyRetrievalStatus": { - "type": "string", "enum": [ "unavailable", "ready", "stale", "indexing" - ] + ], + "type": "string" }, "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], "properties": { "blocked_by": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "near_term_focus": { "type": [ @@ -1642,18 +1625,16 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" }, "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], "properties": { "authority_scope": { "type": "string" @@ -1665,16 +1646,16 @@ "type": "string" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "role_id": { "type": "string" @@ -1691,10 +1672,18 @@ "surface": { "type": "string" } - } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" }, "EpiphanyScratchPad": { - "type": "object", "properties": { "hypothesis": { "type": [ @@ -1709,10 +1698,10 @@ ] }, "notes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1720,15 +1709,10 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], "properties": { "id": { "type": "string" @@ -1745,19 +1729,21 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" }, "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], "properties": { "acceptance_receipts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } + }, + "type": "array" }, "active_subgoal_id": { "type": [ @@ -1799,10 +1785,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - } + }, + "type": "array" }, "investigation_checkpoint": { "anyOf": [ @@ -1815,10 +1801,10 @@ ] }, "job_bindings": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - } + }, + "type": "array" }, "last_updated_turn_id": { "type": [ @@ -1843,19 +1829,19 @@ ] }, "observations": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - } + }, + "type": "array" }, "planning": { "$ref": "#/definitions/EpiphanyPlanningState" }, "recent_evidence": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - } + }, + "type": "array" }, "retrieval": { "anyOf": [ @@ -1868,15 +1854,15 @@ ] }, "revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "runtime_links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - } + }, + "type": "array" }, "scratch": { "anyOf": [ @@ -1889,20 +1875,18 @@ ] }, "subgoals": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - } + }, + "type": "array" } - } + }, + "required": [ + "revision" + ], + "type": "object" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -1913,10 +1897,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "GitInfo": { - "type": "object", "properties": { "branch": { "type": [ @@ -1936,14 +1925,10 @@ "null" ] } - } + }, + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -1951,80 +1936,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -2032,82 +2015,85 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -2116,20 +2102,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -2137,70 +2126,63 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "SessionSource": { "oneOf": [ { - "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "custom" - ], + "additionalProperties": false, "properties": { "custom": { "type": "string" } }, - "additionalProperties": false, - "title": "CustomSessionSource" + "required": [ + "custom" + ], + "title": "CustomSessionSource", + "type": "object" }, { - "type": "object", - "required": [ - "subAgent" - ], + "additionalProperties": false, "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "additionalProperties": false, - "title": "SubAgentSessionSource" + "required": [ + "subAgent" + ], + "title": "SubAgentSessionSource", + "type": "object" } ] }, "SubAgentSource": { "oneOf": [ { - "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "thread_spawn" - ], + "additionalProperties": false, "properties": { "thread_spawn": { - "type": "object", - "required": [ - "depth", - "parent_thread_id" - ], "properties": { "agent_nickname": { "default": null, @@ -2210,7 +2192,6 @@ ] }, "agent_path": { - "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2218,7 +2199,8 @@ { "type": "null" } - ] + ], + "default": null }, "agent_role": { "default": null, @@ -2228,46 +2210,50 @@ ] }, "depth": { - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - } + }, + "required": [ + "depth", + "parent_thread_id" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ThreadSpawnSubAgentSource" + "required": [ + "thread_spawn" + ], + "title": "ThreadSpawnSubAgentSource", + "type": "object" }, { - "type": "object", - "required": [ - "other" - ], + "additionalProperties": false, "properties": { "other": { "type": "string" } }, - "additionalProperties": false, - "title": "OtherSubAgentSource" + "required": [ + "other" + ], + "title": "OtherSubAgentSource", + "type": "object" } ] }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -2276,23 +2262,13 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "Thread": { - "type": "object", - "required": [ - "cliVersion", - "createdAt", - "cwd", - "ephemeral", - "id", - "modelProvider", - "preview", - "source", - "status", - "turns", - "updatedAt" - ], "properties": { "agentNickname": { "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", @@ -2314,23 +2290,22 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "cwd": { - "description": "Working directory captured for the thread.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Working directory captured for the thread." }, "ephemeral": { "description": "Whether the thread is ephemeral and should not be materialized on disk.", "type": "boolean" }, "epiphanyState": { - "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads.", "anyOf": [ { "$ref": "#/definitions/EpiphanyThreadState" @@ -2338,7 +2313,8 @@ { "type": "null" } - ] + ], + "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads." }, "forkedFromId": { "description": "Source thread id when this thread was created by forking another thread.", @@ -2348,7 +2324,6 @@ ] }, "gitInfo": { - "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2356,7 +2331,8 @@ { "type": "null" } - ] + ], + "description": "Optional Git metadata captured when the thread was created." }, "id": { "type": "string" @@ -2384,41 +2360,55 @@ "type": "string" }, "source": { - "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).", "allOf": [ { "$ref": "#/definitions/SessionSource" } - ] + ], + "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." }, "status": { - "description": "Current runtime status for the thread.", "allOf": [ { "$ref": "#/definitions/ThreadStatus" } - ] + ], + "description": "Current runtime status for the thread." }, "turns": { "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/Turn" - } + }, + "type": "array" }, "updatedAt": { "description": "Unix timestamp (in seconds) when the thread was last updated.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } - } + }, + "required": [ + "cliVersion", + "createdAt", + "cwd", + "ephemeral", + "id", + "modelProvider", + "preview", + "source", + "status", + "turns", + "updatedAt" + ], + "type": "object" }, "ThreadActiveFlag": { - "type": "string", "enum": [ "waitingOnApproval", "waitingOnUserInput" - ] + ], + "type": "string" }, "ThreadId": { "type": "string" @@ -2426,72 +2416,65 @@ "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -2499,10 +2482,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -2510,29 +2493,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -2541,59 +2525,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -2608,34 +2589,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -2648,40 +2629,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2690,34 +2673,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -2758,42 +2739,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -2817,33 +2799,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -2864,7 +2844,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -2872,52 +2851,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -2936,22 +2920,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -2960,23 +2944,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3004,22 +2987,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3028,22 +3012,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3052,138 +3036,137 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "ThreadStatus": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType" + "title": "NotLoadedThreadStatusType", + "type": "string" } }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType" + "title": "IdleThreadStatusType", + "type": "string" } }, - "title": "IdleThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "IdleThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType" + "title": "SystemErrorThreadStatusType", + "type": "string" } }, - "title": "SystemErrorThreadStatus" + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" }, { - "type": "object", + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, "required": [ "activeFlags", "type" ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" + "title": "ActiveThreadStatus", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -3191,36 +3174,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -3242,94 +3228,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -3338,33 +3322,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -3373,27 +3359,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3402,13 +3388,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -3417,11 +3403,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3430,25 +3416,39 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "thread" + ], + "title": "ThreadReadResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeClosedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeClosedNotification.json index 58276d18..edfba83b 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeClosedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeClosedNotification.json @@ -1,11 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeClosedNotification", "description": "EXPERIMENTAL - emitted when thread realtime transport closes.", - "type": "object", - "required": [ - "threadId" - ], "properties": { "reason": { "type": [ @@ -16,5 +11,10 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "title": "ThreadRealtimeClosedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeErrorNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeErrorNotification.json index 0ddd7d48..e7ec7603 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeErrorNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeErrorNotification.json @@ -1,12 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeErrorNotification", "description": "EXPERIMENTAL - emitted when thread realtime encounters an error.", - "type": "object", - "required": [ - "message", - "threadId" - ], "properties": { "message": { "type": "string" @@ -14,5 +8,11 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "message", + "threadId" + ], + "title": "ThreadRealtimeErrorNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeItemAddedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeItemAddedNotification.json index 00fe35cf..06de7e00 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeItemAddedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeItemAddedNotification.json @@ -1,16 +1,16 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeItemAddedNotification", "description": "EXPERIMENTAL - raw non-audio thread realtime item emitted by the backend.", - "type": "object", - "required": [ - "item", - "threadId" - ], "properties": { "item": true, "threadId": { "type": "string" } - } + }, + "required": [ + "item", + "threadId" + ], + "title": "ThreadRealtimeItemAddedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeOutputAudioDeltaNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeOutputAudioDeltaNotification.json index 5e681f5c..6c75f675 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeOutputAudioDeltaNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeOutputAudioDeltaNotification.json @@ -1,29 +1,8 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeOutputAudioDeltaNotification", - "description": "EXPERIMENTAL - streamed output audio emitted by thread realtime.", - "type": "object", - "required": [ - "audio", - "threadId" - ], - "properties": { - "audio": { - "$ref": "#/definitions/ThreadRealtimeAudioChunk" - }, - "threadId": { - "type": "string" - } - }, "definitions": { "ThreadRealtimeAudioChunk": { "description": "EXPERIMENTAL - thread realtime audio chunk.", - "type": "object", - "required": [ - "data", - "numChannels", - "sampleRate" - ], "properties": { "data": { "type": "string" @@ -35,24 +14,45 @@ ] }, "numChannels": { - "type": "integer", "format": "uint16", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "sampleRate": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "samplesPerChannel": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] } - } + }, + "required": [ + "data", + "numChannels", + "sampleRate" + ], + "type": "object" } - } + }, + "description": "EXPERIMENTAL - streamed output audio emitted by thread realtime.", + "properties": { + "audio": { + "$ref": "#/definitions/ThreadRealtimeAudioChunk" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "audio", + "threadId" + ], + "title": "ThreadRealtimeOutputAudioDeltaNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeSdpNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeSdpNotification.json index 94089a9b..907dc856 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeSdpNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeSdpNotification.json @@ -1,12 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeSdpNotification", "description": "EXPERIMENTAL - emitted with the remote SDP for a WebRTC realtime session.", - "type": "object", - "required": [ - "sdp", - "threadId" - ], "properties": { "sdp": { "type": "string" @@ -14,5 +8,11 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "sdp", + "threadId" + ], + "title": "ThreadRealtimeSdpNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeStartedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeStartedNotification.json index 3fea2c80..dd94a5cc 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeStartedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeStartedNotification.json @@ -1,12 +1,15 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeStartedNotification", + "definitions": { + "RealtimeConversationVersion": { + "enum": [ + "v1", + "v2" + ], + "type": "string" + } + }, "description": "EXPERIMENTAL - emitted when thread realtime startup is accepted.", - "type": "object", - "required": [ - "threadId", - "version" - ], "properties": { "sessionId": { "type": [ @@ -21,13 +24,10 @@ "$ref": "#/definitions/RealtimeConversationVersion" } }, - "definitions": { - "RealtimeConversationVersion": { - "type": "string", - "enum": [ - "v1", - "v2" - ] - } - } + "required": [ + "threadId", + "version" + ], + "title": "ThreadRealtimeStartedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeTranscriptDeltaNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeTranscriptDeltaNotification.json index 06629209..22ad778e 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeTranscriptDeltaNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeTranscriptDeltaNotification.json @@ -1,13 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeTranscriptDeltaNotification", "description": "EXPERIMENTAL - flat transcript delta emitted whenever realtime transcript text changes.", - "type": "object", - "required": [ - "delta", - "role", - "threadId" - ], "properties": { "delta": { "description": "Live transcript delta from the realtime event.", @@ -19,5 +12,12 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "delta", + "role", + "threadId" + ], + "title": "ThreadRealtimeTranscriptDeltaNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeTranscriptDoneNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeTranscriptDoneNotification.json index f19a70a4..2f4199fd 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeTranscriptDoneNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRealtimeTranscriptDoneNotification.json @@ -1,13 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRealtimeTranscriptDoneNotification", "description": "EXPERIMENTAL - final transcript text emitted when realtime completes a transcript part.", - "type": "object", - "required": [ - "role", - "text", - "threadId" - ], "properties": { "role": { "type": "string" @@ -19,5 +12,12 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "role", + "text", + "threadId" + ], + "title": "ThreadRealtimeTranscriptDoneNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeParams.json index 046c6e38..24dcc096 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeParams.json @@ -1,11 +1,1267 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadResumeParams", + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + }, + "ApprovalsReviewer": { + "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", + "enum": [ + "user", + "auto_review", + "guardian_subagent" + ], + "type": "string" + }, + "AskForApproval": { + "oneOf": [ + { + "enum": [ + "untrusted", + "on-failure", + "on-request", + "never" + ], + "type": "string" + }, + { + "additionalProperties": false, + "properties": { + "granular": { + "properties": { + "mcp_elicitations": { + "type": "boolean" + }, + "request_permissions": { + "default": false, + "type": "boolean" + }, + "rules": { + "type": "boolean" + }, + "sandbox_approval": { + "type": "boolean" + } + }, + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], + "type": "object" + } + }, + "required": [ + "granular" + ], + "title": "GranularAskForApproval", + "type": "object" + } + ] + }, + "ContentItem": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "input_text" + ], + "title": "InputTextContentItemType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "InputTextContentItem", + "type": "object" + }, + { + "properties": { + "detail": { + "anyOf": [ + { + "$ref": "#/definitions/ImageDetail" + }, + { + "type": "null" + } + ] + }, + "image_url": { + "type": "string" + }, + "type": { + "enum": [ + "input_image" + ], + "title": "InputImageContentItemType", + "type": "string" + } + }, + "required": [ + "image_url", + "type" + ], + "title": "InputImageContentItem", + "type": "object" + }, + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "output_text" + ], + "title": "OutputTextContentItemType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "OutputTextContentItem", + "type": "object" + } + ] + }, + "FileSystemAccessMode": { + "enum": [ + "read", + "write", + "none" + ], + "type": "string" + }, + "FileSystemPath": { + "oneOf": [ + { + "properties": { + "path": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": { + "enum": [ + "path" + ], + "title": "PathFileSystemPathType", + "type": "string" + } + }, + "required": [ + "path", + "type" + ], + "title": "PathFileSystemPath", + "type": "object" + }, + { + "properties": { + "pattern": { + "type": "string" + }, + "type": { + "enum": [ + "glob_pattern" + ], + "title": "GlobPatternFileSystemPathType", + "type": "string" + } + }, + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "special" + ], + "title": "SpecialFileSystemPathType", + "type": "string" + }, + "value": { + "$ref": "#/definitions/FileSystemSpecialPath" + } + }, + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" + } + ] + }, + "FileSystemSandboxEntry": { + "properties": { + "access": { + "$ref": "#/definitions/FileSystemAccessMode" + }, + "path": { + "$ref": "#/definitions/FileSystemPath" + } + }, + "required": [ + "access", + "path" + ], + "type": "object" + }, + "FileSystemSpecialPath": { + "oneOf": [ + { + "properties": { + "kind": { + "enum": [ + "root" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "minimal" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "current_working_directory" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "project_roots" + ], + "type": "string" + }, + "subpath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind" + ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "tmpdir" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "unknown" + ], + "type": "string" + }, + "path": { + "type": "string" + }, + "subpath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind", + "path" + ], + "type": "object" + } + ] + }, + "FunctionCallOutputBody": { + "anyOf": [ + { + "type": "string" + }, + { + "items": { + "$ref": "#/definitions/FunctionCallOutputContentItem" + }, + "type": "array" + } + ] + }, + "FunctionCallOutputContentItem": { + "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.", + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "input_text" + ], + "title": "InputTextFunctionCallOutputContentItemType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "InputTextFunctionCallOutputContentItem", + "type": "object" + }, + { + "properties": { + "detail": { + "anyOf": [ + { + "$ref": "#/definitions/ImageDetail" + }, + { + "type": "null" + } + ] + }, + "image_url": { + "type": "string" + }, + "type": { + "enum": [ + "input_image" + ], + "title": "InputImageFunctionCallOutputContentItemType", + "type": "string" + } + }, + "required": [ + "image_url", + "type" + ], + "title": "InputImageFunctionCallOutputContentItem", + "type": "object" + } + ] + }, + "GhostCommit": { + "description": "Details of a ghost commit created from a repository state.", + "properties": { + "id": { + "type": "string" + }, + "parent": { + "type": [ + "string", + "null" + ] + }, + "preexisting_untracked_dirs": { + "items": { + "type": "string" + }, + "type": "array" + }, + "preexisting_untracked_files": { + "items": { + "type": "string" + }, + "type": "array" + } + }, + "required": [ + "id", + "preexisting_untracked_dirs", + "preexisting_untracked_files" + ], + "type": "object" + }, + "ImageDetail": { + "enum": [ + "auto", + "low", + "high", + "original" + ], + "type": "string" + }, + "LocalShellAction": { + "oneOf": [ + { + "properties": { + "command": { + "items": { + "type": "string" + }, + "type": "array" + }, + "env": { + "additionalProperties": { + "type": "string" + }, + "type": [ + "object", + "null" + ] + }, + "timeout_ms": { + "format": "uint64", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + }, + "type": { + "enum": [ + "exec" + ], + "title": "ExecLocalShellActionType", + "type": "string" + }, + "user": { + "type": [ + "string", + "null" + ] + }, + "working_directory": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "command", + "type" + ], + "title": "ExecLocalShellAction", + "type": "object" + } + ] + }, + "LocalShellStatus": { + "enum": [ + "completed", + "in_progress", + "incomplete" + ], + "type": "string" + }, + "MessagePhase": { + "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", + "oneOf": [ + { + "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", + "enum": [ + "commentary" + ], + "type": "string" + }, + { + "description": "The assistant's terminal answer text for the current turn.", + "enum": [ + "final_answer" + ], + "type": "string" + } + ] + }, + "PermissionProfile": { + "properties": { + "fileSystem": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfileFileSystemPermissions" + }, + { + "type": "null" + } + ] + }, + "network": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfileNetworkPermissions" + }, + { + "type": "null" + } + ] + } + }, + "type": "object" + }, + "PermissionProfileFileSystemPermissions": { + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + }, + "type": "array" + }, + "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "entries" + ], + "type": "object" + }, + "PermissionProfileNetworkPermissions": { + "properties": { + "enabled": { + "type": [ + "boolean", + "null" + ] + } + }, + "type": "object" + }, + "Personality": { + "enum": [ + "none", + "friendly", + "pragmatic" + ], + "type": "string" + }, + "ReasoningItemContent": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "reasoning_text" + ], + "title": "ReasoningTextReasoningItemContentType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "ReasoningTextReasoningItemContent", + "type": "object" + }, + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "text" + ], + "title": "TextReasoningItemContentType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "TextReasoningItemContent", + "type": "object" + } + ] + }, + "ReasoningItemReasoningSummary": { + "oneOf": [ + { + "properties": { + "text": { + "type": "string" + }, + "type": { + "enum": [ + "summary_text" + ], + "title": "SummaryTextReasoningItemReasoningSummaryType", + "type": "string" + } + }, + "required": [ + "text", + "type" + ], + "title": "SummaryTextReasoningItemReasoningSummary", + "type": "object" + } + ] + }, + "ResponseItem": { + "oneOf": [ + { + "properties": { + "content": { + "items": { + "$ref": "#/definitions/ContentItem" + }, + "type": "array" + }, + "end_turn": { + "type": [ + "boolean", + "null" + ] + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "phase": { + "anyOf": [ + { + "$ref": "#/definitions/MessagePhase" + }, + { + "type": "null" + } + ] + }, + "role": { + "type": "string" + }, + "type": { + "enum": [ + "message" + ], + "title": "MessageResponseItemType", + "type": "string" + } + }, + "required": [ + "content", + "role", + "type" + ], + "title": "MessageResponseItem", + "type": "object" + }, + { + "properties": { + "content": { + "default": null, + "items": { + "$ref": "#/definitions/ReasoningItemContent" + }, + "type": [ + "array", + "null" + ] + }, + "encrypted_content": { + "type": [ + "string", + "null" + ] + }, + "summary": { + "items": { + "$ref": "#/definitions/ReasoningItemReasoningSummary" + }, + "type": "array" + }, + "type": { + "enum": [ + "reasoning" + ], + "title": "ReasoningResponseItemType", + "type": "string" + } + }, + "required": [ + "summary", + "type" + ], + "title": "ReasoningResponseItem", + "type": "object" + }, + { + "properties": { + "action": { + "$ref": "#/definitions/LocalShellAction" + }, + "call_id": { + "description": "Set when using the Responses API.", + "type": [ + "string", + "null" + ] + }, + "id": { + "description": "Legacy id field retained for compatibility with older payloads.", + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "status": { + "$ref": "#/definitions/LocalShellStatus" + }, + "type": { + "enum": [ + "local_shell_call" + ], + "title": "LocalShellCallResponseItemType", + "type": "string" + } + }, + "required": [ + "action", + "status", + "type" + ], + "title": "LocalShellCallResponseItem", + "type": "object" + }, + { + "properties": { + "arguments": { + "type": "string" + }, + "call_id": { + "type": "string" + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "name": { + "type": "string" + }, + "namespace": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "function_call" + ], + "title": "FunctionCallResponseItemType", + "type": "string" + } + }, + "required": [ + "arguments", + "call_id", + "name", + "type" + ], + "title": "FunctionCallResponseItem", + "type": "object" + }, + { + "properties": { + "arguments": true, + "call_id": { + "type": [ + "string", + "null" + ] + }, + "execution": { + "type": "string" + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "status": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "tool_search_call" + ], + "title": "ToolSearchCallResponseItemType", + "type": "string" + } + }, + "required": [ + "arguments", + "execution", + "type" + ], + "title": "ToolSearchCallResponseItem", + "type": "object" + }, + { + "properties": { + "call_id": { + "type": "string" + }, + "output": { + "$ref": "#/definitions/FunctionCallOutputBody" + }, + "type": { + "enum": [ + "function_call_output" + ], + "title": "FunctionCallOutputResponseItemType", + "type": "string" + } + }, + "required": [ + "call_id", + "output", + "type" + ], + "title": "FunctionCallOutputResponseItem", + "type": "object" + }, + { + "properties": { + "call_id": { + "type": "string" + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "input": { + "type": "string" + }, + "name": { + "type": "string" + }, + "status": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "custom_tool_call" + ], + "title": "CustomToolCallResponseItemType", + "type": "string" + } + }, + "required": [ + "call_id", + "input", + "name", + "type" + ], + "title": "CustomToolCallResponseItem", + "type": "object" + }, + { + "properties": { + "call_id": { + "type": "string" + }, + "name": { + "type": [ + "string", + "null" + ] + }, + "output": { + "$ref": "#/definitions/FunctionCallOutputBody" + }, + "type": { + "enum": [ + "custom_tool_call_output" + ], + "title": "CustomToolCallOutputResponseItemType", + "type": "string" + } + }, + "required": [ + "call_id", + "output", + "type" + ], + "title": "CustomToolCallOutputResponseItem", + "type": "object" + }, + { + "properties": { + "call_id": { + "type": [ + "string", + "null" + ] + }, + "execution": { + "type": "string" + }, + "status": { + "type": "string" + }, + "tools": { + "items": true, + "type": "array" + }, + "type": { + "enum": [ + "tool_search_output" + ], + "title": "ToolSearchOutputResponseItemType", + "type": "string" + } + }, + "required": [ + "execution", + "status", + "tools", + "type" + ], + "title": "ToolSearchOutputResponseItem", + "type": "object" + }, + { + "properties": { + "action": { + "anyOf": [ + { + "$ref": "#/definitions/ResponsesApiWebSearchAction" + }, + { + "type": "null" + } + ] + }, + "id": { + "type": [ + "string", + "null" + ], + "writeOnly": true + }, + "status": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "web_search_call" + ], + "title": "WebSearchCallResponseItemType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "WebSearchCallResponseItem", + "type": "object" + }, + { + "properties": { + "id": { + "type": "string" + }, + "result": { + "type": "string" + }, + "revised_prompt": { + "type": [ + "string", + "null" + ] + }, + "status": { + "type": "string" + }, + "type": { + "enum": [ + "image_generation_call" + ], + "title": "ImageGenerationCallResponseItemType", + "type": "string" + } + }, + "required": [ + "id", + "result", + "status", + "type" + ], + "title": "ImageGenerationCallResponseItem", + "type": "object" + }, + { + "properties": { + "ghost_commit": { + "$ref": "#/definitions/GhostCommit" + }, + "type": { + "enum": [ + "ghost_snapshot" + ], + "title": "GhostSnapshotResponseItemType", + "type": "string" + } + }, + "required": [ + "ghost_commit", + "type" + ], + "title": "GhostSnapshotResponseItem", + "type": "object" + }, + { + "properties": { + "encrypted_content": { + "type": "string" + }, + "type": { + "enum": [ + "compaction" + ], + "title": "CompactionResponseItemType", + "type": "string" + } + }, + "required": [ + "encrypted_content", + "type" + ], + "title": "CompactionResponseItem", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "other" + ], + "title": "OtherResponseItemType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "OtherResponseItem", + "type": "object" + } + ] + }, + "ResponsesApiWebSearchAction": { + "oneOf": [ + { + "properties": { + "queries": { + "items": { + "type": "string" + }, + "type": [ + "array", + "null" + ] + }, + "query": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "search" + ], + "title": "SearchResponsesApiWebSearchActionType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "SearchResponsesApiWebSearchAction", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "open_page" + ], + "title": "OpenPageResponsesApiWebSearchActionType", + "type": "string" + }, + "url": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "type" + ], + "title": "OpenPageResponsesApiWebSearchAction", + "type": "object" + }, + { + "properties": { + "pattern": { + "type": [ + "string", + "null" + ] + }, + "type": { + "enum": [ + "find_in_page" + ], + "title": "FindInPageResponsesApiWebSearchActionType", + "type": "string" + }, + "url": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "type" + ], + "title": "FindInPageResponsesApiWebSearchAction", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "other" + ], + "title": "OtherResponsesApiWebSearchActionType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "OtherResponsesApiWebSearchAction", + "type": "object" + } + ] + }, + "SandboxMode": { + "enum": [ + "read-only", + "workspace-write", + "danger-full-access" + ], + "type": "string" + }, + "ServiceTier": { + "enum": [ + "fast", + "flex" + ], + "type": "string" + } + }, "description": "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.", - "type": "object", - "required": [ - "threadId" - ], "properties": { "approvalPolicy": { "anyOf": [ @@ -18,7 +1274,6 @@ ] }, "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this thread and subsequent turns.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -26,7 +1281,8 @@ { "type": "null" } - ] + ], + "description": "Override where approval requests are routed for review on this thread and subsequent turns." }, "baseInstructions": { "type": [ @@ -35,11 +1291,11 @@ ] }, "config": { + "additionalProperties": true, "type": [ "object", "null" - ], - "additionalProperties": true + ] }, "cwd": { "type": [ @@ -53,9 +1309,6 @@ "null" ] }, - "threadId": { - "type": "string" - }, "model": { "description": "Configuration overrides for the resumed thread, if any.", "type": [ @@ -69,21 +1322,31 @@ "null" ] }, - "sandbox": { + "permissionProfile": { "anyOf": [ { - "$ref": "#/definitions/SandboxMode" + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Full permissions override for the resumed thread. Cannot be combined with `sandbox`." + }, + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/Personality" }, { "type": "null" } ] }, - "permissionProfile": { - "description": "Full permissions override for the resumed thread. Cannot be combined with `sandbox`.", + "sandbox": { "anyOf": [ { - "$ref": "#/definitions/PermissionProfile" + "$ref": "#/definitions/SandboxMode" }, { "type": "null" @@ -107,1276 +1370,13 @@ } ] }, - "personality": { - "anyOf": [ - { - "$ref": "#/definitions/Personality" - }, - { - "type": "null" - } - ] + "threadId": { + "type": "string" } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - }, - "ApprovalsReviewer": { - "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", - "type": "string", - "enum": [ - "user", - "auto_review", - "guardian_subagent" - ] - }, - "AskForApproval": { - "oneOf": [ - { - "type": "string", - "enum": [ - "untrusted", - "on-failure", - "on-request", - "never" - ] - }, - { - "type": "object", - "required": [ - "granular" - ], - "properties": { - "granular": { - "type": "object", - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "properties": { - "mcp_elicitations": { - "type": "boolean" - }, - "request_permissions": { - "default": false, - "type": "boolean" - }, - "rules": { - "type": "boolean" - }, - "sandbox_approval": { - "type": "boolean" - } - } - } - }, - "additionalProperties": false, - "title": "GranularAskForApproval" - } - ] - }, - "ContentItem": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "input_text" - ], - "title": "InputTextContentItemType" - } - }, - "title": "InputTextContentItem" - }, - { - "type": "object", - "required": [ - "image_url", - "type" - ], - "properties": { - "detail": { - "anyOf": [ - { - "$ref": "#/definitions/ImageDetail" - }, - { - "type": "null" - } - ] - }, - "image_url": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "input_image" - ], - "title": "InputImageContentItemType" - } - }, - "title": "InputImageContentItem" - }, - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "output_text" - ], - "title": "OutputTextContentItemType" - } - }, - "title": "OutputTextContentItem" - } - ] - }, - "FileSystemAccessMode": { - "type": "string", - "enum": [ - "read", - "write", - "none" - ] - }, - "FileSystemPath": { - "oneOf": [ - { - "type": "object", - "required": [ - "path", - "type" - ], - "properties": { - "path": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": { - "type": "string", - "enum": [ - "path" - ], - "title": "PathFileSystemPathType" - } - }, - "title": "PathFileSystemPath" - }, - { - "type": "object", - "required": [ - "pattern", - "type" - ], - "properties": { - "pattern": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "glob_pattern" - ], - "title": "GlobPatternFileSystemPathType" - } - }, - "title": "GlobPatternFileSystemPath" - }, - { - "type": "object", - "required": [ - "type", - "value" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "special" - ], - "title": "SpecialFileSystemPathType" - }, - "value": { - "$ref": "#/definitions/FileSystemSpecialPath" - } - }, - "title": "SpecialFileSystemPath" - } - ] - }, - "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], - "properties": { - "access": { - "$ref": "#/definitions/FileSystemAccessMode" - }, - "path": { - "$ref": "#/definitions/FileSystemPath" - } - } - }, - "FileSystemSpecialPath": { - "oneOf": [ - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "root" - ] - } - }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "minimal" - ] - } - }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "current_working_directory" - ] - } - }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "project_roots" - ] - }, - "subpath": { - "type": [ - "string", - "null" - ] - } - }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "tmpdir" - ] - } - }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind", - "path" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "unknown" - ] - }, - "path": { - "type": "string" - }, - "subpath": { - "type": [ - "string", - "null" - ] - } - } - } - ] - }, - "FunctionCallOutputBody": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "array", - "items": { - "$ref": "#/definitions/FunctionCallOutputContentItem" - } - } - ] - }, - "FunctionCallOutputContentItem": { - "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.", - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "input_text" - ], - "title": "InputTextFunctionCallOutputContentItemType" - } - }, - "title": "InputTextFunctionCallOutputContentItem" - }, - { - "type": "object", - "required": [ - "image_url", - "type" - ], - "properties": { - "detail": { - "anyOf": [ - { - "$ref": "#/definitions/ImageDetail" - }, - { - "type": "null" - } - ] - }, - "image_url": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "input_image" - ], - "title": "InputImageFunctionCallOutputContentItemType" - } - }, - "title": "InputImageFunctionCallOutputContentItem" - } - ] - }, - "GhostCommit": { - "description": "Details of a ghost commit created from a repository state.", - "type": "object", - "required": [ - "id", - "preexisting_untracked_dirs", - "preexisting_untracked_files" - ], - "properties": { - "id": { - "type": "string" - }, - "parent": { - "type": [ - "string", - "null" - ] - }, - "preexisting_untracked_dirs": { - "type": "array", - "items": { - "type": "string" - } - }, - "preexisting_untracked_files": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ImageDetail": { - "type": "string", - "enum": [ - "auto", - "low", - "high", - "original" - ] - }, - "LocalShellAction": { - "oneOf": [ - { - "type": "object", - "required": [ - "command", - "type" - ], - "properties": { - "command": { - "type": "array", - "items": { - "type": "string" - } - }, - "env": { - "type": [ - "object", - "null" - ], - "additionalProperties": { - "type": "string" - } - }, - "timeout_ms": { - "type": [ - "integer", - "null" - ], - "format": "uint64", - "minimum": 0.0 - }, - "type": { - "type": "string", - "enum": [ - "exec" - ], - "title": "ExecLocalShellActionType" - }, - "user": { - "type": [ - "string", - "null" - ] - }, - "working_directory": { - "type": [ - "string", - "null" - ] - } - }, - "title": "ExecLocalShellAction" - } - ] - }, - "LocalShellStatus": { - "type": "string", - "enum": [ - "completed", - "in_progress", - "incomplete" - ] - }, - "MessagePhase": { - "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", - "oneOf": [ - { - "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", - "enum": [ - "commentary" - ] - }, - { - "description": "The assistant's terminal answer text for the current turn.", - "type": "string", - "enum": [ - "final_answer" - ] - } - ] - }, - "PermissionProfile": { - "type": "object", - "properties": { - "fileSystem": { - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfileFileSystemPermissions" - }, - { - "type": "null" - } - ] - }, - "network": { - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfileNetworkPermissions" - }, - { - "type": "null" - } - ] - } - } - }, - "PermissionProfileFileSystemPermissions": { - "type": "object", - "required": [ - "entries" - ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - } - }, - "globScanMaxDepth": { - "type": [ - "integer", - "null" - ], - "format": "uint", - "minimum": 1.0 - } - } - }, - "PermissionProfileNetworkPermissions": { - "type": "object", - "properties": { - "enabled": { - "type": [ - "boolean", - "null" - ] - } - } - }, - "Personality": { - "type": "string", - "enum": [ - "none", - "friendly", - "pragmatic" - ] - }, - "ReasoningItemContent": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "reasoning_text" - ], - "title": "ReasoningTextReasoningItemContentType" - } - }, - "title": "ReasoningTextReasoningItemContent" - }, - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "text" - ], - "title": "TextReasoningItemContentType" - } - }, - "title": "TextReasoningItemContent" - } - ] - }, - "ReasoningItemReasoningSummary": { - "oneOf": [ - { - "type": "object", - "required": [ - "text", - "type" - ], - "properties": { - "text": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "summary_text" - ], - "title": "SummaryTextReasoningItemReasoningSummaryType" - } - }, - "title": "SummaryTextReasoningItemReasoningSummary" - } - ] - }, - "ResponseItem": { - "oneOf": [ - { - "type": "object", - "required": [ - "content", - "role", - "type" - ], - "properties": { - "content": { - "type": "array", - "items": { - "$ref": "#/definitions/ContentItem" - } - }, - "end_turn": { - "type": [ - "boolean", - "null" - ] - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "phase": { - "anyOf": [ - { - "$ref": "#/definitions/MessagePhase" - }, - { - "type": "null" - } - ] - }, - "role": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "message" - ], - "title": "MessageResponseItemType" - } - }, - "title": "MessageResponseItem" - }, - { - "type": "object", - "required": [ - "summary", - "type" - ], - "properties": { - "content": { - "default": null, - "type": [ - "array", - "null" - ], - "items": { - "$ref": "#/definitions/ReasoningItemContent" - } - }, - "encrypted_content": { - "type": [ - "string", - "null" - ] - }, - "summary": { - "type": "array", - "items": { - "$ref": "#/definitions/ReasoningItemReasoningSummary" - } - }, - "type": { - "type": "string", - "enum": [ - "reasoning" - ], - "title": "ReasoningResponseItemType" - } - }, - "title": "ReasoningResponseItem" - }, - { - "type": "object", - "required": [ - "action", - "status", - "type" - ], - "properties": { - "action": { - "$ref": "#/definitions/LocalShellAction" - }, - "call_id": { - "description": "Set when using the Responses API.", - "type": [ - "string", - "null" - ] - }, - "id": { - "description": "Legacy id field retained for compatibility with older payloads.", - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "status": { - "$ref": "#/definitions/LocalShellStatus" - }, - "type": { - "type": "string", - "enum": [ - "local_shell_call" - ], - "title": "LocalShellCallResponseItemType" - } - }, - "title": "LocalShellCallResponseItem" - }, - { - "type": "object", - "required": [ - "arguments", - "call_id", - "name", - "type" - ], - "properties": { - "arguments": { - "type": "string" - }, - "call_id": { - "type": "string" - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "name": { - "type": "string" - }, - "namespace": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "function_call" - ], - "title": "FunctionCallResponseItemType" - } - }, - "title": "FunctionCallResponseItem" - }, - { - "type": "object", - "required": [ - "arguments", - "execution", - "type" - ], - "properties": { - "arguments": true, - "call_id": { - "type": [ - "string", - "null" - ] - }, - "execution": { - "type": "string" - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "status": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "tool_search_call" - ], - "title": "ToolSearchCallResponseItemType" - } - }, - "title": "ToolSearchCallResponseItem" - }, - { - "type": "object", - "required": [ - "call_id", - "output", - "type" - ], - "properties": { - "call_id": { - "type": "string" - }, - "output": { - "$ref": "#/definitions/FunctionCallOutputBody" - }, - "type": { - "type": "string", - "enum": [ - "function_call_output" - ], - "title": "FunctionCallOutputResponseItemType" - } - }, - "title": "FunctionCallOutputResponseItem" - }, - { - "type": "object", - "required": [ - "call_id", - "input", - "name", - "type" - ], - "properties": { - "call_id": { - "type": "string" - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "input": { - "type": "string" - }, - "name": { - "type": "string" - }, - "status": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "custom_tool_call" - ], - "title": "CustomToolCallResponseItemType" - } - }, - "title": "CustomToolCallResponseItem" - }, - { - "type": "object", - "required": [ - "call_id", - "output", - "type" - ], - "properties": { - "call_id": { - "type": "string" - }, - "name": { - "type": [ - "string", - "null" - ] - }, - "output": { - "$ref": "#/definitions/FunctionCallOutputBody" - }, - "type": { - "type": "string", - "enum": [ - "custom_tool_call_output" - ], - "title": "CustomToolCallOutputResponseItemType" - } - }, - "title": "CustomToolCallOutputResponseItem" - }, - { - "type": "object", - "required": [ - "execution", - "status", - "tools", - "type" - ], - "properties": { - "call_id": { - "type": [ - "string", - "null" - ] - }, - "execution": { - "type": "string" - }, - "status": { - "type": "string" - }, - "tools": { - "type": "array", - "items": true - }, - "type": { - "type": "string", - "enum": [ - "tool_search_output" - ], - "title": "ToolSearchOutputResponseItemType" - } - }, - "title": "ToolSearchOutputResponseItem" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "action": { - "anyOf": [ - { - "$ref": "#/definitions/ResponsesApiWebSearchAction" - }, - { - "type": "null" - } - ] - }, - "id": { - "writeOnly": true, - "type": [ - "string", - "null" - ] - }, - "status": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "web_search_call" - ], - "title": "WebSearchCallResponseItemType" - } - }, - "title": "WebSearchCallResponseItem" - }, - { - "type": "object", - "required": [ - "id", - "result", - "status", - "type" - ], - "properties": { - "id": { - "type": "string" - }, - "result": { - "type": "string" - }, - "revised_prompt": { - "type": [ - "string", - "null" - ] - }, - "status": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "image_generation_call" - ], - "title": "ImageGenerationCallResponseItemType" - } - }, - "title": "ImageGenerationCallResponseItem" - }, - { - "type": "object", - "required": [ - "ghost_commit", - "type" - ], - "properties": { - "ghost_commit": { - "$ref": "#/definitions/GhostCommit" - }, - "type": { - "type": "string", - "enum": [ - "ghost_snapshot" - ], - "title": "GhostSnapshotResponseItemType" - } - }, - "title": "GhostSnapshotResponseItem" - }, - { - "type": "object", - "required": [ - "encrypted_content", - "type" - ], - "properties": { - "encrypted_content": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "compaction" - ], - "title": "CompactionResponseItemType" - } - }, - "title": "CompactionResponseItem" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "other" - ], - "title": "OtherResponseItemType" - } - }, - "title": "OtherResponseItem" - } - ] - }, - "ResponsesApiWebSearchAction": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "queries": { - "type": [ - "array", - "null" - ], - "items": { - "type": "string" - } - }, - "query": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "search" - ], - "title": "SearchResponsesApiWebSearchActionType" - } - }, - "title": "SearchResponsesApiWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "open_page" - ], - "title": "OpenPageResponsesApiWebSearchActionType" - }, - "url": { - "type": [ - "string", - "null" - ] - } - }, - "title": "OpenPageResponsesApiWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "pattern": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string", - "enum": [ - "find_in_page" - ], - "title": "FindInPageResponsesApiWebSearchActionType" - }, - "url": { - "type": [ - "string", - "null" - ] - } - }, - "title": "FindInPageResponsesApiWebSearchAction" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "other" - ], - "title": "OtherResponsesApiWebSearchActionType" - } - }, - "title": "OtherResponsesApiWebSearchAction" - } - ] - }, - "SandboxMode": { - "type": "string", - "enum": [ - "read-only", - "workspace-write", - "danger-full-access" - ] - }, - "ServiceTier": { - "type": "string", - "enum": [ - "fast", - "flex" - ] - } - } + "required": [ + "threadId" + ], + "title": "ThreadResumeParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json index 77821781..a476f137 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json @@ -1,89 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadResumeResponse", - "type": "object", - "required": [ - "approvalPolicy", - "approvalsReviewer", - "cwd", - "model", - "modelProvider", - "sandbox", - "thread" - ], - "properties": { - "approvalPolicy": { - "$ref": "#/definitions/AskForApproval" - }, - "approvalsReviewer": { - "description": "Reviewer currently used for approval requests on this thread.", - "allOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - } - ] - }, - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "instructionSources": { - "description": "Instruction source files currently loaded for this thread.", - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "model": { - "type": "string" - }, - "modelProvider": { - "type": "string" - }, - "permissionProfile": { - "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`.", - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "reasoningEffort": { - "anyOf": [ - { - "$ref": "#/definitions/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "sandbox": { - "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view.", - "allOf": [ - { - "$ref": "#/definitions/SandboxPolicy" - } - ] - }, - "serviceTier": { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - "thread": { - "$ref": "#/definitions/Thread" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", @@ -94,37 +10,28 @@ }, "ApprovalsReviewer": { "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", - "type": "string", "enum": [ "user", "auto_review", "guardian_subagent" - ] + ], + "type": "string" }, "AskForApproval": { "oneOf": [ { - "type": "string", "enum": [ "untrusted", "on-failure", "on-request", "never" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "granular" - ], + "additionalProperties": false, "properties": { "granular": { - "type": "object", - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -139,38 +46,46 @@ "sandbox_approval": { "type": "boolean" } - } + }, + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "GranularAskForApproval" + "required": [ + "granular" + ], + "title": "GranularAskForApproval", + "type": "object" } ] }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -181,132 +96,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -317,10 +229,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -329,36 +244,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -370,21 +279,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -396,21 +307,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -428,119 +339,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], "properties": { "accepted_at": { "type": "string" @@ -584,42 +489,41 @@ "surface": { "type": "string" } - } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" }, "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], "properties": { "acceptance_sketch": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "blockers": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": "string" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "duplicate_of": { "type": [ @@ -628,10 +532,10 @@ ] }, "evidence_refs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "horizon": { "type": "string" @@ -643,10 +547,10 @@ "type": "string" }, "lane_hints": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -655,10 +559,10 @@ "type": "string" }, "source_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } + }, + "type": "array" }, "status": { "type": "string" @@ -675,14 +579,21 @@ "null" ] } - } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], "properties": { "diff_pressure": { "type": "string" @@ -697,12 +608,12 @@ "type": "string" }, "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "warning": { "type": [ @@ -710,21 +621,22 @@ "null" ] } - } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" }, "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], "properties": { "end_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "note": { "type": [ @@ -736,12 +648,12 @@ "type": "string" }, "start_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "symbol": { "type": [ @@ -749,22 +661,19 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -778,57 +687,59 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyGraph": { - "type": "object", "properties": { "edges": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphEdge" - } + }, + "type": "array" }, "nodes": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphNode" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], "properties": { "checkpoint_id": { "type": "string" }, "frontier_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "graph_revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -836,21 +747,20 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" }, "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": [ @@ -879,58 +789,59 @@ "target_id": { "type": "string" } - } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" }, "EpiphanyGraphFrontier": { - "type": "object", "properties": { "active_edge_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "active_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], "properties": { "architecture_node_id": { "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "dataflow_node_id": { "type": "string" @@ -941,21 +852,20 @@ "null" ] } - } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" }, "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -984,10 +894,15 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" }, "EpiphanyGraphs": { - "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -996,20 +911,15 @@ "$ref": "#/definitions/EpiphanyGraph" }, "links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphLink" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], "properties": { "description": { "type": "string" @@ -1026,16 +936,15 @@ "status": { "type": "string" } - } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" }, "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], "properties": { "captured_at_turn_id": { "type": [ @@ -1047,19 +956,19 @@ "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "disposition": { "$ref": "#/definitions/EpiphanyInvestigationDisposition" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "focus": { "type": "string" @@ -1074,10 +983,10 @@ ] }, "open_questions": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1085,23 +994,23 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" }, "EpiphanyInvestigationDisposition": { - "type": "string", "enum": [ "resume_ready", "regather_required" - ] + ], + "type": "string" }, "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], "properties": { "authority_scope": { "type": [ @@ -1122,16 +1031,16 @@ "$ref": "#/definitions/EpiphanyJobKind" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "owner_role": { "type": "string" @@ -1139,29 +1048,32 @@ "scope": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" }, "EpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "EpiphanyModeKind": { - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], "properties": { "kind": { "anyOf": [ @@ -1176,36 +1088,31 @@ "name": { "type": "string" } - } + }, + "required": [ + "name" + ], + "type": "object" }, "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], "properties": { "acceptance_criteria": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "evidence_required": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1214,25 +1121,25 @@ "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" }, "review_gates": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "risks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "scope": { "$ref": "#/definitions/EpiphanyObjectiveDraftScope" }, "source_item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "status": { "type": "string" @@ -1243,10 +1150,18 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyObjectiveDraftLanePlan": { - "type": "object", "properties": { "body": { "type": [ @@ -1284,45 +1199,39 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyObjectiveDraftScope": { - "type": "object", "properties": { "excludes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1336,17 +1245,16 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], "properties": { "body": { "type": [ @@ -1379,10 +1287,10 @@ "type": "string" }, "tags": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": "string" @@ -1393,20 +1301,23 @@ "null" ] } - } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" }, "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], "properties": { "blocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": [ @@ -1436,10 +1347,10 @@ ] }, "unblocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "urgency": { "type": [ @@ -1450,19 +1361,20 @@ "value": { "type": "string" } - } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" }, "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], "properties": { "assignees": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "author": { "type": [ @@ -1483,11 +1395,11 @@ ] }, "database_id": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "external_id": { "type": [ @@ -1508,21 +1420,21 @@ ] }, "issue_number": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "kind": { "type": "string" }, "labels": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "milestone": { "type": [ @@ -1572,34 +1484,37 @@ "null" ] } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "EpiphanyPlanningState": { - "type": "object", "properties": { "backlog_items": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyBacklogItem" - } + }, + "type": "array" }, "captures": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningCapture" - } + }, + "type": "array" }, "objective_drafts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObjectiveDraft" - } + }, + "type": "array" }, "roadmap_streams": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRoadmapStream" - } + }, + "type": "array" }, "workspace_root": { "type": [ @@ -1607,33 +1522,29 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], "properties": { "exact_available": { "type": "boolean" }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "path_prefix": { "type": "string" @@ -1645,26 +1556,27 @@ "type": "string" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" } - } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" }, "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], "properties": { "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "index_revision": { "type": [ @@ -1673,82 +1585,79 @@ ] }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "last_indexed_at_unix_seconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "semantic_available": { "type": "boolean" }, "shards": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRetrievalShardSummary" - } + }, + "type": "array" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" }, "workspace_root": { "type": "string" } - } + }, + "required": [ + "workspace_root" + ], + "type": "object" }, "EpiphanyRetrievalStatus": { - "type": "string", "enum": [ "unavailable", "ready", "stale", "indexing" - ] + ], + "type": "string" }, "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], "properties": { "blocked_by": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "near_term_focus": { "type": [ @@ -1771,18 +1680,16 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" }, "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], "properties": { "authority_scope": { "type": "string" @@ -1794,16 +1701,16 @@ "type": "string" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "role_id": { "type": "string" @@ -1820,10 +1727,18 @@ "surface": { "type": "string" } - } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" }, "EpiphanyScratchPad": { - "type": "object", "properties": { "hypothesis": { "type": [ @@ -1838,10 +1753,10 @@ ] }, "notes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1849,15 +1764,10 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], "properties": { "id": { "type": "string" @@ -1874,19 +1784,21 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" }, "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], "properties": { "acceptance_receipts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } + }, + "type": "array" }, "active_subgoal_id": { "type": [ @@ -1928,10 +1840,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - } + }, + "type": "array" }, "investigation_checkpoint": { "anyOf": [ @@ -1944,10 +1856,10 @@ ] }, "job_bindings": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - } + }, + "type": "array" }, "last_updated_turn_id": { "type": [ @@ -1972,19 +1884,19 @@ ] }, "observations": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - } + }, + "type": "array" }, "planning": { "$ref": "#/definitions/EpiphanyPlanningState" }, "recent_evidence": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - } + }, + "type": "array" }, "retrieval": { "anyOf": [ @@ -1997,15 +1909,15 @@ ] }, "revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "runtime_links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - } + }, + "type": "array" }, "scratch": { "anyOf": [ @@ -2018,91 +1930,90 @@ ] }, "subgoals": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - } + }, + "type": "array" } - } + }, + "required": [ + "revision" + ], + "type": "object" }, "FileSystemAccessMode": { - "type": "string", "enum": [ "read", "write", "none" - ] + ], + "type": "string" }, "FileSystemPath": { "oneOf": [ { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "path" ], - "title": "PathFileSystemPathType" + "title": "PathFileSystemPathType", + "type": "string" } }, - "title": "PathFileSystemPath" - }, - { - "type": "object", "required": [ - "pattern", + "path", "type" ], + "title": "PathFileSystemPath", + "type": "object" + }, + { "properties": { "pattern": { "type": "string" }, "type": { - "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType" + "title": "GlobPatternFileSystemPathType", + "type": "string" } }, - "title": "GlobPatternFileSystemPath" + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType" + "title": "SpecialFileSystemPathType", + "type": "string" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "title": "SpecialFileSystemPath" + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" } ] }, "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -2110,66 +2021,67 @@ "path": { "$ref": "#/definitions/FileSystemPath" } - } + }, + "required": [ + "access", + "path" + ], + "type": "object" }, "FileSystemSpecialPath": { "oneOf": [ { - "type": "object", - "required": [ - "kind" - ], "properties": { "kind": { - "type": "string", "enum": [ "root" - ] + ], + "type": "string" } }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "minimal" - ] + ], + "type": "string" } }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "current_working_directory" - ] + ], + "type": "string" } }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "project_roots" - ] + ], + "type": "string" }, "subpath": { "type": [ @@ -2178,50 +2090,49 @@ ] } }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "tmpdir" - ] + ], + "type": "string" } }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" }, { - "type": "object", - "required": [ - "kind", - "path" - ], "properties": { "kind": { - "type": "string", "enum": [ "unknown" - ] + ], + "type": "string" }, "path": { "type": "string" @@ -2232,17 +2143,16 @@ "null" ] } - } + }, + "required": [ + "kind", + "path" + ], + "type": "object" } ] }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -2253,10 +2163,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "GitInfo": { - "type": "object", "properties": { "branch": { "type": [ @@ -2276,14 +2191,10 @@ "null" ] } - } + }, + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -2291,80 +2202,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -2372,89 +2281,92 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NetworkAccess": { - "type": "string", "enum": [ "restricted", "enabled" - ] + ], + "type": "string" }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -2463,19 +2375,22 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "PermissionProfile": { - "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -2497,32 +2412,32 @@ } ] } - } + }, + "type": "object" }, "PermissionProfileFileSystemPermissions": { - "type": "object", - "required": [ - "entries" - ], "properties": { "entries": { - "type": "array", "items": { "$ref": "#/definitions/FileSystemSandboxEntry" - } + }, + "type": "array" }, "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 1.0 + ] } - } + }, + "required": [ + "entries" + ], + "type": "object" }, "PermissionProfileNetworkPermissions": { - "type": "object", "properties": { "enabled": { "type": [ @@ -2530,15 +2445,12 @@ "null" ] } - } + }, + "type": "object" }, "ReadOnlyAccess": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "includePlatformDefaults": { "default": true, @@ -2546,42 +2458,45 @@ }, "readableRoots": { "default": [], - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "restricted" ], - "title": "RestrictedReadOnlyAccessType" + "title": "RestrictedReadOnlyAccessType", + "type": "string" } }, - "title": "RestrictedReadOnlyAccess" - }, - { - "type": "object", "required": [ "type" ], + "title": "RestrictedReadOnlyAccess", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "fullAccess" ], - "title": "FullAccessReadOnlyAccessType" + "title": "FullAccessReadOnlyAccessType", + "type": "string" } }, - "title": "FullAccessReadOnlyAccess" + "required": [ + "type" + ], + "title": "FullAccessReadOnlyAccess", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -2589,85 +2504,82 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "SandboxPolicy": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "dangerFullAccess" ], - "title": "DangerFullAccessSandboxPolicyType" + "title": "DangerFullAccessSandboxPolicyType", + "type": "string" } }, - "title": "DangerFullAccessSandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "DangerFullAccessSandboxPolicy", + "type": "object" + }, + { "properties": { "access": { - "default": { - "type": "fullAccess" - }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ] + ], + "default": { + "type": "fullAccess" + } }, "networkAccess": { "default": false, "type": "boolean" }, "type": { - "type": "string", "enum": [ "readOnly" ], - "title": "ReadOnlySandboxPolicyType" + "title": "ReadOnlySandboxPolicyType", + "type": "string" } }, - "title": "ReadOnlySandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "ReadOnlySandboxPolicy", + "type": "object" + }, + { "properties": { "networkAccess": { - "default": "restricted", "allOf": [ { "$ref": "#/definitions/NetworkAccess" } - ] + ], + "default": "restricted" }, "type": { - "type": "string", "enum": [ "externalSandbox" ], - "title": "ExternalSandboxSandboxPolicyType" + "title": "ExternalSandboxSandboxPolicyType", + "type": "string" } }, - "title": "ExternalSandboxSandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "ExternalSandboxSandboxPolicy", + "type": "object" + }, + { "properties": { "excludeSlashTmp": { "default": false, @@ -2682,103 +2594,99 @@ "type": "boolean" }, "readOnlyAccess": { - "default": { - "type": "fullAccess" - }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ] + ], + "default": { + "type": "fullAccess" + } }, "type": { - "type": "string", "enum": [ "workspaceWrite" ], - "title": "WorkspaceWriteSandboxPolicyType" + "title": "WorkspaceWriteSandboxPolicyType", + "type": "string" }, "writableRoots": { "default": [], - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" } }, - "title": "WorkspaceWriteSandboxPolicy" + "required": [ + "type" + ], + "title": "WorkspaceWriteSandboxPolicy", + "type": "object" } ] }, "ServiceTier": { - "type": "string", "enum": [ "fast", "flex" - ] + ], + "type": "string" }, "SessionSource": { "oneOf": [ { - "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "custom" - ], + "additionalProperties": false, "properties": { "custom": { "type": "string" } }, - "additionalProperties": false, - "title": "CustomSessionSource" + "required": [ + "custom" + ], + "title": "CustomSessionSource", + "type": "object" }, { - "type": "object", - "required": [ - "subAgent" - ], + "additionalProperties": false, "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "additionalProperties": false, - "title": "SubAgentSessionSource" + "required": [ + "subAgent" + ], + "title": "SubAgentSessionSource", + "type": "object" } ] }, "SubAgentSource": { "oneOf": [ { - "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "thread_spawn" - ], + "additionalProperties": false, "properties": { "thread_spawn": { - "type": "object", - "required": [ - "depth", - "parent_thread_id" - ], "properties": { "agent_nickname": { "default": null, @@ -2788,7 +2696,6 @@ ] }, "agent_path": { - "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2796,7 +2703,8 @@ { "type": "null" } - ] + ], + "default": null }, "agent_role": { "default": null, @@ -2806,46 +2714,50 @@ ] }, "depth": { - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - } + }, + "required": [ + "depth", + "parent_thread_id" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ThreadSpawnSubAgentSource" + "required": [ + "thread_spawn" + ], + "title": "ThreadSpawnSubAgentSource", + "type": "object" }, { - "type": "object", - "required": [ - "other" - ], + "additionalProperties": false, "properties": { "other": { "type": "string" } }, - "additionalProperties": false, - "title": "OtherSubAgentSource" + "required": [ + "other" + ], + "title": "OtherSubAgentSource", + "type": "object" } ] }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -2854,23 +2766,13 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "Thread": { - "type": "object", - "required": [ - "cliVersion", - "createdAt", - "cwd", - "ephemeral", - "id", - "modelProvider", - "preview", - "source", - "status", - "turns", - "updatedAt" - ], "properties": { "agentNickname": { "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", @@ -2892,23 +2794,22 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "cwd": { - "description": "Working directory captured for the thread.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Working directory captured for the thread." }, "ephemeral": { "description": "Whether the thread is ephemeral and should not be materialized on disk.", "type": "boolean" }, "epiphanyState": { - "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads.", "anyOf": [ { "$ref": "#/definitions/EpiphanyThreadState" @@ -2916,7 +2817,8 @@ { "type": "null" } - ] + ], + "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads." }, "forkedFromId": { "description": "Source thread id when this thread was created by forking another thread.", @@ -2926,7 +2828,6 @@ ] }, "gitInfo": { - "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2934,7 +2835,8 @@ { "type": "null" } - ] + ], + "description": "Optional Git metadata captured when the thread was created." }, "id": { "type": "string" @@ -2962,41 +2864,55 @@ "type": "string" }, "source": { - "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).", "allOf": [ { "$ref": "#/definitions/SessionSource" } - ] + ], + "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." }, "status": { - "description": "Current runtime status for the thread.", "allOf": [ { "$ref": "#/definitions/ThreadStatus" } - ] + ], + "description": "Current runtime status for the thread." }, "turns": { "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/Turn" - } + }, + "type": "array" }, "updatedAt": { "description": "Unix timestamp (in seconds) when the thread was last updated.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } - } + }, + "required": [ + "cliVersion", + "createdAt", + "cwd", + "ephemeral", + "id", + "modelProvider", + "preview", + "source", + "status", + "turns", + "updatedAt" + ], + "type": "object" }, "ThreadActiveFlag": { - "type": "string", "enum": [ "waitingOnApproval", "waitingOnUserInput" - ] + ], + "type": "string" }, "ThreadId": { "type": "string" @@ -3004,72 +2920,65 @@ "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -3077,10 +2986,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -3088,29 +2997,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -3119,59 +3029,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -3186,34 +3093,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -3226,40 +3133,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -3268,34 +3177,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -3336,42 +3243,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -3395,33 +3303,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -3442,7 +3348,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -3450,52 +3355,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -3514,22 +3424,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3538,23 +3448,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3582,22 +3491,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3606,22 +3516,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3630,138 +3540,137 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "ThreadStatus": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType" + "title": "NotLoadedThreadStatusType", + "type": "string" } }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType" + "title": "IdleThreadStatusType", + "type": "string" } }, - "title": "IdleThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "IdleThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType" + "title": "SystemErrorThreadStatusType", + "type": "string" } }, - "title": "SystemErrorThreadStatus" + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" }, { - "type": "object", + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, "required": [ "activeFlags", "type" ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" + "title": "ActiveThreadStatus", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -3769,36 +3678,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -3820,94 +3732,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -3916,33 +3826,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -3951,27 +3863,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3980,13 +3892,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -3995,11 +3907,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -4008,25 +3920,113 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "approvalPolicy": { + "$ref": "#/definitions/AskForApproval" + }, + "approvalsReviewer": { + "allOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + } + ], + "description": "Reviewer currently used for approval requests on this thread." + }, + "cwd": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "instructionSources": { + "default": [], + "description": "Instruction source files currently loaded for this thread.", + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": "array" + }, + "model": { + "type": "string" + }, + "modelProvider": { + "type": "string" + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "default": null, + "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`." + }, + "reasoningEffort": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningEffort" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "allOf": [ + { + "$ref": "#/definitions/SandboxPolicy" + } + ], + "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view." + }, + "serviceTier": { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "approvalPolicy", + "approvalsReviewer", + "cwd", + "model", + "modelProvider", + "sandbox", + "thread" + ], + "title": "ThreadResumeResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackParams.json index bc91ce46..cb3ba0db 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackParams.json @@ -1,20 +1,20 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRollbackParams", - "type": "object", - "required": [ - "numTurns", - "threadId" - ], "properties": { "numTurns": { "description": "The number of turns to drop from the end of the thread. Must be >= 1.\n\nThis only modifies the thread's history and does not revert local file changes that have been made by the agent. Clients are responsible for reverting these changes.", - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "threadId": { "type": "string" } - } + }, + "required": [ + "numTurns", + "threadId" + ], + "title": "ThreadRollbackParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json index 5497d726..67035c8b 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json @@ -1,20 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadRollbackResponse", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "description": "The updated thread after applying the rollback, with `turns` populated.\n\nThe ThreadItems stored in each Turn are lossy since we explicitly do not persist all agent interactions, such as command executions. This is the same behavior as `thread/resume`.", - "allOf": [ - { - "$ref": "#/definitions/Thread" - } - ] - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", @@ -24,29 +9,28 @@ "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -57,132 +41,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -193,10 +174,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -205,36 +189,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -246,21 +224,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -272,21 +252,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -304,119 +284,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], "properties": { "accepted_at": { "type": "string" @@ -460,42 +434,41 @@ "surface": { "type": "string" } - } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" }, "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], "properties": { "acceptance_sketch": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "blockers": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": "string" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "duplicate_of": { "type": [ @@ -504,10 +477,10 @@ ] }, "evidence_refs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "horizon": { "type": "string" @@ -519,10 +492,10 @@ "type": "string" }, "lane_hints": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -531,10 +504,10 @@ "type": "string" }, "source_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } + }, + "type": "array" }, "status": { "type": "string" @@ -551,14 +524,21 @@ "null" ] } - } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], "properties": { "diff_pressure": { "type": "string" @@ -573,12 +553,12 @@ "type": "string" }, "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "warning": { "type": [ @@ -586,21 +566,22 @@ "null" ] } - } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" }, "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], "properties": { "end_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "note": { "type": [ @@ -612,12 +593,12 @@ "type": "string" }, "start_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "symbol": { "type": [ @@ -625,22 +606,19 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -654,57 +632,59 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyGraph": { - "type": "object", "properties": { "edges": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphEdge" - } + }, + "type": "array" }, "nodes": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphNode" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], "properties": { "checkpoint_id": { "type": "string" }, "frontier_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "graph_revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -712,21 +692,20 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" }, "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": [ @@ -755,58 +734,59 @@ "target_id": { "type": "string" } - } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" }, "EpiphanyGraphFrontier": { - "type": "object", "properties": { "active_edge_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "active_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], "properties": { "architecture_node_id": { "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "dataflow_node_id": { "type": "string" @@ -817,21 +797,20 @@ "null" ] } - } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" }, "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -860,10 +839,15 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" }, "EpiphanyGraphs": { - "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -872,20 +856,15 @@ "$ref": "#/definitions/EpiphanyGraph" }, "links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphLink" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], "properties": { "description": { "type": "string" @@ -902,16 +881,15 @@ "status": { "type": "string" } - } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" }, "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], "properties": { "captured_at_turn_id": { "type": [ @@ -923,19 +901,19 @@ "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "disposition": { "$ref": "#/definitions/EpiphanyInvestigationDisposition" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "focus": { "type": "string" @@ -950,10 +928,10 @@ ] }, "open_questions": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -961,23 +939,23 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" }, "EpiphanyInvestigationDisposition": { - "type": "string", "enum": [ "resume_ready", "regather_required" - ] + ], + "type": "string" }, "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], "properties": { "authority_scope": { "type": [ @@ -998,16 +976,16 @@ "$ref": "#/definitions/EpiphanyJobKind" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "owner_role": { "type": "string" @@ -1015,29 +993,32 @@ "scope": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" }, "EpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "EpiphanyModeKind": { - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], "properties": { "kind": { "anyOf": [ @@ -1052,36 +1033,31 @@ "name": { "type": "string" } - } + }, + "required": [ + "name" + ], + "type": "object" }, "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], "properties": { "acceptance_criteria": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "evidence_required": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1090,25 +1066,25 @@ "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" }, "review_gates": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "risks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "scope": { "$ref": "#/definitions/EpiphanyObjectiveDraftScope" }, "source_item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "status": { "type": "string" @@ -1119,10 +1095,18 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyObjectiveDraftLanePlan": { - "type": "object", "properties": { "body": { "type": [ @@ -1160,45 +1144,39 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyObjectiveDraftScope": { - "type": "object", "properties": { "excludes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1212,17 +1190,16 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], "properties": { "body": { "type": [ @@ -1255,10 +1232,10 @@ "type": "string" }, "tags": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": "string" @@ -1269,20 +1246,23 @@ "null" ] } - } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" }, "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], "properties": { "blocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": [ @@ -1312,10 +1292,10 @@ ] }, "unblocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "urgency": { "type": [ @@ -1326,19 +1306,20 @@ "value": { "type": "string" } - } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" }, "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], "properties": { "assignees": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "author": { "type": [ @@ -1359,11 +1340,11 @@ ] }, "database_id": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "external_id": { "type": [ @@ -1384,21 +1365,21 @@ ] }, "issue_number": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "kind": { "type": "string" }, "labels": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "milestone": { "type": [ @@ -1448,34 +1429,37 @@ "null" ] } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "EpiphanyPlanningState": { - "type": "object", "properties": { "backlog_items": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyBacklogItem" - } + }, + "type": "array" }, "captures": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningCapture" - } + }, + "type": "array" }, "objective_drafts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObjectiveDraft" - } + }, + "type": "array" }, "roadmap_streams": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRoadmapStream" - } + }, + "type": "array" }, "workspace_root": { "type": [ @@ -1483,33 +1467,29 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], "properties": { "exact_available": { "type": "boolean" }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "path_prefix": { "type": "string" @@ -1521,26 +1501,27 @@ "type": "string" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" } - } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" }, "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], "properties": { "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "index_revision": { "type": [ @@ -1549,82 +1530,79 @@ ] }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "last_indexed_at_unix_seconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "semantic_available": { "type": "boolean" }, "shards": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRetrievalShardSummary" - } + }, + "type": "array" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" }, "workspace_root": { "type": "string" } - } + }, + "required": [ + "workspace_root" + ], + "type": "object" }, "EpiphanyRetrievalStatus": { - "type": "string", "enum": [ "unavailable", "ready", "stale", "indexing" - ] + ], + "type": "string" }, "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], "properties": { "blocked_by": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "near_term_focus": { "type": [ @@ -1647,18 +1625,16 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" }, "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], "properties": { "authority_scope": { "type": "string" @@ -1670,16 +1646,16 @@ "type": "string" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "role_id": { "type": "string" @@ -1696,10 +1672,18 @@ "surface": { "type": "string" } - } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" }, "EpiphanyScratchPad": { - "type": "object", "properties": { "hypothesis": { "type": [ @@ -1714,10 +1698,10 @@ ] }, "notes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1725,15 +1709,10 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], "properties": { "id": { "type": "string" @@ -1750,19 +1729,21 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" }, "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], "properties": { "acceptance_receipts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } + }, + "type": "array" }, "active_subgoal_id": { "type": [ @@ -1804,10 +1785,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - } + }, + "type": "array" }, "investigation_checkpoint": { "anyOf": [ @@ -1820,10 +1801,10 @@ ] }, "job_bindings": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - } + }, + "type": "array" }, "last_updated_turn_id": { "type": [ @@ -1848,19 +1829,19 @@ ] }, "observations": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - } + }, + "type": "array" }, "planning": { "$ref": "#/definitions/EpiphanyPlanningState" }, "recent_evidence": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - } + }, + "type": "array" }, "retrieval": { "anyOf": [ @@ -1873,15 +1854,15 @@ ] }, "revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "runtime_links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - } + }, + "type": "array" }, "scratch": { "anyOf": [ @@ -1894,20 +1875,18 @@ ] }, "subgoals": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - } + }, + "type": "array" } - } + }, + "required": [ + "revision" + ], + "type": "object" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -1918,10 +1897,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "GitInfo": { - "type": "object", "properties": { "branch": { "type": [ @@ -1941,14 +1925,10 @@ "null" ] } - } + }, + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -1956,80 +1936,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -2037,82 +2015,85 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -2121,20 +2102,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -2142,70 +2126,63 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "SessionSource": { "oneOf": [ { - "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "custom" - ], + "additionalProperties": false, "properties": { "custom": { "type": "string" } }, - "additionalProperties": false, - "title": "CustomSessionSource" + "required": [ + "custom" + ], + "title": "CustomSessionSource", + "type": "object" }, { - "type": "object", - "required": [ - "subAgent" - ], + "additionalProperties": false, "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "additionalProperties": false, - "title": "SubAgentSessionSource" + "required": [ + "subAgent" + ], + "title": "SubAgentSessionSource", + "type": "object" } ] }, "SubAgentSource": { "oneOf": [ { - "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "thread_spawn" - ], + "additionalProperties": false, "properties": { "thread_spawn": { - "type": "object", - "required": [ - "depth", - "parent_thread_id" - ], "properties": { "agent_nickname": { "default": null, @@ -2215,7 +2192,6 @@ ] }, "agent_path": { - "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2223,7 +2199,8 @@ { "type": "null" } - ] + ], + "default": null }, "agent_role": { "default": null, @@ -2233,46 +2210,50 @@ ] }, "depth": { - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - } + }, + "required": [ + "depth", + "parent_thread_id" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ThreadSpawnSubAgentSource" + "required": [ + "thread_spawn" + ], + "title": "ThreadSpawnSubAgentSource", + "type": "object" }, { - "type": "object", - "required": [ - "other" - ], + "additionalProperties": false, "properties": { "other": { "type": "string" } }, - "additionalProperties": false, - "title": "OtherSubAgentSource" + "required": [ + "other" + ], + "title": "OtherSubAgentSource", + "type": "object" } ] }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -2281,23 +2262,13 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "Thread": { - "type": "object", - "required": [ - "cliVersion", - "createdAt", - "cwd", - "ephemeral", - "id", - "modelProvider", - "preview", - "source", - "status", - "turns", - "updatedAt" - ], "properties": { "agentNickname": { "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", @@ -2319,23 +2290,22 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "cwd": { - "description": "Working directory captured for the thread.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Working directory captured for the thread." }, "ephemeral": { "description": "Whether the thread is ephemeral and should not be materialized on disk.", "type": "boolean" }, "epiphanyState": { - "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads.", "anyOf": [ { "$ref": "#/definitions/EpiphanyThreadState" @@ -2343,7 +2313,8 @@ { "type": "null" } - ] + ], + "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads." }, "forkedFromId": { "description": "Source thread id when this thread was created by forking another thread.", @@ -2353,7 +2324,6 @@ ] }, "gitInfo": { - "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2361,7 +2331,8 @@ { "type": "null" } - ] + ], + "description": "Optional Git metadata captured when the thread was created." }, "id": { "type": "string" @@ -2389,41 +2360,55 @@ "type": "string" }, "source": { - "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).", "allOf": [ { "$ref": "#/definitions/SessionSource" } - ] + ], + "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." }, "status": { - "description": "Current runtime status for the thread.", "allOf": [ { "$ref": "#/definitions/ThreadStatus" } - ] + ], + "description": "Current runtime status for the thread." }, "turns": { "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/Turn" - } + }, + "type": "array" }, "updatedAt": { "description": "Unix timestamp (in seconds) when the thread was last updated.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } - } + }, + "required": [ + "cliVersion", + "createdAt", + "cwd", + "ephemeral", + "id", + "modelProvider", + "preview", + "source", + "status", + "turns", + "updatedAt" + ], + "type": "object" }, "ThreadActiveFlag": { - "type": "string", "enum": [ "waitingOnApproval", "waitingOnUserInput" - ] + ], + "type": "string" }, "ThreadId": { "type": "string" @@ -2431,72 +2416,65 @@ "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -2504,10 +2482,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -2515,29 +2493,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -2546,59 +2525,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -2613,34 +2589,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -2653,40 +2629,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2695,34 +2673,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -2763,42 +2739,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -2822,33 +2799,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -2869,7 +2844,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -2877,52 +2851,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -2941,22 +2920,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -2965,23 +2944,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3009,22 +2987,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3033,22 +3012,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3057,138 +3036,137 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "ThreadStatus": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType" + "title": "NotLoadedThreadStatusType", + "type": "string" } }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType" + "title": "IdleThreadStatusType", + "type": "string" } }, - "title": "IdleThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "IdleThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType" + "title": "SystemErrorThreadStatusType", + "type": "string" } }, - "title": "SystemErrorThreadStatus" + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" }, { - "type": "object", + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, "required": [ "activeFlags", "type" ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" + "title": "ActiveThreadStatus", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -3196,36 +3174,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -3247,94 +3228,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -3343,33 +3322,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -3378,27 +3359,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3407,13 +3388,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -3422,11 +3403,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3435,25 +3416,44 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "thread": { + "allOf": [ + { + "$ref": "#/definitions/Thread" + } + ], + "description": "The updated thread after applying the rollback, with `turns` populated.\n\nThe ThreadItems stored in each Turn are lossy since we explicitly do not persist all agent interactions, such as command executions. This is the same behavior as `thread/resume`." + } + }, + "required": [ + "thread" + ], + "title": "ThreadRollbackResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadSetNameParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadSetNameParams.json index 3c701359..9381c7cb 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadSetNameParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadSetNameParams.json @@ -1,11 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadSetNameParams", - "type": "object", - "required": [ - "name", - "threadId" - ], "properties": { "name": { "type": "string" @@ -13,5 +7,11 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "name", + "threadId" + ], + "title": "ThreadSetNameParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadShellCommandParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadShellCommandParams.json index 8965b045..13ef468a 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadShellCommandParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadShellCommandParams.json @@ -1,11 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadShellCommandParams", - "type": "object", - "required": [ - "command", - "threadId" - ], "properties": { "command": { "description": "Shell command string evaluated by the thread's configured shell. Unlike `command/exec`, this intentionally preserves shell syntax such as pipes, redirects, and quoting. This runs unsandboxed with full access rather than inheriting the thread sandbox policy.", @@ -14,5 +8,11 @@ "threadId": { "type": "string" } - } + }, + "required": [ + "command", + "threadId" + ], + "title": "ThreadShellCommandParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStartParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStartParams.json index f2ec04e3..c7a2c06c 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStartParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStartParams.json @@ -1,7 +1,391 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadStartParams", - "type": "object", + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + }, + "ApprovalsReviewer": { + "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", + "enum": [ + "user", + "auto_review", + "guardian_subagent" + ], + "type": "string" + }, + "AskForApproval": { + "oneOf": [ + { + "enum": [ + "untrusted", + "on-failure", + "on-request", + "never" + ], + "type": "string" + }, + { + "additionalProperties": false, + "properties": { + "granular": { + "properties": { + "mcp_elicitations": { + "type": "boolean" + }, + "request_permissions": { + "default": false, + "type": "boolean" + }, + "rules": { + "type": "boolean" + }, + "sandbox_approval": { + "type": "boolean" + } + }, + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], + "type": "object" + } + }, + "required": [ + "granular" + ], + "title": "GranularAskForApproval", + "type": "object" + } + ] + }, + "DynamicToolSpec": { + "properties": { + "deferLoading": { + "type": "boolean" + }, + "description": { + "type": "string" + }, + "inputSchema": true, + "name": { + "type": "string" + }, + "namespace": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "description", + "inputSchema", + "name" + ], + "type": "object" + }, + "FileSystemAccessMode": { + "enum": [ + "read", + "write", + "none" + ], + "type": "string" + }, + "FileSystemPath": { + "oneOf": [ + { + "properties": { + "path": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": { + "enum": [ + "path" + ], + "title": "PathFileSystemPathType", + "type": "string" + } + }, + "required": [ + "path", + "type" + ], + "title": "PathFileSystemPath", + "type": "object" + }, + { + "properties": { + "pattern": { + "type": "string" + }, + "type": { + "enum": [ + "glob_pattern" + ], + "title": "GlobPatternFileSystemPathType", + "type": "string" + } + }, + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "special" + ], + "title": "SpecialFileSystemPathType", + "type": "string" + }, + "value": { + "$ref": "#/definitions/FileSystemSpecialPath" + } + }, + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" + } + ] + }, + "FileSystemSandboxEntry": { + "properties": { + "access": { + "$ref": "#/definitions/FileSystemAccessMode" + }, + "path": { + "$ref": "#/definitions/FileSystemPath" + } + }, + "required": [ + "access", + "path" + ], + "type": "object" + }, + "FileSystemSpecialPath": { + "oneOf": [ + { + "properties": { + "kind": { + "enum": [ + "root" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "minimal" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "current_working_directory" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "project_roots" + ], + "type": "string" + }, + "subpath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind" + ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "tmpdir" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "unknown" + ], + "type": "string" + }, + "path": { + "type": "string" + }, + "subpath": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "kind", + "path" + ], + "type": "object" + } + ] + }, + "PermissionProfile": { + "properties": { + "fileSystem": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfileFileSystemPermissions" + }, + { + "type": "null" + } + ] + }, + "network": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfileNetworkPermissions" + }, + { + "type": "null" + } + ] + } + }, + "type": "object" + }, + "PermissionProfileFileSystemPermissions": { + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + }, + "type": "array" + }, + "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, + "type": [ + "integer", + "null" + ] + } + }, + "required": [ + "entries" + ], + "type": "object" + }, + "PermissionProfileNetworkPermissions": { + "properties": { + "enabled": { + "type": [ + "boolean", + "null" + ] + } + }, + "type": "object" + }, + "Personality": { + "enum": [ + "none", + "friendly", + "pragmatic" + ], + "type": "string" + }, + "SandboxMode": { + "enum": [ + "read-only", + "workspace-write", + "danger-full-access" + ], + "type": "string" + }, + "ServiceTier": { + "enum": [ + "fast", + "flex" + ], + "type": "string" + }, + "ThreadStartSource": { + "enum": [ + "startup", + "clear" + ], + "type": "string" + } + }, "properties": { "approvalPolicy": { "anyOf": [ @@ -14,7 +398,6 @@ ] }, "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this thread and subsequent turns.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -22,7 +405,8 @@ { "type": "null" } - ] + ], + "description": "Override where approval requests are routed for review on this thread and subsequent turns." }, "baseInstructions": { "type": [ @@ -31,11 +415,11 @@ ] }, "config": { + "additionalProperties": true, "type": [ "object", "null" - ], - "additionalProperties": true + ] }, "cwd": { "type": [ @@ -49,6 +433,61 @@ "null" ] }, + "ephemeral": { + "type": [ + "boolean", + "null" + ] + }, + "model": { + "type": [ + "string", + "null" + ] + }, + "modelProvider": { + "type": [ + "string", + "null" + ] + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Full permissions override for this thread. Cannot be combined with `sandbox`." + }, + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/Personality" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "anyOf": [ + { + "$ref": "#/definitions/SandboxMode" + }, + { + "type": "null" + } + ] + }, + "serviceName": { + "type": [ + "string", + "null" + ] + }, "serviceTier": { "anyOf": [ { @@ -66,22 +505,6 @@ } ] }, - "ephemeral": { - "type": [ - "boolean", - "null" - ] - }, - "sandbox": { - "anyOf": [ - { - "$ref": "#/definitions/SandboxMode" - }, - { - "type": "null" - } - ] - }, "sessionStartSource": { "anyOf": [ { @@ -91,431 +514,8 @@ "type": "null" } ] - }, - "model": { - "type": [ - "string", - "null" - ] - }, - "modelProvider": { - "type": [ - "string", - "null" - ] - }, - "permissionProfile": { - "description": "Full permissions override for this thread. Cannot be combined with `sandbox`.", - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "serviceName": { - "type": [ - "string", - "null" - ] - }, - "personality": { - "anyOf": [ - { - "$ref": "#/definitions/Personality" - }, - { - "type": "null" - } - ] } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - }, - "ApprovalsReviewer": { - "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", - "type": "string", - "enum": [ - "user", - "auto_review", - "guardian_subagent" - ] - }, - "AskForApproval": { - "oneOf": [ - { - "type": "string", - "enum": [ - "untrusted", - "on-failure", - "on-request", - "never" - ] - }, - { - "type": "object", - "required": [ - "granular" - ], - "properties": { - "granular": { - "type": "object", - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "properties": { - "mcp_elicitations": { - "type": "boolean" - }, - "request_permissions": { - "default": false, - "type": "boolean" - }, - "rules": { - "type": "boolean" - }, - "sandbox_approval": { - "type": "boolean" - } - } - } - }, - "additionalProperties": false, - "title": "GranularAskForApproval" - } - ] - }, - "DynamicToolSpec": { - "type": "object", - "required": [ - "description", - "inputSchema", - "name" - ], - "properties": { - "deferLoading": { - "type": "boolean" - }, - "description": { - "type": "string" - }, - "inputSchema": true, - "name": { - "type": "string" - }, - "namespace": { - "type": [ - "string", - "null" - ] - } - } - }, - "FileSystemAccessMode": { - "type": "string", - "enum": [ - "read", - "write", - "none" - ] - }, - "FileSystemPath": { - "oneOf": [ - { - "type": "object", - "required": [ - "path", - "type" - ], - "properties": { - "path": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": { - "type": "string", - "enum": [ - "path" - ], - "title": "PathFileSystemPathType" - } - }, - "title": "PathFileSystemPath" - }, - { - "type": "object", - "required": [ - "pattern", - "type" - ], - "properties": { - "pattern": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "glob_pattern" - ], - "title": "GlobPatternFileSystemPathType" - } - }, - "title": "GlobPatternFileSystemPath" - }, - { - "type": "object", - "required": [ - "type", - "value" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "special" - ], - "title": "SpecialFileSystemPathType" - }, - "value": { - "$ref": "#/definitions/FileSystemSpecialPath" - } - }, - "title": "SpecialFileSystemPath" - } - ] - }, - "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], - "properties": { - "access": { - "$ref": "#/definitions/FileSystemAccessMode" - }, - "path": { - "$ref": "#/definitions/FileSystemPath" - } - } - }, - "FileSystemSpecialPath": { - "oneOf": [ - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "root" - ] - } - }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "minimal" - ] - } - }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "current_working_directory" - ] - } - }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "project_roots" - ] - }, - "subpath": { - "type": [ - "string", - "null" - ] - } - }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "tmpdir" - ] - } - }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" - }, - { - "type": "object", - "required": [ - "kind", - "path" - ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "unknown" - ] - }, - "path": { - "type": "string" - }, - "subpath": { - "type": [ - "string", - "null" - ] - } - } - } - ] - }, - "PermissionProfile": { - "type": "object", - "properties": { - "fileSystem": { - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfileFileSystemPermissions" - }, - { - "type": "null" - } - ] - }, - "network": { - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfileNetworkPermissions" - }, - { - "type": "null" - } - ] - } - } - }, - "PermissionProfileFileSystemPermissions": { - "type": "object", - "required": [ - "entries" - ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - } - }, - "globScanMaxDepth": { - "type": [ - "integer", - "null" - ], - "format": "uint", - "minimum": 1.0 - } - } - }, - "PermissionProfileNetworkPermissions": { - "type": "object", - "properties": { - "enabled": { - "type": [ - "boolean", - "null" - ] - } - } - }, - "Personality": { - "type": "string", - "enum": [ - "none", - "friendly", - "pragmatic" - ] - }, - "SandboxMode": { - "type": "string", - "enum": [ - "read-only", - "workspace-write", - "danger-full-access" - ] - }, - "ServiceTier": { - "type": "string", - "enum": [ - "fast", - "flex" - ] - }, - "ThreadStartSource": { - "type": "string", - "enum": [ - "startup", - "clear" - ] - } - } + "title": "ThreadStartParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json index b37aac7b..1c843409 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json @@ -1,89 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadStartResponse", - "type": "object", - "required": [ - "approvalPolicy", - "approvalsReviewer", - "cwd", - "model", - "modelProvider", - "sandbox", - "thread" - ], - "properties": { - "approvalPolicy": { - "$ref": "#/definitions/AskForApproval" - }, - "approvalsReviewer": { - "description": "Reviewer currently used for approval requests on this thread.", - "allOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - } - ] - }, - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "instructionSources": { - "description": "Instruction source files currently loaded for this thread.", - "default": [], - "type": "array", - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "model": { - "type": "string" - }, - "modelProvider": { - "type": "string" - }, - "permissionProfile": { - "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`.", - "default": null, - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "reasoningEffort": { - "anyOf": [ - { - "$ref": "#/definitions/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "sandbox": { - "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view.", - "allOf": [ - { - "$ref": "#/definitions/SandboxPolicy" - } - ] - }, - "serviceTier": { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - "thread": { - "$ref": "#/definitions/Thread" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", @@ -94,37 +10,28 @@ }, "ApprovalsReviewer": { "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", - "type": "string", "enum": [ "user", "auto_review", "guardian_subagent" - ] + ], + "type": "string" }, "AskForApproval": { "oneOf": [ { - "type": "string", "enum": [ "untrusted", "on-failure", "on-request", "never" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "granular" - ], + "additionalProperties": false, "properties": { "granular": { - "type": "object", - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -139,38 +46,46 @@ "sandbox_approval": { "type": "boolean" } - } + }, + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "GranularAskForApproval" + "required": [ + "granular" + ], + "title": "GranularAskForApproval", + "type": "object" } ] }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -181,132 +96,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -317,10 +229,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -329,36 +244,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -370,21 +279,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -396,21 +307,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -428,119 +339,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], "properties": { "accepted_at": { "type": "string" @@ -584,42 +489,41 @@ "surface": { "type": "string" } - } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" }, "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], "properties": { "acceptance_sketch": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "blockers": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": "string" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "duplicate_of": { "type": [ @@ -628,10 +532,10 @@ ] }, "evidence_refs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "horizon": { "type": "string" @@ -643,10 +547,10 @@ "type": "string" }, "lane_hints": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -655,10 +559,10 @@ "type": "string" }, "source_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } + }, + "type": "array" }, "status": { "type": "string" @@ -675,14 +579,21 @@ "null" ] } - } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], "properties": { "diff_pressure": { "type": "string" @@ -697,12 +608,12 @@ "type": "string" }, "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "warning": { "type": [ @@ -710,21 +621,22 @@ "null" ] } - } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" }, "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], "properties": { "end_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "note": { "type": [ @@ -736,12 +648,12 @@ "type": "string" }, "start_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "symbol": { "type": [ @@ -749,22 +661,19 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -778,57 +687,59 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyGraph": { - "type": "object", "properties": { "edges": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphEdge" - } + }, + "type": "array" }, "nodes": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphNode" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], "properties": { "checkpoint_id": { "type": "string" }, "frontier_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "graph_revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -836,21 +747,20 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" }, "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": [ @@ -879,58 +789,59 @@ "target_id": { "type": "string" } - } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" }, "EpiphanyGraphFrontier": { - "type": "object", "properties": { "active_edge_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "active_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], "properties": { "architecture_node_id": { "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "dataflow_node_id": { "type": "string" @@ -941,21 +852,20 @@ "null" ] } - } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" }, "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -984,10 +894,15 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" }, "EpiphanyGraphs": { - "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -996,20 +911,15 @@ "$ref": "#/definitions/EpiphanyGraph" }, "links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphLink" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], "properties": { "description": { "type": "string" @@ -1026,16 +936,15 @@ "status": { "type": "string" } - } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" }, "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], "properties": { "captured_at_turn_id": { "type": [ @@ -1047,19 +956,19 @@ "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "disposition": { "$ref": "#/definitions/EpiphanyInvestigationDisposition" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "focus": { "type": "string" @@ -1074,10 +983,10 @@ ] }, "open_questions": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1085,23 +994,23 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" }, "EpiphanyInvestigationDisposition": { - "type": "string", "enum": [ "resume_ready", "regather_required" - ] + ], + "type": "string" }, "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], "properties": { "authority_scope": { "type": [ @@ -1122,16 +1031,16 @@ "$ref": "#/definitions/EpiphanyJobKind" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "owner_role": { "type": "string" @@ -1139,29 +1048,32 @@ "scope": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" }, "EpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "EpiphanyModeKind": { - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], "properties": { "kind": { "anyOf": [ @@ -1176,36 +1088,31 @@ "name": { "type": "string" } - } + }, + "required": [ + "name" + ], + "type": "object" }, "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], "properties": { "acceptance_criteria": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "evidence_required": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1214,25 +1121,25 @@ "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" }, "review_gates": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "risks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "scope": { "$ref": "#/definitions/EpiphanyObjectiveDraftScope" }, "source_item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "status": { "type": "string" @@ -1243,10 +1150,18 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyObjectiveDraftLanePlan": { - "type": "object", "properties": { "body": { "type": [ @@ -1284,45 +1199,39 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyObjectiveDraftScope": { - "type": "object", "properties": { "excludes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1336,17 +1245,16 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], "properties": { "body": { "type": [ @@ -1379,10 +1287,10 @@ "type": "string" }, "tags": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": "string" @@ -1393,20 +1301,23 @@ "null" ] } - } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" }, "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], "properties": { "blocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": [ @@ -1436,10 +1347,10 @@ ] }, "unblocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "urgency": { "type": [ @@ -1450,19 +1361,20 @@ "value": { "type": "string" } - } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" }, "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], "properties": { "assignees": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "author": { "type": [ @@ -1483,11 +1395,11 @@ ] }, "database_id": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "external_id": { "type": [ @@ -1508,21 +1420,21 @@ ] }, "issue_number": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "kind": { "type": "string" }, "labels": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "milestone": { "type": [ @@ -1572,34 +1484,37 @@ "null" ] } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "EpiphanyPlanningState": { - "type": "object", "properties": { "backlog_items": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyBacklogItem" - } + }, + "type": "array" }, "captures": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningCapture" - } + }, + "type": "array" }, "objective_drafts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObjectiveDraft" - } + }, + "type": "array" }, "roadmap_streams": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRoadmapStream" - } + }, + "type": "array" }, "workspace_root": { "type": [ @@ -1607,33 +1522,29 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], "properties": { "exact_available": { "type": "boolean" }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "path_prefix": { "type": "string" @@ -1645,26 +1556,27 @@ "type": "string" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" } - } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" }, "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], "properties": { "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "index_revision": { "type": [ @@ -1673,82 +1585,79 @@ ] }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "last_indexed_at_unix_seconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "semantic_available": { "type": "boolean" }, "shards": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRetrievalShardSummary" - } + }, + "type": "array" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" }, "workspace_root": { "type": "string" } - } + }, + "required": [ + "workspace_root" + ], + "type": "object" }, "EpiphanyRetrievalStatus": { - "type": "string", "enum": [ "unavailable", "ready", "stale", "indexing" - ] + ], + "type": "string" }, "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], "properties": { "blocked_by": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "near_term_focus": { "type": [ @@ -1771,18 +1680,16 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" }, "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], "properties": { "authority_scope": { "type": "string" @@ -1794,16 +1701,16 @@ "type": "string" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "role_id": { "type": "string" @@ -1820,10 +1727,18 @@ "surface": { "type": "string" } - } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" }, "EpiphanyScratchPad": { - "type": "object", "properties": { "hypothesis": { "type": [ @@ -1838,10 +1753,10 @@ ] }, "notes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1849,15 +1764,10 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], "properties": { "id": { "type": "string" @@ -1874,19 +1784,21 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" }, "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], "properties": { "acceptance_receipts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } + }, + "type": "array" }, "active_subgoal_id": { "type": [ @@ -1928,10 +1840,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - } + }, + "type": "array" }, "investigation_checkpoint": { "anyOf": [ @@ -1944,10 +1856,10 @@ ] }, "job_bindings": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - } + }, + "type": "array" }, "last_updated_turn_id": { "type": [ @@ -1972,19 +1884,19 @@ ] }, "observations": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - } + }, + "type": "array" }, "planning": { "$ref": "#/definitions/EpiphanyPlanningState" }, "recent_evidence": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - } + }, + "type": "array" }, "retrieval": { "anyOf": [ @@ -1997,15 +1909,15 @@ ] }, "revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "runtime_links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - } + }, + "type": "array" }, "scratch": { "anyOf": [ @@ -2018,91 +1930,90 @@ ] }, "subgoals": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - } + }, + "type": "array" } - } + }, + "required": [ + "revision" + ], + "type": "object" }, "FileSystemAccessMode": { - "type": "string", "enum": [ "read", "write", "none" - ] + ], + "type": "string" }, "FileSystemPath": { "oneOf": [ { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "path" ], - "title": "PathFileSystemPathType" + "title": "PathFileSystemPathType", + "type": "string" } }, - "title": "PathFileSystemPath" - }, - { - "type": "object", "required": [ - "pattern", + "path", "type" ], + "title": "PathFileSystemPath", + "type": "object" + }, + { "properties": { "pattern": { "type": "string" }, "type": { - "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType" + "title": "GlobPatternFileSystemPathType", + "type": "string" } }, - "title": "GlobPatternFileSystemPath" + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType" + "title": "SpecialFileSystemPathType", + "type": "string" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "title": "SpecialFileSystemPath" + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" } ] }, "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -2110,66 +2021,67 @@ "path": { "$ref": "#/definitions/FileSystemPath" } - } + }, + "required": [ + "access", + "path" + ], + "type": "object" }, "FileSystemSpecialPath": { "oneOf": [ { - "type": "object", - "required": [ - "kind" - ], "properties": { "kind": { - "type": "string", "enum": [ "root" - ] + ], + "type": "string" } }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "minimal" - ] + ], + "type": "string" } }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "current_working_directory" - ] + ], + "type": "string" } }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "project_roots" - ] + ], + "type": "string" }, "subpath": { "type": [ @@ -2178,50 +2090,49 @@ ] } }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "tmpdir" - ] + ], + "type": "string" } }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" }, { - "type": "object", - "required": [ - "kind", - "path" - ], "properties": { "kind": { - "type": "string", "enum": [ "unknown" - ] + ], + "type": "string" }, "path": { "type": "string" @@ -2232,17 +2143,16 @@ "null" ] } - } + }, + "required": [ + "kind", + "path" + ], + "type": "object" } ] }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -2253,10 +2163,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "GitInfo": { - "type": "object", "properties": { "branch": { "type": [ @@ -2276,14 +2191,10 @@ "null" ] } - } + }, + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -2291,80 +2202,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -2372,89 +2281,92 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NetworkAccess": { - "type": "string", "enum": [ "restricted", "enabled" - ] + ], + "type": "string" }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -2463,19 +2375,22 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "PermissionProfile": { - "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -2497,32 +2412,32 @@ } ] } - } + }, + "type": "object" }, "PermissionProfileFileSystemPermissions": { - "type": "object", - "required": [ - "entries" - ], "properties": { "entries": { - "type": "array", "items": { "$ref": "#/definitions/FileSystemSandboxEntry" - } + }, + "type": "array" }, "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 1.0 + ] } - } + }, + "required": [ + "entries" + ], + "type": "object" }, "PermissionProfileNetworkPermissions": { - "type": "object", "properties": { "enabled": { "type": [ @@ -2530,15 +2445,12 @@ "null" ] } - } + }, + "type": "object" }, "ReadOnlyAccess": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "includePlatformDefaults": { "default": true, @@ -2546,42 +2458,45 @@ }, "readableRoots": { "default": [], - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "restricted" ], - "title": "RestrictedReadOnlyAccessType" + "title": "RestrictedReadOnlyAccessType", + "type": "string" } }, - "title": "RestrictedReadOnlyAccess" - }, - { - "type": "object", "required": [ "type" ], + "title": "RestrictedReadOnlyAccess", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "fullAccess" ], - "title": "FullAccessReadOnlyAccessType" + "title": "FullAccessReadOnlyAccessType", + "type": "string" } }, - "title": "FullAccessReadOnlyAccess" + "required": [ + "type" + ], + "title": "FullAccessReadOnlyAccess", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -2589,85 +2504,82 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "SandboxPolicy": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "dangerFullAccess" ], - "title": "DangerFullAccessSandboxPolicyType" + "title": "DangerFullAccessSandboxPolicyType", + "type": "string" } }, - "title": "DangerFullAccessSandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "DangerFullAccessSandboxPolicy", + "type": "object" + }, + { "properties": { "access": { - "default": { - "type": "fullAccess" - }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ] + ], + "default": { + "type": "fullAccess" + } }, "networkAccess": { "default": false, "type": "boolean" }, "type": { - "type": "string", "enum": [ "readOnly" ], - "title": "ReadOnlySandboxPolicyType" + "title": "ReadOnlySandboxPolicyType", + "type": "string" } }, - "title": "ReadOnlySandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "ReadOnlySandboxPolicy", + "type": "object" + }, + { "properties": { "networkAccess": { - "default": "restricted", "allOf": [ { "$ref": "#/definitions/NetworkAccess" } - ] + ], + "default": "restricted" }, "type": { - "type": "string", "enum": [ "externalSandbox" ], - "title": "ExternalSandboxSandboxPolicyType" + "title": "ExternalSandboxSandboxPolicyType", + "type": "string" } }, - "title": "ExternalSandboxSandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "ExternalSandboxSandboxPolicy", + "type": "object" + }, + { "properties": { "excludeSlashTmp": { "default": false, @@ -2682,103 +2594,99 @@ "type": "boolean" }, "readOnlyAccess": { - "default": { - "type": "fullAccess" - }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ] + ], + "default": { + "type": "fullAccess" + } }, "type": { - "type": "string", "enum": [ "workspaceWrite" ], - "title": "WorkspaceWriteSandboxPolicyType" + "title": "WorkspaceWriteSandboxPolicyType", + "type": "string" }, "writableRoots": { "default": [], - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" } }, - "title": "WorkspaceWriteSandboxPolicy" + "required": [ + "type" + ], + "title": "WorkspaceWriteSandboxPolicy", + "type": "object" } ] }, "ServiceTier": { - "type": "string", "enum": [ "fast", "flex" - ] + ], + "type": "string" }, "SessionSource": { "oneOf": [ { - "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "custom" - ], + "additionalProperties": false, "properties": { "custom": { "type": "string" } }, - "additionalProperties": false, - "title": "CustomSessionSource" + "required": [ + "custom" + ], + "title": "CustomSessionSource", + "type": "object" }, { - "type": "object", - "required": [ - "subAgent" - ], + "additionalProperties": false, "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "additionalProperties": false, - "title": "SubAgentSessionSource" + "required": [ + "subAgent" + ], + "title": "SubAgentSessionSource", + "type": "object" } ] }, "SubAgentSource": { "oneOf": [ { - "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "thread_spawn" - ], + "additionalProperties": false, "properties": { "thread_spawn": { - "type": "object", - "required": [ - "depth", - "parent_thread_id" - ], "properties": { "agent_nickname": { "default": null, @@ -2788,7 +2696,6 @@ ] }, "agent_path": { - "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2796,7 +2703,8 @@ { "type": "null" } - ] + ], + "default": null }, "agent_role": { "default": null, @@ -2806,46 +2714,50 @@ ] }, "depth": { - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - } + }, + "required": [ + "depth", + "parent_thread_id" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ThreadSpawnSubAgentSource" + "required": [ + "thread_spawn" + ], + "title": "ThreadSpawnSubAgentSource", + "type": "object" }, { - "type": "object", - "required": [ - "other" - ], + "additionalProperties": false, "properties": { "other": { "type": "string" } }, - "additionalProperties": false, - "title": "OtherSubAgentSource" + "required": [ + "other" + ], + "title": "OtherSubAgentSource", + "type": "object" } ] }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -2854,23 +2766,13 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "Thread": { - "type": "object", - "required": [ - "cliVersion", - "createdAt", - "cwd", - "ephemeral", - "id", - "modelProvider", - "preview", - "source", - "status", - "turns", - "updatedAt" - ], "properties": { "agentNickname": { "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", @@ -2892,23 +2794,22 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "cwd": { - "description": "Working directory captured for the thread.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Working directory captured for the thread." }, "ephemeral": { "description": "Whether the thread is ephemeral and should not be materialized on disk.", "type": "boolean" }, "epiphanyState": { - "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads.", "anyOf": [ { "$ref": "#/definitions/EpiphanyThreadState" @@ -2916,7 +2817,8 @@ { "type": "null" } - ] + ], + "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads." }, "forkedFromId": { "description": "Source thread id when this thread was created by forking another thread.", @@ -2926,7 +2828,6 @@ ] }, "gitInfo": { - "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2934,7 +2835,8 @@ { "type": "null" } - ] + ], + "description": "Optional Git metadata captured when the thread was created." }, "id": { "type": "string" @@ -2962,41 +2864,55 @@ "type": "string" }, "source": { - "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).", "allOf": [ { "$ref": "#/definitions/SessionSource" } - ] + ], + "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." }, "status": { - "description": "Current runtime status for the thread.", "allOf": [ { "$ref": "#/definitions/ThreadStatus" } - ] + ], + "description": "Current runtime status for the thread." }, "turns": { "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/Turn" - } + }, + "type": "array" }, "updatedAt": { "description": "Unix timestamp (in seconds) when the thread was last updated.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } - } + }, + "required": [ + "cliVersion", + "createdAt", + "cwd", + "ephemeral", + "id", + "modelProvider", + "preview", + "source", + "status", + "turns", + "updatedAt" + ], + "type": "object" }, "ThreadActiveFlag": { - "type": "string", "enum": [ "waitingOnApproval", "waitingOnUserInput" - ] + ], + "type": "string" }, "ThreadId": { "type": "string" @@ -3004,72 +2920,65 @@ "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -3077,10 +2986,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -3088,29 +2997,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -3119,59 +3029,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -3186,34 +3093,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -3226,40 +3133,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -3268,34 +3177,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -3336,42 +3243,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -3395,33 +3303,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -3442,7 +3348,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -3450,52 +3355,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -3514,22 +3424,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3538,23 +3448,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3582,22 +3491,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3606,22 +3516,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3630,138 +3540,137 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "ThreadStatus": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType" + "title": "NotLoadedThreadStatusType", + "type": "string" } }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType" + "title": "IdleThreadStatusType", + "type": "string" } }, - "title": "IdleThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "IdleThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType" + "title": "SystemErrorThreadStatusType", + "type": "string" } }, - "title": "SystemErrorThreadStatus" + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" }, { - "type": "object", + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, "required": [ "activeFlags", "type" ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" + "title": "ActiveThreadStatus", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -3769,36 +3678,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -3820,94 +3732,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -3916,33 +3826,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -3951,27 +3863,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3980,13 +3892,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -3995,11 +3907,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -4008,25 +3920,113 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "approvalPolicy": { + "$ref": "#/definitions/AskForApproval" + }, + "approvalsReviewer": { + "allOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + } + ], + "description": "Reviewer currently used for approval requests on this thread." + }, + "cwd": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "instructionSources": { + "default": [], + "description": "Instruction source files currently loaded for this thread.", + "items": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "type": "array" + }, + "model": { + "type": "string" + }, + "modelProvider": { + "type": "string" + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "default": null, + "description": "Canonical active permissions view for this thread when representable. This is `null` for external sandbox policies because external enforcement cannot be round-tripped as a `PermissionProfile`." + }, + "reasoningEffort": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningEffort" + }, + { + "type": "null" + } + ] + }, + "sandbox": { + "allOf": [ + { + "$ref": "#/definitions/SandboxPolicy" + } + ], + "description": "Legacy sandbox policy retained for compatibility. New clients should use `permissionProfile` when present as the canonical active permissions view." + }, + "serviceTier": { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "approvalPolicy", + "approvalsReviewer", + "cwd", + "model", + "modelProvider", + "sandbox", + "thread" + ], + "title": "ThreadStartResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json index 2d3b8a04..fa1cb8d5 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json @@ -1,15 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadStartedNotification", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "$ref": "#/definitions/Thread" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", @@ -19,29 +9,28 @@ "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -52,132 +41,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -188,10 +174,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -200,36 +189,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -241,21 +224,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -267,21 +252,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -299,119 +284,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], "properties": { "accepted_at": { "type": "string" @@ -455,42 +434,41 @@ "surface": { "type": "string" } - } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" }, "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], "properties": { "acceptance_sketch": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "blockers": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": "string" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "duplicate_of": { "type": [ @@ -499,10 +477,10 @@ ] }, "evidence_refs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "horizon": { "type": "string" @@ -514,10 +492,10 @@ "type": "string" }, "lane_hints": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -526,10 +504,10 @@ "type": "string" }, "source_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } + }, + "type": "array" }, "status": { "type": "string" @@ -546,14 +524,21 @@ "null" ] } - } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], "properties": { "diff_pressure": { "type": "string" @@ -568,12 +553,12 @@ "type": "string" }, "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "warning": { "type": [ @@ -581,21 +566,22 @@ "null" ] } - } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" }, "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], "properties": { "end_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "note": { "type": [ @@ -607,12 +593,12 @@ "type": "string" }, "start_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "symbol": { "type": [ @@ -620,22 +606,19 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -649,57 +632,59 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyGraph": { - "type": "object", "properties": { "edges": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphEdge" - } + }, + "type": "array" }, "nodes": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphNode" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], "properties": { "checkpoint_id": { "type": "string" }, "frontier_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "graph_revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -707,21 +692,20 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" }, "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": [ @@ -750,58 +734,59 @@ "target_id": { "type": "string" } - } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" }, "EpiphanyGraphFrontier": { - "type": "object", "properties": { "active_edge_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "active_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], "properties": { "architecture_node_id": { "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "dataflow_node_id": { "type": "string" @@ -812,21 +797,20 @@ "null" ] } - } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" }, "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -855,10 +839,15 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" }, "EpiphanyGraphs": { - "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -867,20 +856,15 @@ "$ref": "#/definitions/EpiphanyGraph" }, "links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphLink" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], "properties": { "description": { "type": "string" @@ -897,16 +881,15 @@ "status": { "type": "string" } - } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" }, "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], "properties": { "captured_at_turn_id": { "type": [ @@ -918,19 +901,19 @@ "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "disposition": { "$ref": "#/definitions/EpiphanyInvestigationDisposition" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "focus": { "type": "string" @@ -945,10 +928,10 @@ ] }, "open_questions": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -956,23 +939,23 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" }, "EpiphanyInvestigationDisposition": { - "type": "string", "enum": [ "resume_ready", "regather_required" - ] + ], + "type": "string" }, "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], "properties": { "authority_scope": { "type": [ @@ -993,16 +976,16 @@ "$ref": "#/definitions/EpiphanyJobKind" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "owner_role": { "type": "string" @@ -1010,29 +993,32 @@ "scope": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" }, "EpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "EpiphanyModeKind": { - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], "properties": { "kind": { "anyOf": [ @@ -1047,36 +1033,31 @@ "name": { "type": "string" } - } + }, + "required": [ + "name" + ], + "type": "object" }, "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], "properties": { "acceptance_criteria": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "evidence_required": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1085,25 +1066,25 @@ "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" }, "review_gates": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "risks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "scope": { "$ref": "#/definitions/EpiphanyObjectiveDraftScope" }, "source_item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "status": { "type": "string" @@ -1114,10 +1095,18 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyObjectiveDraftLanePlan": { - "type": "object", "properties": { "body": { "type": [ @@ -1155,45 +1144,39 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyObjectiveDraftScope": { - "type": "object", "properties": { "excludes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1207,17 +1190,16 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], "properties": { "body": { "type": [ @@ -1250,10 +1232,10 @@ "type": "string" }, "tags": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": "string" @@ -1264,20 +1246,23 @@ "null" ] } - } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" }, "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], "properties": { "blocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": [ @@ -1307,10 +1292,10 @@ ] }, "unblocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "urgency": { "type": [ @@ -1321,19 +1306,20 @@ "value": { "type": "string" } - } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" }, "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], "properties": { "assignees": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "author": { "type": [ @@ -1354,11 +1340,11 @@ ] }, "database_id": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "external_id": { "type": [ @@ -1379,21 +1365,21 @@ ] }, "issue_number": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "kind": { "type": "string" }, "labels": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "milestone": { "type": [ @@ -1443,34 +1429,37 @@ "null" ] } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "EpiphanyPlanningState": { - "type": "object", "properties": { "backlog_items": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyBacklogItem" - } + }, + "type": "array" }, "captures": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningCapture" - } + }, + "type": "array" }, "objective_drafts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObjectiveDraft" - } + }, + "type": "array" }, "roadmap_streams": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRoadmapStream" - } + }, + "type": "array" }, "workspace_root": { "type": [ @@ -1478,33 +1467,29 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], "properties": { "exact_available": { "type": "boolean" }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "path_prefix": { "type": "string" @@ -1516,26 +1501,27 @@ "type": "string" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" } - } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" }, "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], "properties": { "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "index_revision": { "type": [ @@ -1544,82 +1530,79 @@ ] }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "last_indexed_at_unix_seconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "semantic_available": { "type": "boolean" }, "shards": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRetrievalShardSummary" - } + }, + "type": "array" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" }, "workspace_root": { "type": "string" } - } + }, + "required": [ + "workspace_root" + ], + "type": "object" }, "EpiphanyRetrievalStatus": { - "type": "string", "enum": [ "unavailable", "ready", "stale", "indexing" - ] + ], + "type": "string" }, "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], "properties": { "blocked_by": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "near_term_focus": { "type": [ @@ -1642,18 +1625,16 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" }, "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], "properties": { "authority_scope": { "type": "string" @@ -1665,16 +1646,16 @@ "type": "string" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "role_id": { "type": "string" @@ -1691,10 +1672,18 @@ "surface": { "type": "string" } - } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" }, "EpiphanyScratchPad": { - "type": "object", "properties": { "hypothesis": { "type": [ @@ -1709,10 +1698,10 @@ ] }, "notes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1720,15 +1709,10 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], "properties": { "id": { "type": "string" @@ -1745,19 +1729,21 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" }, "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], "properties": { "acceptance_receipts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } + }, + "type": "array" }, "active_subgoal_id": { "type": [ @@ -1799,10 +1785,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - } + }, + "type": "array" }, "investigation_checkpoint": { "anyOf": [ @@ -1815,10 +1801,10 @@ ] }, "job_bindings": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - } + }, + "type": "array" }, "last_updated_turn_id": { "type": [ @@ -1843,19 +1829,19 @@ ] }, "observations": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - } + }, + "type": "array" }, "planning": { "$ref": "#/definitions/EpiphanyPlanningState" }, "recent_evidence": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - } + }, + "type": "array" }, "retrieval": { "anyOf": [ @@ -1868,15 +1854,15 @@ ] }, "revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "runtime_links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - } + }, + "type": "array" }, "scratch": { "anyOf": [ @@ -1889,20 +1875,18 @@ ] }, "subgoals": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - } + }, + "type": "array" } - } + }, + "required": [ + "revision" + ], + "type": "object" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -1913,10 +1897,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "GitInfo": { - "type": "object", "properties": { "branch": { "type": [ @@ -1936,14 +1925,10 @@ "null" ] } - } + }, + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -1951,80 +1936,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -2032,82 +2015,85 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -2116,20 +2102,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -2137,70 +2126,63 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "SessionSource": { "oneOf": [ { - "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "custom" - ], + "additionalProperties": false, "properties": { "custom": { "type": "string" } }, - "additionalProperties": false, - "title": "CustomSessionSource" + "required": [ + "custom" + ], + "title": "CustomSessionSource", + "type": "object" }, { - "type": "object", - "required": [ - "subAgent" - ], + "additionalProperties": false, "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "additionalProperties": false, - "title": "SubAgentSessionSource" + "required": [ + "subAgent" + ], + "title": "SubAgentSessionSource", + "type": "object" } ] }, "SubAgentSource": { "oneOf": [ { - "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "thread_spawn" - ], + "additionalProperties": false, "properties": { "thread_spawn": { - "type": "object", - "required": [ - "depth", - "parent_thread_id" - ], "properties": { "agent_nickname": { "default": null, @@ -2210,7 +2192,6 @@ ] }, "agent_path": { - "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2218,7 +2199,8 @@ { "type": "null" } - ] + ], + "default": null }, "agent_role": { "default": null, @@ -2228,46 +2210,50 @@ ] }, "depth": { - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - } + }, + "required": [ + "depth", + "parent_thread_id" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ThreadSpawnSubAgentSource" + "required": [ + "thread_spawn" + ], + "title": "ThreadSpawnSubAgentSource", + "type": "object" }, { - "type": "object", - "required": [ - "other" - ], + "additionalProperties": false, "properties": { "other": { "type": "string" } }, - "additionalProperties": false, - "title": "OtherSubAgentSource" + "required": [ + "other" + ], + "title": "OtherSubAgentSource", + "type": "object" } ] }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -2276,23 +2262,13 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "Thread": { - "type": "object", - "required": [ - "cliVersion", - "createdAt", - "cwd", - "ephemeral", - "id", - "modelProvider", - "preview", - "source", - "status", - "turns", - "updatedAt" - ], "properties": { "agentNickname": { "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", @@ -2314,23 +2290,22 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "cwd": { - "description": "Working directory captured for the thread.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Working directory captured for the thread." }, "ephemeral": { "description": "Whether the thread is ephemeral and should not be materialized on disk.", "type": "boolean" }, "epiphanyState": { - "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads.", "anyOf": [ { "$ref": "#/definitions/EpiphanyThreadState" @@ -2338,7 +2313,8 @@ { "type": "null" } - ] + ], + "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads." }, "forkedFromId": { "description": "Source thread id when this thread was created by forking another thread.", @@ -2348,7 +2324,6 @@ ] }, "gitInfo": { - "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2356,7 +2331,8 @@ { "type": "null" } - ] + ], + "description": "Optional Git metadata captured when the thread was created." }, "id": { "type": "string" @@ -2384,41 +2360,55 @@ "type": "string" }, "source": { - "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).", "allOf": [ { "$ref": "#/definitions/SessionSource" } - ] + ], + "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." }, "status": { - "description": "Current runtime status for the thread.", "allOf": [ { "$ref": "#/definitions/ThreadStatus" } - ] + ], + "description": "Current runtime status for the thread." }, "turns": { "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/Turn" - } + }, + "type": "array" }, "updatedAt": { "description": "Unix timestamp (in seconds) when the thread was last updated.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } - } + }, + "required": [ + "cliVersion", + "createdAt", + "cwd", + "ephemeral", + "id", + "modelProvider", + "preview", + "source", + "status", + "turns", + "updatedAt" + ], + "type": "object" }, "ThreadActiveFlag": { - "type": "string", "enum": [ "waitingOnApproval", "waitingOnUserInput" - ] + ], + "type": "string" }, "ThreadId": { "type": "string" @@ -2426,72 +2416,65 @@ "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -2499,10 +2482,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -2510,29 +2493,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -2541,59 +2525,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -2608,34 +2589,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -2648,40 +2629,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2690,34 +2673,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -2758,42 +2739,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -2817,33 +2799,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -2864,7 +2844,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -2872,52 +2851,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -2936,22 +2920,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -2960,23 +2944,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3004,22 +2987,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3028,22 +3012,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3052,138 +3036,137 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "ThreadStatus": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType" + "title": "NotLoadedThreadStatusType", + "type": "string" } }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType" + "title": "IdleThreadStatusType", + "type": "string" } }, - "title": "IdleThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "IdleThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType" + "title": "SystemErrorThreadStatusType", + "type": "string" } }, - "title": "SystemErrorThreadStatus" + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" }, { - "type": "object", + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, "required": [ "activeFlags", "type" ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" + "title": "ActiveThreadStatus", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -3191,36 +3174,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -3242,94 +3228,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -3338,33 +3322,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -3373,27 +3359,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3402,13 +3388,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -3417,11 +3403,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3430,25 +3416,39 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "thread" + ], + "title": "ThreadStartedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStatusChangedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStatusChangedNotification.json index 74176bbe..bd658504 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStatusChangedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadStatusChangedNotification.json @@ -1,11 +1,89 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadStatusChangedNotification", - "type": "object", - "required": [ - "status", - "threadId" - ], + "definitions": { + "ThreadActiveFlag": { + "enum": [ + "waitingOnApproval", + "waitingOnUserInput" + ], + "type": "string" + }, + "ThreadStatus": { + "oneOf": [ + { + "properties": { + "type": { + "enum": [ + "notLoaded" + ], + "title": "NotLoadedThreadStatusType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "idle" + ], + "title": "IdleThreadStatusType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "IdleThreadStatus", + "type": "object" + }, + { + "properties": { + "type": { + "enum": [ + "systemError" + ], + "title": "SystemErrorThreadStatusType", + "type": "string" + } + }, + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" + }, + { + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, + "required": [ + "activeFlags", + "type" + ], + "title": "ActiveThreadStatus", + "type": "object" + } + ] + } + }, "properties": { "status": { "$ref": "#/definitions/ThreadStatus" @@ -14,88 +92,10 @@ "type": "string" } }, - "definitions": { - "ThreadActiveFlag": { - "type": "string", - "enum": [ - "waitingOnApproval", - "waitingOnUserInput" - ] - }, - "ThreadStatus": { - "oneOf": [ - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "notLoaded" - ], - "title": "NotLoadedThreadStatusType" - } - }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "idle" - ], - "title": "IdleThreadStatusType" - } - }, - "title": "IdleThreadStatus" - }, - { - "type": "object", - "required": [ - "type" - ], - "properties": { - "type": { - "type": "string", - "enum": [ - "systemError" - ], - "title": "SystemErrorThreadStatusType" - } - }, - "title": "SystemErrorThreadStatus" - }, - { - "type": "object", - "required": [ - "activeFlags", - "type" - ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" - } - ] - } - } + "required": [ + "status", + "threadId" + ], + "title": "ThreadStatusChangedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadTokenUsageUpdatedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadTokenUsageUpdatedNotification.json index 20edbcdf..a1aba9b1 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadTokenUsageUpdatedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadTokenUsageUpdatedNotification.json @@ -1,12 +1,68 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadTokenUsageUpdatedNotification", - "type": "object", - "required": [ - "threadId", - "tokenUsage", - "turnId" - ], + "definitions": { + "ThreadTokenUsage": { + "properties": { + "last": { + "$ref": "#/definitions/TokenUsageBreakdown" + }, + "modelAutoCompactTokenLimit": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "modelContextWindow": { + "format": "int64", + "type": [ + "integer", + "null" + ] + }, + "total": { + "$ref": "#/definitions/TokenUsageBreakdown" + } + }, + "required": [ + "last", + "total" + ], + "type": "object" + }, + "TokenUsageBreakdown": { + "properties": { + "cachedInputTokens": { + "format": "int64", + "type": "integer" + }, + "inputTokens": { + "format": "int64", + "type": "integer" + }, + "outputTokens": { + "format": "int64", + "type": "integer" + }, + "reasoningOutputTokens": { + "format": "int64", + "type": "integer" + }, + "totalTokens": { + "format": "int64", + "type": "integer" + } + }, + "required": [ + "cachedInputTokens", + "inputTokens", + "outputTokens", + "reasoningOutputTokens", + "totalTokens" + ], + "type": "object" + } + }, "properties": { "threadId": { "type": "string" @@ -18,67 +74,11 @@ "type": "string" } }, - "definitions": { - "ThreadTokenUsage": { - "type": "object", - "required": [ - "last", - "total" - ], - "properties": { - "last": { - "$ref": "#/definitions/TokenUsageBreakdown" - }, - "modelAutoCompactTokenLimit": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "modelContextWindow": { - "type": [ - "integer", - "null" - ], - "format": "int64" - }, - "total": { - "$ref": "#/definitions/TokenUsageBreakdown" - } - } - }, - "TokenUsageBreakdown": { - "type": "object", - "required": [ - "cachedInputTokens", - "inputTokens", - "outputTokens", - "reasoningOutputTokens", - "totalTokens" - ], - "properties": { - "cachedInputTokens": { - "type": "integer", - "format": "int64" - }, - "inputTokens": { - "type": "integer", - "format": "int64" - }, - "outputTokens": { - "type": "integer", - "format": "int64" - }, - "reasoningOutputTokens": { - "type": "integer", - "format": "int64" - }, - "totalTokens": { - "type": "integer", - "format": "int64" - } - } - } - } + "required": [ + "threadId", + "tokenUsage", + "turnId" + ], + "title": "ThreadTokenUsageUpdatedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadTurnsListParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadTurnsListParams.json index b5bcb923..ed58a454 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadTurnsListParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadTurnsListParams.json @@ -1,10 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadTurnsListParams", - "type": "object", - "required": [ - "threadId" - ], + "definitions": { + "SortDirection": { + "enum": [ + "asc", + "desc" + ], + "type": "string" + } + }, "properties": { "cursor": { "description": "Opaque cursor to pass to the next call to continue after the last turn.", @@ -15,15 +19,14 @@ }, "limit": { "description": "Optional turn page size.", + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "sortDirection": { - "description": "Optional turn pagination direction; defaults to descending.", "anyOf": [ { "$ref": "#/definitions/SortDirection" @@ -31,19 +34,16 @@ { "type": "null" } - ] + ], + "description": "Optional turn pagination direction; defaults to descending." }, "threadId": { "type": "string" } }, - "definitions": { - "SortDirection": { - "type": "string", - "enum": [ - "asc", - "desc" - ] - } - } + "required": [ + "threadId" + ], + "title": "ThreadTurnsListParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadTurnsListResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadTurnsListResponse.json index c688d197..cd4159b2 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadTurnsListResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadTurnsListResponse.json @@ -1,61 +1,33 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadTurnsListResponse", - "type": "object", - "required": [ - "data" - ], - "properties": { - "backwardsCursor": { - "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one turn. Use it with the opposite `sortDirection` to include the anchor turn again and catch updates to that turn.", - "type": [ - "string", - "null" - ] - }, - "data": { - "type": "array", - "items": { - "$ref": "#/definitions/Turn" - } - }, - "nextCursor": { - "description": "Opaque cursor to pass to the next call to continue after the last turn. if None, there are no more turns to return.", - "type": [ - "string", - "null" - ] - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -66,132 +38,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -202,10 +171,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -214,36 +186,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -255,21 +221,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -281,21 +249,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -313,114 +281,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -431,14 +398,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -446,80 +414,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -527,82 +493,85 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -611,20 +580,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -632,21 +604,18 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -655,77 +624,74 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -733,10 +699,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -744,29 +710,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -775,59 +742,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -842,34 +806,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -882,40 +846,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -924,34 +890,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -992,42 +956,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -1051,33 +1016,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -1098,7 +1061,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -1106,52 +1068,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -1170,22 +1137,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1194,23 +1161,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1238,22 +1204,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1262,22 +1229,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1286,63 +1253,62 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -1350,36 +1316,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -1401,94 +1370,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -1497,33 +1464,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -1532,27 +1501,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1561,13 +1530,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -1576,11 +1545,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1589,25 +1558,56 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "backwardsCursor": { + "description": "Opaque cursor to pass as `cursor` when reversing `sortDirection`. This is only populated when the page contains at least one turn. Use it with the opposite `sortDirection` to include the anchor turn again and catch updates to that turn.", + "type": [ + "string", + "null" + ] + }, + "data": { + "items": { + "$ref": "#/definitions/Turn" + }, + "type": "array" + }, + "nextCursor": { + "description": "Opaque cursor to pass to the next call to continue after the last turn. if None, there are no more turns to return.", + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "data" + ], + "title": "ThreadTurnsListResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveParams.json index d61b125f..fd62a96c 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveParams.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnarchiveParams", - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "title": "ThreadUnarchiveParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json index 1233af85..32a8f460 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json @@ -1,15 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnarchiveResponse", - "type": "object", - "required": [ - "thread" - ], - "properties": { - "thread": { - "$ref": "#/definitions/Thread" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", @@ -19,29 +9,28 @@ "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -52,132 +41,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -188,10 +174,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -200,36 +189,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -241,21 +224,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -267,21 +252,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -299,119 +284,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "EpiphanyAcceptanceReceipt": { - "type": "object", - "required": [ - "accepted_at", - "binding_id", - "id", - "job_id", - "result_id", - "role_id", - "status", - "surface" - ], "properties": { "accepted_at": { "type": "string" @@ -455,42 +434,41 @@ "surface": { "type": "string" } - } + }, + "required": [ + "accepted_at", + "binding_id", + "id", + "job_id", + "result_id", + "role_id", + "status", + "surface" + ], + "type": "object" }, "EpiphanyBacklogItem": { - "type": "object", - "required": [ - "confidence", - "horizon", - "id", - "kind", - "priority", - "product_area", - "status", - "summary", - "title" - ], "properties": { "acceptance_sketch": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "blockers": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": "string" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "duplicate_of": { "type": [ @@ -499,10 +477,10 @@ ] }, "evidence_refs": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "horizon": { "type": "string" @@ -514,10 +492,10 @@ "type": "string" }, "lane_hints": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -526,10 +504,10 @@ "type": "string" }, "source_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - } + }, + "type": "array" }, "status": { "type": "string" @@ -546,14 +524,21 @@ "null" ] } - } + }, + "required": [ + "confidence", + "horizon", + "id", + "kind", + "priority", + "product_area", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyChurnState": { - "type": "object", - "required": [ - "diff_pressure", - "understanding_status" - ], "properties": { "diff_pressure": { "type": "string" @@ -568,12 +553,12 @@ "type": "string" }, "unexplained_writes": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "warning": { "type": [ @@ -581,21 +566,22 @@ "null" ] } - } + }, + "required": [ + "diff_pressure", + "understanding_status" + ], + "type": "object" }, "EpiphanyCodeRef": { - "type": "object", - "required": [ - "path" - ], "properties": { "end_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "note": { "type": [ @@ -607,12 +593,12 @@ "type": "string" }, "start_line": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "symbol": { "type": [ @@ -620,22 +606,19 @@ "null" ] } - } + }, + "required": [ + "path" + ], + "type": "object" }, "EpiphanyEvidenceRecord": { - "type": "object", - "required": [ - "id", - "kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -649,57 +632,59 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyGraph": { - "type": "object", "properties": { "edges": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphEdge" - } + }, + "type": "array" }, "nodes": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphNode" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "graph_revision" - ], "properties": { "checkpoint_id": { "type": "string" }, "frontier_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "graph_revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -707,21 +692,20 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "graph_revision" + ], + "type": "object" }, "EpiphanyGraphEdge": { - "type": "object", - "required": [ - "kind", - "source_id", - "target_id" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": [ @@ -750,58 +734,59 @@ "target_id": { "type": "string" } - } + }, + "required": [ + "kind", + "source_id", + "target_id" + ], + "type": "object" }, "EpiphanyGraphFrontier": { - "type": "object", "properties": { "active_edge_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "active_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_gap_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "open_question_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyGraphLink": { - "type": "object", - "required": [ - "architecture_node_id", - "dataflow_node_id" - ], "properties": { "architecture_node_id": { "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "dataflow_node_id": { "type": "string" @@ -812,21 +797,20 @@ "null" ] } - } + }, + "required": [ + "architecture_node_id", + "dataflow_node_id" + ], + "type": "object" }, "EpiphanyGraphNode": { - "type": "object", - "required": [ - "id", - "purpose", - "title" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "id": { "type": "string" @@ -855,10 +839,15 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "title" + ], + "type": "object" }, "EpiphanyGraphs": { - "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -867,20 +856,15 @@ "$ref": "#/definitions/EpiphanyGraph" }, "links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyGraphLink" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyInvariant": { - "type": "object", - "required": [ - "description", - "id", - "status" - ], "properties": { "description": { "type": "string" @@ -897,16 +881,15 @@ "status": { "type": "string" } - } + }, + "required": [ + "description", + "id", + "status" + ], + "type": "object" }, "EpiphanyInvestigationCheckpoint": { - "type": "object", - "required": [ - "checkpoint_id", - "disposition", - "focus", - "kind" - ], "properties": { "captured_at_turn_id": { "type": [ @@ -918,19 +901,19 @@ "type": "string" }, "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "disposition": { "$ref": "#/definitions/EpiphanyInvestigationDisposition" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "focus": { "type": "string" @@ -945,10 +928,10 @@ ] }, "open_questions": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -956,23 +939,23 @@ "null" ] } - } + }, + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], + "type": "object" }, "EpiphanyInvestigationDisposition": { - "type": "string", "enum": [ "resume_ready", "regather_required" - ] + ], + "type": "string" }, "EpiphanyJobBinding": { - "type": "object", - "required": [ - "id", - "kind", - "owner_role", - "scope" - ], "properties": { "authority_scope": { "type": [ @@ -993,16 +976,16 @@ "$ref": "#/definitions/EpiphanyJobKind" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "owner_role": { "type": "string" @@ -1010,29 +993,32 @@ "scope": { "type": "string" } - } + }, + "required": [ + "id", + "kind", + "owner_role", + "scope" + ], + "type": "object" }, "EpiphanyJobKind": { - "type": "string", "enum": [ "indexing", "remap", "verification", "specialist" - ] + ], + "type": "string" }, "EpiphanyModeKind": { - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "EpiphanyModeState": { - "type": "object", - "required": [ - "name" - ], "properties": { "kind": { "anyOf": [ @@ -1047,36 +1033,31 @@ "name": { "type": "string" } - } + }, + "required": [ + "name" + ], + "type": "object" }, "EpiphanyObjectiveDraft": { - "type": "object", - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], "properties": { "acceptance_criteria": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "dependencies": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "evidence_required": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1085,25 +1066,25 @@ "$ref": "#/definitions/EpiphanyObjectiveDraftLanePlan" }, "review_gates": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "risks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "scope": { "$ref": "#/definitions/EpiphanyObjectiveDraftScope" }, "source_item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "status": { "type": "string" @@ -1114,10 +1095,18 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "lane_plan", + "scope", + "status", + "summary", + "title" + ], + "type": "object" }, "EpiphanyObjectiveDraftLanePlan": { - "type": "object", "properties": { "body": { "type": [ @@ -1155,45 +1144,39 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyObjectiveDraftScope": { - "type": "object", "properties": { "excludes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "includes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "type": "object" }, "EpiphanyObservation": { - "type": "object", - "required": [ - "id", - "source_kind", - "status", - "summary" - ], "properties": { "code_refs": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - } + }, + "type": "array" }, "evidence_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" @@ -1207,17 +1190,16 @@ "summary": { "type": "string" } - } + }, + "required": [ + "id", + "source_kind", + "status", + "summary" + ], + "type": "object" }, "EpiphanyPlanningCapture": { - "type": "object", - "required": [ - "confidence", - "id", - "source", - "status", - "title" - ], "properties": { "body": { "type": [ @@ -1250,10 +1232,10 @@ "type": "string" }, "tags": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "title": { "type": "string" @@ -1264,20 +1246,23 @@ "null" ] } - } + }, + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], + "type": "object" }, "EpiphanyPlanningPriority": { - "type": "object", - "required": [ - "rationale", - "value" - ], "properties": { "blocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "confidence": { "type": [ @@ -1307,10 +1292,10 @@ ] }, "unblocks": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "urgency": { "type": [ @@ -1321,19 +1306,20 @@ "value": { "type": "string" } - } + }, + "required": [ + "rationale", + "value" + ], + "type": "object" }, "EpiphanyPlanningSourceRef": { - "type": "object", - "required": [ - "kind" - ], "properties": { "assignees": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "author": { "type": [ @@ -1354,11 +1340,11 @@ ] }, "database_id": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "external_id": { "type": [ @@ -1379,21 +1365,21 @@ ] }, "issue_number": { + "format": "uint64", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint64", - "minimum": 0.0 + ] }, "kind": { "type": "string" }, "labels": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "milestone": { "type": [ @@ -1443,34 +1429,37 @@ "null" ] } - } + }, + "required": [ + "kind" + ], + "type": "object" }, "EpiphanyPlanningState": { - "type": "object", "properties": { "backlog_items": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyBacklogItem" - } + }, + "type": "array" }, "captures": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningCapture" - } + }, + "type": "array" }, "objective_drafts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObjectiveDraft" - } + }, + "type": "array" }, "roadmap_streams": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRoadmapStream" - } + }, + "type": "array" }, "workspace_root": { "type": [ @@ -1478,33 +1467,29 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanyRetrievalShardSummary": { - "type": "object", - "required": [ - "path_prefix", - "shard_id" - ], "properties": { "exact_available": { "type": "boolean" }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "path_prefix": { "type": "string" @@ -1516,26 +1501,27 @@ "type": "string" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" } - } + }, + "required": [ + "path_prefix", + "shard_id" + ], + "type": "object" }, "EpiphanyRetrievalState": { - "type": "object", - "required": [ - "workspace_root" - ], "properties": { "dirty_paths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "index_revision": { "type": [ @@ -1544,82 +1530,79 @@ ] }, "indexed_chunk_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "indexed_file_count": { + "format": "uint32", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint32", - "minimum": 0.0 + ] }, "last_indexed_at_unix_seconds": { + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "semantic_available": { "type": "boolean" }, "shards": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRetrievalShardSummary" - } + }, + "type": "array" }, "status": { - "default": "unavailable", "allOf": [ { "$ref": "#/definitions/EpiphanyRetrievalStatus" } - ] + ], + "default": "unavailable" }, "workspace_root": { "type": "string" } - } + }, + "required": [ + "workspace_root" + ], + "type": "object" }, "EpiphanyRetrievalStatus": { - "type": "string", "enum": [ "unavailable", "ready", "stale", "indexing" - ] + ], + "type": "string" }, "EpiphanyRoadmapStream": { - "type": "object", - "required": [ - "id", - "purpose", - "status", - "title" - ], "properties": { "blocked_by": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "item_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "near_term_focus": { "type": [ @@ -1642,18 +1625,16 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "purpose", + "status", + "title" + ], + "type": "object" }, "EpiphanyRuntimeLink": { - "type": "object", - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], "properties": { "authority_scope": { "type": "string" @@ -1665,16 +1646,16 @@ "type": "string" }, "linked_graph_node_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "linked_subgoal_ids": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "role_id": { "type": "string" @@ -1691,10 +1672,18 @@ "surface": { "type": "string" } - } + }, + "required": [ + "authority_scope", + "binding_id", + "id", + "role_id", + "runtime_job_id", + "surface" + ], + "type": "object" }, "EpiphanyScratchPad": { - "type": "object", "properties": { "hypothesis": { "type": [ @@ -1709,10 +1698,10 @@ ] }, "notes": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "summary": { "type": [ @@ -1720,15 +1709,10 @@ "null" ] } - } + }, + "type": "object" }, "EpiphanySubgoal": { - "type": "object", - "required": [ - "id", - "status", - "title" - ], "properties": { "id": { "type": "string" @@ -1745,19 +1729,21 @@ "title": { "type": "string" } - } + }, + "required": [ + "id", + "status", + "title" + ], + "type": "object" }, "EpiphanyThreadState": { - "type": "object", - "required": [ - "revision" - ], "properties": { "acceptance_receipts": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - } + }, + "type": "array" }, "active_subgoal_id": { "type": [ @@ -1799,10 +1785,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - } + }, + "type": "array" }, "investigation_checkpoint": { "anyOf": [ @@ -1815,10 +1801,10 @@ ] }, "job_bindings": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - } + }, + "type": "array" }, "last_updated_turn_id": { "type": [ @@ -1843,19 +1829,19 @@ ] }, "observations": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - } + }, + "type": "array" }, "planning": { "$ref": "#/definitions/EpiphanyPlanningState" }, "recent_evidence": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - } + }, + "type": "array" }, "retrieval": { "anyOf": [ @@ -1868,15 +1854,15 @@ ] }, "revision": { - "type": "integer", "format": "uint64", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "runtime_links": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - } + }, + "type": "array" }, "scratch": { "anyOf": [ @@ -1889,20 +1875,18 @@ ] }, "subgoals": { - "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - } + }, + "type": "array" } - } + }, + "required": [ + "revision" + ], + "type": "object" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -1913,10 +1897,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "GitInfo": { - "type": "object", "properties": { "branch": { "type": [ @@ -1936,14 +1925,10 @@ "null" ] } - } + }, + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -1951,80 +1936,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -2032,82 +2015,85 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -2116,20 +2102,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -2137,70 +2126,63 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "SessionSource": { "oneOf": [ { - "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "custom" - ], + "additionalProperties": false, "properties": { "custom": { "type": "string" } }, - "additionalProperties": false, - "title": "CustomSessionSource" + "required": [ + "custom" + ], + "title": "CustomSessionSource", + "type": "object" }, { - "type": "object", - "required": [ - "subAgent" - ], + "additionalProperties": false, "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "additionalProperties": false, - "title": "SubAgentSessionSource" + "required": [ + "subAgent" + ], + "title": "SubAgentSessionSource", + "type": "object" } ] }, "SubAgentSource": { "oneOf": [ { - "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "thread_spawn" - ], + "additionalProperties": false, "properties": { "thread_spawn": { - "type": "object", - "required": [ - "depth", - "parent_thread_id" - ], "properties": { "agent_nickname": { "default": null, @@ -2210,7 +2192,6 @@ ] }, "agent_path": { - "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2218,7 +2199,8 @@ { "type": "null" } - ] + ], + "default": null }, "agent_role": { "default": null, @@ -2228,46 +2210,50 @@ ] }, "depth": { - "type": "integer", - "format": "int32" + "format": "int32", + "type": "integer" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - } + }, + "required": [ + "depth", + "parent_thread_id" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ThreadSpawnSubAgentSource" + "required": [ + "thread_spawn" + ], + "title": "ThreadSpawnSubAgentSource", + "type": "object" }, { - "type": "object", - "required": [ - "other" - ], + "additionalProperties": false, "properties": { "other": { "type": "string" } }, - "additionalProperties": false, - "title": "OtherSubAgentSource" + "required": [ + "other" + ], + "title": "OtherSubAgentSource", + "type": "object" } ] }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -2276,23 +2262,13 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "Thread": { - "type": "object", - "required": [ - "cliVersion", - "createdAt", - "cwd", - "ephemeral", - "id", - "modelProvider", - "preview", - "source", - "status", - "turns", - "updatedAt" - ], "properties": { "agentNickname": { "description": "Optional random unique nickname assigned to an AgentControl-spawned sub-agent.", @@ -2314,23 +2290,22 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" }, "cwd": { - "description": "Working directory captured for the thread.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "Working directory captured for the thread." }, "ephemeral": { "description": "Whether the thread is ephemeral and should not be materialized on disk.", "type": "boolean" }, "epiphanyState": { - "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads.", "anyOf": [ { "$ref": "#/definitions/EpiphanyThreadState" @@ -2338,7 +2313,8 @@ { "type": "null" } - ] + ], + "description": "Only populated on `thread/start`, `thread/resume`, `thread/fork`, `thread/read`, and notifications/responses that reuse those hydrated thread payloads." }, "forkedFromId": { "description": "Source thread id when this thread was created by forking another thread.", @@ -2348,7 +2324,6 @@ ] }, "gitInfo": { - "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2356,7 +2331,8 @@ { "type": "null" } - ] + ], + "description": "Optional Git metadata captured when the thread was created." }, "id": { "type": "string" @@ -2384,41 +2360,55 @@ "type": "string" }, "source": { - "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).", "allOf": [ { "$ref": "#/definitions/SessionSource" } - ] + ], + "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)." }, "status": { - "description": "Current runtime status for the thread.", "allOf": [ { "$ref": "#/definitions/ThreadStatus" } - ] + ], + "description": "Current runtime status for the thread." }, "turns": { "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/Turn" - } + }, + "type": "array" }, "updatedAt": { "description": "Unix timestamp (in seconds) when the thread was last updated.", - "type": "integer", - "format": "int64" + "format": "int64", + "type": "integer" } - } + }, + "required": [ + "cliVersion", + "createdAt", + "cwd", + "ephemeral", + "id", + "modelProvider", + "preview", + "source", + "status", + "turns", + "updatedAt" + ], + "type": "object" }, "ThreadActiveFlag": { - "type": "string", "enum": [ "waitingOnApproval", "waitingOnUserInput" - ] + ], + "type": "string" }, "ThreadId": { "type": "string" @@ -2426,72 +2416,65 @@ "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -2499,10 +2482,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -2510,29 +2493,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -2541,59 +2525,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -2608,34 +2589,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -2648,40 +2629,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -2690,34 +2673,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -2758,42 +2739,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -2817,33 +2799,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -2864,7 +2844,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -2872,52 +2851,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -2936,22 +2920,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -2960,23 +2944,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3004,22 +2987,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3028,22 +3012,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -3052,138 +3036,137 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "ThreadStatus": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType" + "title": "NotLoadedThreadStatusType", + "type": "string" } }, - "title": "NotLoadedThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "NotLoadedThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType" + "title": "IdleThreadStatusType", + "type": "string" } }, - "title": "IdleThreadStatus" - }, - { - "type": "object", "required": [ "type" ], + "title": "IdleThreadStatus", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType" + "title": "SystemErrorThreadStatusType", + "type": "string" } }, - "title": "SystemErrorThreadStatus" + "required": [ + "type" + ], + "title": "SystemErrorThreadStatus", + "type": "object" }, { - "type": "object", + "properties": { + "activeFlags": { + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + }, + "type": "array" + }, + "type": { + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType", + "type": "string" + } + }, "required": [ "activeFlags", "type" ], - "properties": { - "activeFlags": { - "type": "array", - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - } - }, - "type": { - "type": "string", - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType" - } - }, - "title": "ActiveThreadStatus" + "title": "ActiveThreadStatus", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -3191,36 +3174,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -3242,94 +3228,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -3338,33 +3322,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -3373,27 +3359,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3402,13 +3388,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -3417,11 +3403,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -3430,25 +3416,39 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "thread": { + "$ref": "#/definitions/Thread" + } + }, + "required": [ + "thread" + ], + "title": "ThreadUnarchiveResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchivedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchivedNotification.json index b19eb288..7e4bcd56 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchivedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchivedNotification.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnarchivedNotification", - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "title": "ThreadUnarchivedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnsubscribeParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnsubscribeParams.json index ddb31219..dec3670c 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnsubscribeParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnsubscribeParams.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnsubscribeParams", - "type": "object", - "required": [ - "threadId" - ], "properties": { "threadId": { "type": "string" } - } + }, + "required": [ + "threadId" + ], + "title": "ThreadUnsubscribeParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnsubscribeResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnsubscribeResponse.json index ade0e65e..2e545dbf 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnsubscribeResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/ThreadUnsubscribeResponse.json @@ -1,23 +1,23 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "ThreadUnsubscribeResponse", - "type": "object", - "required": [ - "status" - ], + "definitions": { + "ThreadUnsubscribeStatus": { + "enum": [ + "notLoaded", + "notSubscribed", + "unsubscribed" + ], + "type": "string" + } + }, "properties": { "status": { "$ref": "#/definitions/ThreadUnsubscribeStatus" } }, - "definitions": { - "ThreadUnsubscribeStatus": { - "type": "string", - "enum": [ - "notLoaded", - "notSubscribed", - "unsubscribed" - ] - } - } + "required": [ + "status" + ], + "title": "ThreadUnsubscribeResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json index e19ccb94..99395c3a 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json @@ -1,48 +1,33 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnCompletedNotification", - "type": "object", - "required": [ - "threadId", - "turn" - ], - "properties": { - "threadId": { - "type": "string" - }, - "turn": { - "$ref": "#/definitions/Turn" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -53,132 +38,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -189,10 +171,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -201,36 +186,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -242,21 +221,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -268,21 +249,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -300,114 +281,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -418,14 +398,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -433,80 +414,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -514,82 +493,85 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -598,20 +580,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -619,21 +604,18 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -642,77 +624,74 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -720,10 +699,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -731,29 +710,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -762,59 +742,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -829,34 +806,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -869,40 +846,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -911,34 +890,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -979,42 +956,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -1038,33 +1016,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -1085,7 +1061,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -1093,52 +1068,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -1157,22 +1137,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1181,23 +1161,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1225,22 +1204,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1249,22 +1229,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1273,63 +1253,62 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -1337,36 +1316,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -1388,94 +1370,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -1484,33 +1464,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -1519,27 +1501,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1548,13 +1530,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -1563,11 +1545,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1576,25 +1558,43 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "threadId": { + "type": "string" + }, + "turn": { + "$ref": "#/definitions/Turn" + } + }, + "required": [ + "threadId", + "turn" + ], + "title": "TurnCompletedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnDiffUpdatedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnDiffUpdatedNotification.json index e4394765..b694ce25 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnDiffUpdatedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnDiffUpdatedNotification.json @@ -1,13 +1,6 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnDiffUpdatedNotification", "description": "Notification that the turn-level unified diff has changed. Contains the latest aggregated diff across all file changes in the turn.", - "type": "object", - "required": [ - "diff", - "threadId", - "turnId" - ], "properties": { "diff": { "type": "string" @@ -18,5 +11,12 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "diff", + "threadId", + "turnId" + ], + "title": "TurnDiffUpdatedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnInterruptParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnInterruptParams.json index f38a75ea..9181428a 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnInterruptParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnInterruptParams.json @@ -1,11 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnInterruptParams", - "type": "object", - "required": [ - "threadId", - "turnId" - ], "properties": { "threadId": { "type": "string" @@ -13,5 +7,11 @@ "turnId": { "type": "string" } - } + }, + "required": [ + "threadId", + "turnId" + ], + "title": "TurnInterruptParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnPlanUpdatedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnPlanUpdatedNotification.json index 0f835387..5a28ffbf 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnPlanUpdatedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnPlanUpdatedNotification.json @@ -1,12 +1,30 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnPlanUpdatedNotification", - "type": "object", - "required": [ - "plan", - "threadId", - "turnId" - ], + "definitions": { + "TurnPlanStep": { + "properties": { + "status": { + "$ref": "#/definitions/TurnPlanStepStatus" + }, + "step": { + "type": "string" + } + }, + "required": [ + "status", + "step" + ], + "type": "object" + }, + "TurnPlanStepStatus": { + "enum": [ + "pending", + "inProgress", + "completed" + ], + "type": "string" + } + }, "properties": { "explanation": { "type": [ @@ -15,10 +33,10 @@ ] }, "plan": { - "type": "array", "items": { "$ref": "#/definitions/TurnPlanStep" - } + }, + "type": "array" }, "threadId": { "type": "string" @@ -27,29 +45,11 @@ "type": "string" } }, - "definitions": { - "TurnPlanStep": { - "type": "object", - "required": [ - "status", - "step" - ], - "properties": { - "status": { - "$ref": "#/definitions/TurnPlanStepStatus" - }, - "step": { - "type": "string" - } - } - }, - "TurnPlanStepStatus": { - "type": "string", - "enum": [ - "pending", - "inProgress", - "completed" - ] - } - } + "required": [ + "plan", + "threadId", + "turnId" + ], + "title": "TurnPlanUpdatedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnStartParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnStartParams.json index 145e5819..b2b8934f 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnStartParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnStartParams.json @@ -1,134 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnStartParams", - "type": "object", - "required": [ - "input", - "threadId" - ], - "properties": { - "approvalPolicy": { - "description": "Override the approval policy for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/AskForApproval" - }, - { - "type": "null" - } - ] - }, - "approvalsReviewer": { - "description": "Override where approval requests are routed for review on this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ApprovalsReviewer" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - }, - "cwd": { - "description": "Override the working directory for this turn and subsequent turns.", - "type": [ - "string", - "null" - ] - }, - "effort": { - "description": "Override the reasoning effort for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ReasoningEffort" - }, - { - "type": "null" - } - ] - }, - "summary": { - "description": "Override the reasoning summary for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/ReasoningSummary" - }, - { - "type": "null" - } - ] - }, - "input": { - "type": "array", - "items": { - "$ref": "#/definitions/UserInput" - } - }, - "model": { - "description": "Override the model for this turn and subsequent turns.", - "type": [ - "string", - "null" - ] - }, - "outputSchema": { - "description": "Optional JSON Schema used to constrain the final assistant message for this turn." - }, - "permissionProfile": { - "description": "Override the full permissions profile for this turn and subsequent turns. Cannot be combined with `sandboxPolicy`.", - "anyOf": [ - { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ] - }, - "personality": { - "description": "Override the personality for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/Personality" - }, - { - "type": "null" - } - ] - }, - "serviceTier": { - "description": "Override the service tier for this turn and subsequent turns.", - "anyOf": [ - { - "anyOf": [ - { - "$ref": "#/definitions/ServiceTier" - }, - { - "type": "null" - } - ] - }, - { - "type": "null" - } - ] - }, - "sandboxPolicy": { - "description": "Override the sandbox policy for this turn and subsequent turns.", - "anyOf": [ - { - "$ref": "#/definitions/SandboxPolicy" - }, - { - "type": "null" - } - ] - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", @@ -136,37 +7,28 @@ }, "ApprovalsReviewer": { "description": "Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to `user`. `auto_review` uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denying the request. The legacy value `guardian_subagent` is accepted for compatibility.", - "type": "string", "enum": [ "user", "auto_review", "guardian_subagent" - ] + ], + "type": "string" }, "AskForApproval": { "oneOf": [ { - "type": "string", "enum": [ "untrusted", "on-failure", "on-request", "never" - ] + ], + "type": "string" }, { - "type": "object", - "required": [ - "granular" - ], + "additionalProperties": false, "properties": { "granular": { - "type": "object", - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -181,40 +43,44 @@ "sandbox_approval": { "type": "boolean" } - } + }, + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "GranularAskForApproval" + "required": [ + "granular" + ], + "title": "GranularAskForApproval", + "type": "object" } ] }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CollaborationMode": { "description": "Collaboration mode for a Codex session.", - "type": "object", - "required": [ - "mode", - "settings" - ], "properties": { "mode": { "$ref": "#/definitions/ModeKind" @@ -222,86 +88,86 @@ "settings": { "$ref": "#/definitions/Settings" } - } + }, + "required": [ + "mode", + "settings" + ], + "type": "object" }, "FileSystemAccessMode": { - "type": "string", "enum": [ "read", "write", "none" - ] + ], + "type": "string" }, "FileSystemPath": { "oneOf": [ { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "path" ], - "title": "PathFileSystemPathType" + "title": "PathFileSystemPathType", + "type": "string" } }, - "title": "PathFileSystemPath" - }, - { - "type": "object", "required": [ - "pattern", + "path", "type" ], + "title": "PathFileSystemPath", + "type": "object" + }, + { "properties": { "pattern": { "type": "string" }, "type": { - "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType" + "title": "GlobPatternFileSystemPathType", + "type": "string" } }, - "title": "GlobPatternFileSystemPath" + "required": [ + "pattern", + "type" + ], + "title": "GlobPatternFileSystemPath", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "value" - ], "properties": { "type": { - "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType" + "title": "SpecialFileSystemPathType", + "type": "string" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "title": "SpecialFileSystemPath" + "required": [ + "type", + "value" + ], + "title": "SpecialFileSystemPath", + "type": "object" } ] }, "FileSystemSandboxEntry": { - "type": "object", - "required": [ - "access", - "path" - ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -309,66 +175,67 @@ "path": { "$ref": "#/definitions/FileSystemPath" } - } + }, + "required": [ + "access", + "path" + ], + "type": "object" }, "FileSystemSpecialPath": { "oneOf": [ { - "type": "object", - "required": [ - "kind" - ], "properties": { "kind": { - "type": "string", "enum": [ "root" - ] + ], + "type": "string" } }, - "title": "RootFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "RootFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "minimal" - ] + ], + "type": "string" } }, - "title": "MinimalFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "MinimalFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "current_working_directory" - ] + ], + "type": "string" } }, - "title": "CurrentWorkingDirectoryFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "CurrentWorkingDirectoryFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "project_roots" - ] + ], + "type": "string" }, "subpath": { "type": [ @@ -377,50 +244,49 @@ ] } }, - "title": "KindFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], + "title": "KindFileSystemSpecialPath", + "type": "object" + }, + { "properties": { "kind": { - "type": "string", "enum": [ "tmpdir" - ] + ], + "type": "string" } }, - "title": "TmpdirFileSystemSpecialPath" - }, - { - "type": "object", "required": [ "kind" ], - "properties": { - "kind": { - "type": "string", - "enum": [ - "slash_tmp" - ] - } - }, - "title": "SlashTmpFileSystemSpecialPath" + "title": "TmpdirFileSystemSpecialPath", + "type": "object" + }, + { + "properties": { + "kind": { + "enum": [ + "slash_tmp" + ], + "type": "string" + } + }, + "required": [ + "kind" + ], + "title": "SlashTmpFileSystemSpecialPath", + "type": "object" }, { - "type": "object", - "required": [ - "kind", - "path" - ], "properties": { "kind": { - "type": "string", "enum": [ "unknown" - ] + ], + "type": "string" }, "path": { "type": "string" @@ -431,27 +297,31 @@ "null" ] } - } + }, + "required": [ + "kind", + "path" + ], + "type": "object" } ] }, "ModeKind": { "description": "Initial collaboration mode to use when the TUI starts.", - "type": "string", "enum": [ "plan", "default" - ] + ], + "type": "string" }, "NetworkAccess": { - "type": "string", "enum": [ "restricted", "enabled" - ] + ], + "type": "string" }, "PermissionProfile": { - "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -473,32 +343,32 @@ } ] } - } + }, + "type": "object" }, "PermissionProfileFileSystemPermissions": { - "type": "object", - "required": [ - "entries" - ], "properties": { "entries": { - "type": "array", "items": { "$ref": "#/definitions/FileSystemSandboxEntry" - } + }, + "type": "array" }, "globScanMaxDepth": { + "format": "uint", + "minimum": 1.0, "type": [ "integer", "null" - ], - "format": "uint", - "minimum": 1.0 + ] } - } + }, + "required": [ + "entries" + ], + "type": "object" }, "PermissionProfileNetworkPermissions": { - "type": "object", "properties": { "enabled": { "type": [ @@ -506,23 +376,20 @@ "null" ] } - } + }, + "type": "object" }, "Personality": { - "type": "string", "enum": [ "none", "friendly", "pragmatic" - ] + ], + "type": "string" }, "ReadOnlyAccess": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "includePlatformDefaults": { "default": true, @@ -530,42 +397,45 @@ }, "readableRoots": { "default": [], - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "restricted" ], - "title": "RestrictedReadOnlyAccessType" + "title": "RestrictedReadOnlyAccessType", + "type": "string" } }, - "title": "RestrictedReadOnlyAccess" - }, - { - "type": "object", "required": [ "type" ], + "title": "RestrictedReadOnlyAccess", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "fullAccess" ], - "title": "FullAccessReadOnlyAccessType" + "title": "FullAccessReadOnlyAccessType", + "type": "string" } }, - "title": "FullAccessReadOnlyAccess" + "required": [ + "type" + ], + "title": "FullAccessReadOnlyAccess", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -573,105 +443,102 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "ReasoningSummary": { "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries", "oneOf": [ { - "type": "string", "enum": [ "auto", "concise", "detailed" - ] + ], + "type": "string" }, { "description": "Option to disable reasoning summaries.", - "type": "string", "enum": [ "none" - ] + ], + "type": "string" } ] }, "SandboxPolicy": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "dangerFullAccess" ], - "title": "DangerFullAccessSandboxPolicyType" + "title": "DangerFullAccessSandboxPolicyType", + "type": "string" } }, - "title": "DangerFullAccessSandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "DangerFullAccessSandboxPolicy", + "type": "object" + }, + { "properties": { "access": { - "default": { - "type": "fullAccess" - }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ] + ], + "default": { + "type": "fullAccess" + } }, "networkAccess": { "default": false, "type": "boolean" }, "type": { - "type": "string", "enum": [ "readOnly" ], - "title": "ReadOnlySandboxPolicyType" + "title": "ReadOnlySandboxPolicyType", + "type": "string" } }, - "title": "ReadOnlySandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "ReadOnlySandboxPolicy", + "type": "object" + }, + { "properties": { "networkAccess": { - "default": "restricted", "allOf": [ { "$ref": "#/definitions/NetworkAccess" } - ] + ], + "default": "restricted" }, "type": { - "type": "string", "enum": [ "externalSandbox" ], - "title": "ExternalSandboxSandboxPolicyType" + "title": "ExternalSandboxSandboxPolicyType", + "type": "string" } }, - "title": "ExternalSandboxSandboxPolicy" - }, - { - "type": "object", "required": [ "type" ], + "title": "ExternalSandboxSandboxPolicy", + "type": "object" + }, + { "properties": { "excludeSlashTmp": { "default": false, @@ -686,47 +553,47 @@ "type": "boolean" }, "readOnlyAccess": { - "default": { - "type": "fullAccess" - }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ] + ], + "default": { + "type": "fullAccess" + } }, "type": { - "type": "string", "enum": [ "workspaceWrite" ], - "title": "WorkspaceWriteSandboxPolicyType" + "title": "WorkspaceWriteSandboxPolicyType", + "type": "string" }, "writableRoots": { "default": [], - "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - } + }, + "type": "array" } }, - "title": "WorkspaceWriteSandboxPolicy" + "required": [ + "type" + ], + "title": "WorkspaceWriteSandboxPolicy", + "type": "object" } ] }, "ServiceTier": { - "type": "string", "enum": [ "fast", "flex" - ] + ], + "type": "string" }, "Settings": { "description": "Settings for a collaboration mode.", - "type": "object", - "required": [ - "model" - ], "properties": { "developer_instructions": { "type": [ @@ -747,21 +614,21 @@ } ] } - } + }, + "required": [ + "model" + ], + "type": "object" }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -770,14 +637,13 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "TurnEnvironmentParams": { - "type": "object", - "required": [ - "cwd", - "environmentId" - ], "properties": { "cwd": { "$ref": "#/definitions/AbsolutePathBuf" @@ -785,85 +651,84 @@ "environmentId": { "type": "string" } - } + }, + "required": [ + "cwd", + "environmentId" + ], + "type": "object" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -872,16 +737,151 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] } - } + }, + "properties": { + "approvalPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/AskForApproval" + }, + { + "type": "null" + } + ], + "description": "Override the approval policy for this turn and subsequent turns." + }, + "approvalsReviewer": { + "anyOf": [ + { + "$ref": "#/definitions/ApprovalsReviewer" + }, + { + "type": "null" + } + ], + "description": "Override where approval requests are routed for review on this turn and subsequent turns." + }, + "cwd": { + "description": "Override the working directory for this turn and subsequent turns.", + "type": [ + "string", + "null" + ] + }, + "effort": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningEffort" + }, + { + "type": "null" + } + ], + "description": "Override the reasoning effort for this turn and subsequent turns." + }, + "input": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "model": { + "description": "Override the model for this turn and subsequent turns.", + "type": [ + "string", + "null" + ] + }, + "outputSchema": { + "description": "Optional JSON Schema used to constrain the final assistant message for this turn." + }, + "permissionProfile": { + "anyOf": [ + { + "$ref": "#/definitions/PermissionProfile" + }, + { + "type": "null" + } + ], + "description": "Override the full permissions profile for this turn and subsequent turns. Cannot be combined with `sandboxPolicy`." + }, + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/Personality" + }, + { + "type": "null" + } + ], + "description": "Override the personality for this turn and subsequent turns." + }, + "sandboxPolicy": { + "anyOf": [ + { + "$ref": "#/definitions/SandboxPolicy" + }, + { + "type": "null" + } + ], + "description": "Override the sandbox policy for this turn and subsequent turns." + }, + "serviceTier": { + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "type": "null" + } + ], + "description": "Override the service tier for this turn and subsequent turns." + }, + "summary": { + "anyOf": [ + { + "$ref": "#/definitions/ReasoningSummary" + }, + { + "type": "null" + } + ], + "description": "Override the reasoning summary for this turn and subsequent turns." + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "input", + "threadId" + ], + "title": "TurnStartParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json index 79d07dab..752fe7fa 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json @@ -1,44 +1,33 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnStartResponse", - "type": "object", - "required": [ - "turn" - ], - "properties": { - "turn": { - "$ref": "#/definitions/Turn" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -49,132 +38,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -185,10 +171,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -197,36 +186,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -238,21 +221,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -264,21 +249,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -296,114 +281,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -414,14 +398,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -429,80 +414,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -510,82 +493,85 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -594,20 +580,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -615,21 +604,18 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -638,77 +624,74 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -716,10 +699,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -727,29 +710,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -758,59 +742,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -825,34 +806,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -865,40 +846,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -907,34 +890,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -975,42 +956,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -1034,33 +1016,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -1081,7 +1061,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -1089,52 +1068,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -1153,22 +1137,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1177,23 +1161,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1221,22 +1204,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1245,22 +1229,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1269,63 +1253,62 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -1333,36 +1316,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -1384,94 +1370,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -1480,33 +1464,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -1515,27 +1501,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1544,13 +1530,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -1559,11 +1545,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1572,25 +1558,39 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "turn": { + "$ref": "#/definitions/Turn" + } + }, + "required": [ + "turn" + ], + "title": "TurnStartResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json index d50ce258..84eccfc2 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json @@ -1,48 +1,33 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnStartedNotification", - "type": "object", - "required": [ - "threadId", - "turn" - ], - "properties": { - "threadId": { - "type": "string" - }, - "turn": { - "$ref": "#/definitions/Turn" - } - }, "definitions": { "AbsolutePathBuf": { "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", "type": "string" }, "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "CodexErrorInfo": { "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.", "oneOf": [ { - "type": "string", "enum": [ "contextWindowExceeded", "usageLimitExceeded", @@ -53,132 +38,129 @@ "threadRollbackFailed", "sandboxError", "other" - ] + ], + "type": "string" }, { - "type": "object", + "additionalProperties": false, + "properties": { + "httpConnectionFailed": { + "properties": { + "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, + "type": [ + "integer", + "null" + ] + } + }, + "type": "object" + } + }, "required": [ "httpConnectionFailed" ], + "title": "HttpConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Failed to connect to the response SSE stream.", "properties": { - "httpConnectionFailed": { - "type": "object", + "responseStreamConnectionFailed": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "HttpConnectionFailedCodexErrorInfo" - }, - { - "description": "Failed to connect to the response SSE stream.", - "type": "object", "required": [ "responseStreamConnectionFailed" ], + "title": "ResponseStreamConnectionFailedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "The response SSE stream disconnected in the middle of a turn before completion.", "properties": { - "responseStreamConnectionFailed": { - "type": "object", + "responseStreamDisconnected": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamConnectionFailedCodexErrorInfo" - }, - { - "description": "The response SSE stream disconnected in the middle of a turn before completion.", - "type": "object", "required": [ "responseStreamDisconnected" ], + "title": "ResponseStreamDisconnectedCodexErrorInfo", + "type": "object" + }, + { + "additionalProperties": false, + "description": "Reached the retry limit for responses.", "properties": { - "responseStreamDisconnected": { - "type": "object", + "responseTooManyFailedAttempts": { "properties": { "httpStatusCode": { + "format": "uint16", + "minimum": 0.0, "type": [ "integer", "null" - ], - "format": "uint16", - "minimum": 0.0 + ] } - } + }, + "type": "object" } }, - "additionalProperties": false, - "title": "ResponseStreamDisconnectedCodexErrorInfo" - }, - { - "description": "Reached the retry limit for responses.", - "type": "object", "required": [ "responseTooManyFailedAttempts" ], - "properties": { - "responseTooManyFailedAttempts": { - "type": "object", - "properties": { - "httpStatusCode": { - "type": [ - "integer", - "null" - ], - "format": "uint16", - "minimum": 0.0 - } - } - } - }, - "additionalProperties": false, - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", + "type": "object" }, { + "additionalProperties": false, "description": "Returned when `turn/start` or `turn/steer` is submitted while the current active turn cannot accept same-turn steering, for example `/review` or manual `/compact`.", - "type": "object", - "required": [ - "activeTurnNotSteerable" - ], "properties": { "activeTurnNotSteerable": { - "type": "object", - "required": [ - "turnKind" - ], "properties": { "turnKind": { "$ref": "#/definitions/NonSteerableTurnKind" } - } + }, + "required": [ + "turnKind" + ], + "type": "object" } }, - "additionalProperties": false, - "title": "ActiveTurnNotSteerableCodexErrorInfo" + "required": [ + "activeTurnNotSteerable" + ], + "title": "ActiveTurnNotSteerableCodexErrorInfo", + "type": "object" } ] }, "CollabAgentState": { - "type": "object", - "required": [ - "status" - ], "properties": { "message": { "type": [ @@ -189,10 +171,13 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - } + }, + "required": [ + "status" + ], + "type": "object" }, "CollabAgentStatus": { - "type": "string", "enum": [ "pendingInit", "running", @@ -201,36 +186,30 @@ "errored", "shutdown", "notFound" - ] + ], + "type": "string" }, "CollabAgentTool": { - "type": "string", "enum": [ "spawnAgent", "sendInput", "resumeAgent", "wait", "closeAgent" - ] + ], + "type": "string" }, "CollabAgentToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "CommandAction": { "oneOf": [ { - "type": "object", - "required": [ - "command", - "name", - "path", - "type" - ], "properties": { "command": { "type": "string" @@ -242,21 +221,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType" + "title": "ReadCommandActionType", + "type": "string" } }, - "title": "ReadCommandAction" - }, - { - "type": "object", "required": [ "command", + "name", + "path", "type" ], + "title": "ReadCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -268,21 +249,21 @@ ] }, "type": { - "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType" + "title": "ListFilesCommandActionType", + "type": "string" } }, - "title": "ListFilesCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "ListFilesCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" @@ -300,114 +281,113 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType" + "title": "SearchCommandActionType", + "type": "string" } }, - "title": "SearchCommandAction" - }, - { - "type": "object", "required": [ "command", "type" ], + "title": "SearchCommandAction", + "type": "object" + }, + { "properties": { "command": { "type": "string" }, "type": { - "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType" + "title": "UnknownCommandActionType", + "type": "string" } }, - "title": "UnknownCommandAction" + "required": [ + "command", + "type" + ], + "title": "UnknownCommandAction", + "type": "object" } ] }, "CommandExecutionSource": { - "type": "string", "enum": [ "agent", "userShell", "unifiedExecStartup", "unifiedExecInteraction" - ] + ], + "type": "string" }, "CommandExecutionStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "DynamicToolCallOutputContentItem": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputText" ], - "title": "InputTextDynamicToolCallOutputContentItemType" + "title": "InputTextDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputTextDynamicToolCallOutputContentItem" - }, - { - "type": "object", "required": [ - "imageUrl", + "text", "type" ], + "title": "InputTextDynamicToolCallOutputContentItem", + "type": "object" + }, + { "properties": { "imageUrl": { "type": "string" }, "type": { - "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType" + "title": "InputImageDynamicToolCallOutputContentItemType", + "type": "string" } }, - "title": "InputImageDynamicToolCallOutputContentItem" + "required": [ + "imageUrl", + "type" + ], + "title": "InputImageDynamicToolCallOutputContentItem", + "type": "object" } ] }, "DynamicToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "FileUpdateChange": { - "type": "object", - "required": [ - "diff", - "kind", - "path" - ], "properties": { "diff": { "type": "string" @@ -418,14 +398,15 @@ "path": { "type": "string" } - } + }, + "required": [ + "diff", + "kind", + "path" + ], + "type": "object" }, "HookPromptFragment": { - "type": "object", - "required": [ - "hookRunId", - "text" - ], "properties": { "hookRunId": { "type": "string" @@ -433,80 +414,78 @@ "text": { "type": "string" } - } + }, + "required": [ + "hookRunId", + "text" + ], + "type": "object" }, "McpToolCallError": { - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "McpToolCallResult": { - "type": "object", - "required": [ - "content" - ], "properties": { "_meta": true, "content": { - "type": "array", - "items": true + "items": true, + "type": "array" }, "structuredContent": true - } + }, + "required": [ + "content" + ], + "type": "object" }, "McpToolCallStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed" - ] + ], + "type": "string" }, "MemoryCitation": { - "type": "object", + "properties": { + "entries": { + "items": { + "$ref": "#/definitions/MemoryCitationEntry" + }, + "type": "array" + }, + "threadIds": { + "items": { + "type": "string" + }, + "type": "array" + } + }, "required": [ "entries", "threadIds" ], - "properties": { - "entries": { - "type": "array", - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - } - }, - "threadIds": { - "type": "array", - "items": { - "type": "string" - } - } - } + "type": "object" }, "MemoryCitationEntry": { - "type": "object", - "required": [ - "lineEnd", - "lineStart", - "note", - "path" - ], "properties": { "lineEnd": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "lineStart": { - "type": "integer", "format": "uint32", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "note": { "type": "string" @@ -514,82 +493,85 @@ "path": { "type": "string" } - } + }, + "required": [ + "lineEnd", + "lineStart", + "note", + "path" + ], + "type": "object" }, "MessagePhase": { "description": "Classifies an assistant message as interim commentary or final answer text.\n\nProviders do not emit this consistently, so callers must treat `None` as \"phase unknown\" and keep compatibility behavior for legacy models.", "oneOf": [ { "description": "Mid-turn assistant text (for example preamble/progress narration).\n\nAdditional tool calls or assistant output may follow before turn completion.", - "type": "string", "enum": [ "commentary" - ] + ], + "type": "string" }, { "description": "The assistant's terminal answer text for the current turn.", - "type": "string", "enum": [ "final_answer" - ] + ], + "type": "string" } ] }, "NonSteerableTurnKind": { - "type": "string", "enum": [ "review", "compact" - ] + ], + "type": "string" }, "PatchApplyStatus": { - "type": "string", "enum": [ "inProgress", "completed", "failed", "declined" - ] + ], + "type": "string" }, "PatchChangeKind": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "type": { - "type": "string", "enum": [ "add" ], - "title": "AddPatchChangeKindType" + "title": "AddPatchChangeKindType", + "type": "string" } }, - "title": "AddPatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "AddPatchChangeKind", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType" + "title": "DeletePatchChangeKindType", + "type": "string" } }, - "title": "DeletePatchChangeKind" - }, - { - "type": "object", "required": [ "type" ], + "title": "DeletePatchChangeKind", + "type": "object" + }, + { "properties": { "move_path": { "type": [ @@ -598,20 +580,23 @@ ] }, "type": { - "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType" + "title": "UpdatePatchChangeKindType", + "type": "string" } }, - "title": "UpdatePatchChangeKind" + "required": [ + "type" + ], + "title": "UpdatePatchChangeKind", + "type": "object" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", - "type": "string", "enum": [ "none", "minimal", @@ -619,21 +604,18 @@ "medium", "high", "xhigh" - ] + ], + "type": "string" }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -642,77 +624,74 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "ThreadItem": { "oneOf": [ { - "type": "object", + "properties": { + "content": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "id": { + "type": "string" + }, + "type": { + "enum": [ + "userMessage" + ], + "title": "UserMessageThreadItemType", + "type": "string" + } + }, "required": [ "content", "id", "type" ], + "title": "UserMessageThreadItem", + "type": "object" + }, + { "properties": { - "content": { - "type": "array", + "fragments": { "items": { - "$ref": "#/definitions/UserInput" - } + "$ref": "#/definitions/HookPromptFragment" + }, + "type": "array" }, "id": { "type": "string" }, "type": { - "type": "string", "enum": [ - "userMessage" + "hookPrompt" ], - "title": "UserMessageThreadItemType" + "title": "HookPromptThreadItemType", + "type": "string" } }, - "title": "UserMessageThreadItem" - }, - { - "type": "object", "required": [ "fragments", "id", "type" ], - "properties": { - "fragments": { - "type": "array", - "items": { - "$ref": "#/definitions/HookPromptFragment" - } - }, - "id": { - "type": "string" - }, - "type": { - "type": "string", - "enum": [ - "hookPrompt" - ], - "title": "HookPromptThreadItemType" - } - }, - "title": "HookPromptThreadItem" + "title": "HookPromptThreadItem", + "type": "object" }, { - "type": "object", - "required": [ - "id", - "text", - "type" - ], "properties": { "id": { "type": "string" }, "memoryCitation": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MemoryCitation" @@ -720,10 +699,10 @@ { "type": "null" } - ] + ], + "default": null }, "phase": { - "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -731,29 +710,30 @@ { "type": "null" } - ] + ], + "default": null }, "text": { "type": "string" }, "type": { - "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType" + "title": "AgentMessageThreadItemType", + "type": "string" } }, - "title": "AgentMessageThreadItem" - }, - { - "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", - "type": "object", "required": [ "id", "text", "type" ], + "title": "AgentMessageThreadItem", + "type": "object" + }, + { + "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.", "properties": { "id": { "type": "string" @@ -762,59 +742,56 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType" + "title": "PlanThreadItemType", + "type": "string" } }, - "title": "PlanThreadItem" - }, - { - "type": "object", "required": [ "id", + "text", "type" ], + "title": "PlanThreadItem", + "type": "object" + }, + { "properties": { "content": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "id": { "type": "string" }, "summary": { "default": [], - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningThreadItemType" + "title": "ReasoningThreadItemType", + "type": "string" } }, - "title": "ReasoningThreadItem" - }, - { - "type": "object", "required": [ - "command", - "commandActions", - "cwd", "id", - "status", "type" ], + "title": "ReasoningThreadItem", + "type": "object" + }, + { "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -829,34 +806,34 @@ }, "commandActions": { "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.", - "type": "array", "items": { "$ref": "#/definitions/CommandAction" - } + }, + "type": "array" }, "cwd": { - "description": "The command's working directory.", "allOf": [ { "$ref": "#/definitions/AbsolutePathBuf" } - ] + ], + "description": "The command's working directory." }, "durationMs": { "description": "The duration of the command execution in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "exitCode": { "description": "The command's exit code.", + "format": "int32", "type": [ "integer", "null" - ], - "format": "int32" + ] }, "id": { "type": "string" @@ -869,40 +846,42 @@ ] }, "source": { - "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ] + ], + "default": "agent" }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { - "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType" + "title": "CommandExecutionThreadItemType", + "type": "string" } }, - "title": "CommandExecutionThreadItem" - }, - { - "type": "object", "required": [ - "changes", + "command", + "commandActions", + "cwd", "id", "status", "type" ], + "title": "CommandExecutionThreadItem", + "type": "object" + }, + { "properties": { "changes": { - "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - } + }, + "type": "array" }, "id": { "type": "string" @@ -911,34 +890,32 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { - "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType" + "title": "FileChangeThreadItemType", + "type": "string" } }, - "title": "FileChangeThreadItem" - }, - { - "type": "object", "required": [ - "arguments", + "changes", "id", - "server", "status", - "tool", "type" ], + "title": "FileChangeThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "durationMs": { "description": "The duration of the MCP tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { "anyOf": [ @@ -979,42 +956,43 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType" + "title": "McpToolCallThreadItemType", + "type": "string" } }, - "title": "McpToolCallThreadItem" - }, - { - "type": "object", "required": [ "arguments", "id", + "server", "status", "tool", "type" ], + "title": "McpToolCallThreadItem", + "type": "object" + }, + { "properties": { "arguments": true, "contentItems": { + "items": { + "$ref": "#/definitions/DynamicToolCallOutputContentItem" + }, "type": [ "array", "null" - ], - "items": { - "$ref": "#/definitions/DynamicToolCallOutputContentItem" - } + ] }, "durationMs": { "description": "The duration of the dynamic tool call in milliseconds.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "id": { "type": "string" @@ -1038,33 +1016,31 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType" + "title": "DynamicToolCallThreadItemType", + "type": "string" } }, - "title": "DynamicToolCallThreadItem" - }, - { - "type": "object", "required": [ - "agentsStates", + "arguments", "id", - "receiverThreadIds", - "senderThreadId", "status", "tool", "type" ], + "title": "DynamicToolCallThreadItem", + "type": "object" + }, + { "properties": { "agentsStates": { - "description": "Last known status of the target agents, when available.", - "type": "object", "additionalProperties": { "$ref": "#/definitions/CollabAgentState" - } + }, + "description": "Last known status of the target agents, when available.", + "type": "object" }, "id": { "description": "Unique identifier for this collab tool call.", @@ -1085,7 +1061,6 @@ ] }, "reasoningEffort": { - "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -1093,52 +1068,57 @@ { "type": "null" } - ] + ], + "description": "Reasoning effort requested for the spawned agent, when applicable." }, "receiverThreadIds": { "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.", - "type": "array", "items": { "type": "string" - } + }, + "type": "array" }, "senderThreadId": { "description": "Thread ID of the agent issuing the collab request.", "type": "string" }, "status": { - "description": "Current status of the collab tool call.", "allOf": [ { "$ref": "#/definitions/CollabAgentToolCallStatus" } - ] + ], + "description": "Current status of the collab tool call." }, "tool": { - "description": "Name of the collab tool that was invoked.", "allOf": [ { "$ref": "#/definitions/CollabAgentTool" } - ] + ], + "description": "Name of the collab tool that was invoked." }, "type": { - "type": "string", "enum": [ "collabAgentToolCall" ], - "title": "CollabAgentToolCallThreadItemType" + "title": "CollabAgentToolCallThreadItemType", + "type": "string" } }, - "title": "CollabAgentToolCallThreadItem" - }, - { - "type": "object", "required": [ + "agentsStates", "id", - "query", + "receiverThreadIds", + "senderThreadId", + "status", + "tool", "type" ], + "title": "CollabAgentToolCallThreadItem", + "type": "object" + }, + { "properties": { "action": { "anyOf": [ @@ -1157,22 +1137,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType" + "title": "WebSearchThreadItemType", + "type": "string" } }, - "title": "WebSearchThreadItem" - }, - { - "type": "object", "required": [ "id", - "path", + "query", "type" ], + "title": "WebSearchThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1181,23 +1161,22 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { - "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType" + "title": "ImageViewThreadItemType", + "type": "string" } }, - "title": "ImageViewThreadItem" - }, - { - "type": "object", "required": [ "id", - "result", - "status", + "path", "type" ], + "title": "ImageViewThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1225,22 +1204,23 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType" + "title": "ImageGenerationThreadItemType", + "type": "string" } }, - "title": "ImageGenerationThreadItem" - }, - { - "type": "object", "required": [ "id", - "review", + "result", + "status", "type" ], + "title": "ImageGenerationThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1249,22 +1229,22 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType" + "title": "EnteredReviewModeThreadItemType", + "type": "string" } }, - "title": "EnteredReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", "review", "type" ], + "title": "EnteredReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" @@ -1273,63 +1253,62 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType" + "title": "ExitedReviewModeThreadItemType", + "type": "string" } }, - "title": "ExitedReviewModeThreadItem" - }, - { - "type": "object", "required": [ "id", + "review", "type" ], + "title": "ExitedReviewModeThreadItem", + "type": "object" + }, + { "properties": { "id": { "type": "string" }, "type": { - "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType" + "title": "ContextCompactionThreadItemType", + "type": "string" } }, - "title": "ContextCompactionThreadItem" + "required": [ + "id", + "type" + ], + "title": "ContextCompactionThreadItem", + "type": "object" } ] }, "Turn": { - "type": "object", - "required": [ - "id", - "items", - "status" - ], "properties": { "completedAt": { "description": "Unix timestamp (in seconds) when the turn completed.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "durationMs": { "description": "Duration between turn start and completion in milliseconds, if known.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "error": { - "description": "Only populated when the Turn's status is failed.", "anyOf": [ { "$ref": "#/definitions/TurnError" @@ -1337,36 +1316,39 @@ { "type": "null" } - ] + ], + "description": "Only populated when the Turn's status is failed." }, "id": { "type": "string" }, "items": { "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.", - "type": "array", "items": { "$ref": "#/definitions/ThreadItem" - } + }, + "type": "array" }, "startedAt": { "description": "Unix timestamp (in seconds) when the turn started.", + "format": "int64", "type": [ "integer", "null" - ], - "format": "int64" + ] }, "status": { "$ref": "#/definitions/TurnStatus" } - } + }, + "required": [ + "id", + "items", + "status" + ], + "type": "object" }, "TurnError": { - "type": "object", - "required": [ - "message" - ], "properties": { "additionalDetails": { "default": null, @@ -1388,94 +1370,92 @@ "message": { "type": "string" } - } + }, + "required": [ + "message" + ], + "type": "object" }, "TurnStatus": { - "type": "string", "enum": [ "completed", "interrupted", "failed", "inProgress" - ] + ], + "type": "string" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -1484,33 +1464,35 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] }, "WebSearchAction": { "oneOf": [ { - "type": "object", - "required": [ - "type" - ], "properties": { "queries": { + "items": { + "type": "string" + }, "type": [ "array", "null" - ], - "items": { - "type": "string" - } + ] }, "query": { "type": [ @@ -1519,27 +1501,27 @@ ] }, "type": { - "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType" + "title": "SearchWebSearchActionType", + "type": "string" } }, - "title": "SearchWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "SearchWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType" + "title": "OpenPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1548,13 +1530,13 @@ ] } }, - "title": "OpenPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "OpenPageWebSearchAction", + "type": "object" + }, + { "properties": { "pattern": { "type": [ @@ -1563,11 +1545,11 @@ ] }, "type": { - "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType" + "title": "FindInPageWebSearchActionType", + "type": "string" }, "url": { "type": [ @@ -1576,25 +1558,43 @@ ] } }, - "title": "FindInPageWebSearchAction" - }, - { - "type": "object", "required": [ "type" ], + "title": "FindInPageWebSearchAction", + "type": "object" + }, + { "properties": { "type": { - "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType" + "title": "OtherWebSearchActionType", + "type": "string" } }, - "title": "OtherWebSearchAction" + "required": [ + "type" + ], + "title": "OtherWebSearchAction", + "type": "object" } ] } - } + }, + "properties": { + "threadId": { + "type": "string" + }, + "turn": { + "$ref": "#/definitions/Turn" + } + }, + "required": [ + "threadId", + "turn" + ], + "title": "TurnStartedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnSteerParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnSteerParams.json index c7cd8fd0..c965eab6 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnSteerParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnSteerParams.json @@ -1,60 +1,34 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnSteerParams", - "type": "object", - "required": [ - "expectedTurnId", - "input", - "threadId" - ], - "properties": { - "expectedTurnId": { - "description": "Required active turn id precondition. The request fails when it does not match the currently active turn.", - "type": "string" - }, - "input": { - "type": "array", - "items": { - "$ref": "#/definitions/UserInput" - } - }, - "threadId": { - "type": "string" - } - }, "definitions": { "ByteRange": { - "type": "object", + "properties": { + "end": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + }, + "start": { + "format": "uint", + "minimum": 0.0, + "type": "integer" + } + }, "required": [ "end", "start" ], - "properties": { - "end": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - }, - "start": { - "type": "integer", - "format": "uint", - "minimum": 0.0 - } - } + "type": "object" }, "TextElement": { - "type": "object", - "required": [ - "byteRange" - ], "properties": { "byteRange": { - "description": "Byte range in the parent `text` buffer that this element occupies.", "allOf": [ { "$ref": "#/definitions/ByteRange" } - ] + ], + "description": "Byte range in the parent `text` buffer that this element occupies." }, "placeholder": { "description": "Optional human-readable placeholder for the element, displayed in the UI.", @@ -63,85 +37,83 @@ "null" ] } - } + }, + "required": [ + "byteRange" + ], + "type": "object" }, "UserInput": { "oneOf": [ { - "type": "object", - "required": [ - "text", - "type" - ], "properties": { "text": { "type": "string" }, "text_elements": { - "description": "UI-defined spans within `text` used to render or persist special elements.", "default": [], - "type": "array", + "description": "UI-defined spans within `text` used to render or persist special elements.", "items": { "$ref": "#/definitions/TextElement" - } + }, + "type": "array" }, "type": { - "type": "string", "enum": [ "text" ], - "title": "TextUserInputType" + "title": "TextUserInputType", + "type": "string" } }, - "title": "TextUserInput" + "required": [ + "text", + "type" + ], + "title": "TextUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "type", - "url" - ], "properties": { "type": { - "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType" + "title": "ImageUserInputType", + "type": "string" }, "url": { "type": "string" } }, - "title": "ImageUserInput" + "required": [ + "type", + "url" + ], + "title": "ImageUserInput", + "type": "object" }, { - "type": "object", - "required": [ - "path", - "type" - ], "properties": { "path": { "type": "string" }, "type": { - "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType" + "title": "LocalImageUserInputType", + "type": "string" } }, - "title": "LocalImageUserInput" - }, - { - "type": "object", "required": [ - "name", "path", "type" ], + "title": "LocalImageUserInput", + "type": "object" + }, + { "properties": { "name": { "type": "string" @@ -150,16 +122,44 @@ "type": "string" }, "type": { - "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType" + "title": "MentionUserInputType", + "type": "string" } }, - "title": "MentionUserInput" + "required": [ + "name", + "path", + "type" + ], + "title": "MentionUserInput", + "type": "object" } ] } - } + }, + "properties": { + "expectedTurnId": { + "description": "Required active turn id precondition. The request fails when it does not match the currently active turn.", + "type": "string" + }, + "input": { + "items": { + "$ref": "#/definitions/UserInput" + }, + "type": "array" + }, + "threadId": { + "type": "string" + } + }, + "required": [ + "expectedTurnId", + "input", + "threadId" + ], + "title": "TurnSteerParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnSteerResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnSteerResponse.json index 61a912b7..d801a361 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnSteerResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/TurnSteerResponse.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "TurnSteerResponse", - "type": "object", - "required": [ - "turnId" - ], "properties": { "turnId": { "type": "string" } - } + }, + "required": [ + "turnId" + ], + "title": "TurnSteerResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WarningNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WarningNotification.json index 98991174..46048689 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WarningNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WarningNotification.json @@ -1,10 +1,5 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WarningNotification", - "type": "object", - "required": [ - "message" - ], "properties": { "message": { "description": "Concise warning message for the user.", @@ -17,5 +12,10 @@ "null" ] } - } + }, + "required": [ + "message" + ], + "title": "WarningNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsSandboxSetupCompletedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsSandboxSetupCompletedNotification.json index a365b155..9ed9632f 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsSandboxSetupCompletedNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsSandboxSetupCompletedNotification.json @@ -1,11 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WindowsSandboxSetupCompletedNotification", - "type": "object", - "required": [ - "mode", - "success" - ], + "definitions": { + "WindowsSandboxSetupMode": { + "enum": [ + "elevated", + "unelevated" + ], + "type": "string" + } + }, "properties": { "error": { "type": [ @@ -20,13 +23,10 @@ "type": "boolean" } }, - "definitions": { - "WindowsSandboxSetupMode": { - "type": "string", - "enum": [ - "elevated", - "unelevated" - ] - } - } + "required": [ + "mode", + "success" + ], + "title": "WindowsSandboxSetupCompletedNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsSandboxSetupStartParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsSandboxSetupStartParams.json index 7fcc455c..ed93913c 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsSandboxSetupStartParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsSandboxSetupStartParams.json @@ -1,10 +1,18 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WindowsSandboxSetupStartParams", - "type": "object", - "required": [ - "mode" - ], + "definitions": { + "AbsolutePathBuf": { + "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", + "type": "string" + }, + "WindowsSandboxSetupMode": { + "enum": [ + "elevated", + "unelevated" + ], + "type": "string" + } + }, "properties": { "cwd": { "anyOf": [ @@ -20,17 +28,9 @@ "$ref": "#/definitions/WindowsSandboxSetupMode" } }, - "definitions": { - "AbsolutePathBuf": { - "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.", - "type": "string" - }, - "WindowsSandboxSetupMode": { - "type": "string", - "enum": [ - "elevated", - "unelevated" - ] - } - } + "required": [ + "mode" + ], + "title": "WindowsSandboxSetupStartParams", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsSandboxSetupStartResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsSandboxSetupStartResponse.json index 5f831454..ce35665b 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsSandboxSetupStartResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsSandboxSetupStartResponse.json @@ -1,13 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WindowsSandboxSetupStartResponse", - "type": "object", - "required": [ - "started" - ], "properties": { "started": { "type": "boolean" } - } + }, + "required": [ + "started" + ], + "title": "WindowsSandboxSetupStartResponse", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsWorldWritableWarningNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsWorldWritableWarningNotification.json index 20460105..893dbbaf 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsWorldWritableWarningNotification.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/WindowsWorldWritableWarningNotification.json @@ -1,26 +1,26 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "title": "WindowsWorldWritableWarningNotification", - "type": "object", - "required": [ - "extraCount", - "failedScan", - "samplePaths" - ], "properties": { "extraCount": { - "type": "integer", "format": "uint", - "minimum": 0.0 + "minimum": 0.0, + "type": "integer" }, "failedScan": { "type": "boolean" }, "samplePaths": { - "type": "array", "items": { "type": "string" - } + }, + "type": "array" } - } + }, + "required": [ + "extraCount", + "failedScan", + "samplePaths" + ], + "title": "WindowsWorldWritableWarningNotification", + "type": "object" } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyReorientWorkerLaunchDocument.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyReorientWorkerLaunchDocument.ts deleted file mode 100644 index 0051c767..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyReorientWorkerLaunchDocument.ts +++ /dev/null @@ -1,10 +0,0 @@ -// GENERATED CODE! DO NOT MODIFY BY HAND! - -// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually. -import type { EpiphanyCodeRef } from "../EpiphanyCodeRef"; -import type { EpiphanyEvidenceRecord } from "../EpiphanyEvidenceRecord"; -import type { EpiphanyGraphs } from "../EpiphanyGraphs"; -import type { EpiphanyObservation } from "../EpiphanyObservation"; -import type { EpiphanyScratchPad } from "../EpiphanyScratchPad"; - -export type ThreadEpiphanyReorientWorkerLaunchDocument = { threadId: string, mode: string, checkpointId: string, checkpointKind: string, checkpointDisposition: string, checkpointFocus?: string | null, checkpointSummary?: string | null, checkpointNextAction: string, checkpointOpenQuestions?: Array, checkpointEvidenceIds?: Array, checkpointCodeRefs?: Array, decisionReasons?: Array, decisionNote: string, pressureLevel: string, retrievalStatus: string, graphStatus: string, watcherStatus: string, checkpointDirtyPaths?: Array, checkpointChangedPaths?: Array, scratch?: EpiphanyScratchPad | null, graphs?: EpiphanyGraphs | null, recentEvidence?: Array, recentObservations?: Array, activeFrontierNodeIds?: Array, linkedSubgoalIds?: Array, linkedGraphNodeIds?: Array, }; diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveIndexSummary.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveIndexSummary.ts deleted file mode 100644 index 041080b2..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveIndexSummary.ts +++ /dev/null @@ -1,8 +0,0 @@ -// GENERATED CODE! DO NOT MODIFY BY HAND! - -// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually. -import type { AbsolutePathBuf } from "../AbsolutePathBuf"; -import type { EpiphanyRetrievalStatus } from "../EpiphanyRetrievalStatus"; -import type { ThreadEpiphanyRetrieveShardSummary } from "./ThreadEpiphanyRetrieveShardSummary"; - -export type ThreadEpiphanyRetrieveIndexSummary = { workspaceRoot: AbsolutePathBuf, indexRevision: string | null, status: EpiphanyRetrievalStatus, semanticAvailable: boolean, lastIndexedAtUnixSeconds: number | null, indexedFileCount: number | null, indexedChunkCount: number | null, shards: Array, dirtyPaths: Array, }; diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveResult.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveResult.ts deleted file mode 100644 index 7574bdfb..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveResult.ts +++ /dev/null @@ -1,6 +0,0 @@ -// GENERATED CODE! DO NOT MODIFY BY HAND! - -// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually. -import type { ThreadEpiphanyRetrieveResultKind } from "./ThreadEpiphanyRetrieveResultKind"; - -export type ThreadEpiphanyRetrieveResult = { kind: ThreadEpiphanyRetrieveResultKind, path: string, score: number, lineStart: number | null, lineEnd: number | null, excerpt: string | null, }; diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveResultKind.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveResultKind.ts deleted file mode 100644 index 5437ec44..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveResultKind.ts +++ /dev/null @@ -1,5 +0,0 @@ -// GENERATED CODE! DO NOT MODIFY BY HAND! - -// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually. - -export type ThreadEpiphanyRetrieveResultKind = "exactFile" | "exactDirectory" | "semanticChunk"; diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveShardSummary.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveShardSummary.ts deleted file mode 100644 index 17388146..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRetrieveShardSummary.ts +++ /dev/null @@ -1,6 +0,0 @@ -// GENERATED CODE! DO NOT MODIFY BY HAND! - -// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually. -import type { EpiphanyRetrievalStatus } from "../EpiphanyRetrievalStatus"; - -export type ThreadEpiphanyRetrieveShardSummary = { shardId: string, pathPrefix: string, indexedFileCount: number | null, indexedChunkCount: number | null, status: EpiphanyRetrievalStatus, exactAvailable: boolean, semanticAvailable: boolean, }; diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRoleWorkerLaunchDocument.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRoleWorkerLaunchDocument.ts deleted file mode 100644 index 69f0fae0..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyRoleWorkerLaunchDocument.ts +++ /dev/null @@ -1,16 +0,0 @@ -// GENERATED CODE! DO NOT MODIFY BY HAND! - -// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually. -import type { EpiphanyChurnState } from "../EpiphanyChurnState"; -import type { EpiphanyEvidenceRecord } from "../EpiphanyEvidenceRecord"; -import type { EpiphanyGraphCheckpoint } from "../EpiphanyGraphCheckpoint"; -import type { EpiphanyGraphFrontier } from "../EpiphanyGraphFrontier"; -import type { EpiphanyGraphs } from "../EpiphanyGraphs"; -import type { EpiphanyInvariant } from "../EpiphanyInvariant"; -import type { EpiphanyInvestigationCheckpoint } from "../EpiphanyInvestigationCheckpoint"; -import type { EpiphanyObservation } from "../EpiphanyObservation"; -import type { EpiphanyPlanningState } from "../EpiphanyPlanningState"; -import type { EpiphanyScratchPad } from "../EpiphanyScratchPad"; -import type { EpiphanySubgoal } from "../EpiphanySubgoal"; - -export type ThreadEpiphanyRoleWorkerLaunchDocument = { threadId: string, roleId: string, stateRevision: bigint, objective?: string | null, activeSubgoalId?: string | null, activeSubgoals?: Array, activeGraphNodeIds?: Array, investigationCheckpoint?: EpiphanyInvestigationCheckpoint | null, scratch?: EpiphanyScratchPad | null, invariants?: Array, graphs?: EpiphanyGraphs | null, recentEvidence?: Array, recentObservations?: Array, graphFrontier?: EpiphanyGraphFrontier | null, graphCheckpoint?: EpiphanyGraphCheckpoint | null, planning?: EpiphanyPlanningState | null, churn?: EpiphanyChurnState | null, }; diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyWorkerLaunchDocument.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyWorkerLaunchDocument.ts deleted file mode 100644 index cafce5aa..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/ThreadEpiphanyWorkerLaunchDocument.ts +++ /dev/null @@ -1,7 +0,0 @@ -// GENERATED CODE! DO NOT MODIFY BY HAND! - -// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually. -import type { ThreadEpiphanyReorientWorkerLaunchDocument } from "./ThreadEpiphanyReorientWorkerLaunchDocument"; -import type { ThreadEpiphanyRoleWorkerLaunchDocument } from "./ThreadEpiphanyRoleWorkerLaunchDocument"; - -export type ThreadEpiphanyWorkerLaunchDocument = { "documentKind": "role" } & ThreadEpiphanyRoleWorkerLaunchDocument | { "documentKind": "reorient" } & ThreadEpiphanyReorientWorkerLaunchDocument; diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/index.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/index.ts index 94a08291..85926981 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/index.ts +++ b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/index.ts @@ -297,13 +297,8 @@ export type { ThreadEpiphanyReorientReason } from "./ThreadEpiphanyReorientReaso export type { ThreadEpiphanyReorientResultStatus } from "./ThreadEpiphanyReorientResultStatus"; export type { ThreadEpiphanyReorientSource } from "./ThreadEpiphanyReorientSource"; export type { ThreadEpiphanyReorientStateStatus } from "./ThreadEpiphanyReorientStateStatus"; -export type { ThreadEpiphanyReorientWorkerLaunchDocument } from "./ThreadEpiphanyReorientWorkerLaunchDocument"; export type { ThreadEpiphanyRetrievalFreshness } from "./ThreadEpiphanyRetrievalFreshness"; export type { ThreadEpiphanyRetrievalFreshnessStatus } from "./ThreadEpiphanyRetrievalFreshnessStatus"; -export type { ThreadEpiphanyRetrieveIndexSummary } from "./ThreadEpiphanyRetrieveIndexSummary"; -export type { ThreadEpiphanyRetrieveResult } from "./ThreadEpiphanyRetrieveResult"; -export type { ThreadEpiphanyRetrieveResultKind } from "./ThreadEpiphanyRetrieveResultKind"; -export type { ThreadEpiphanyRetrieveShardSummary } from "./ThreadEpiphanyRetrieveShardSummary"; export type { ThreadEpiphanyRoleFinding } from "./ThreadEpiphanyRoleFinding"; export type { ThreadEpiphanyRoleId } from "./ThreadEpiphanyRoleId"; export type { ThreadEpiphanyRoleLane } from "./ThreadEpiphanyRoleLane"; @@ -311,7 +306,6 @@ export type { ThreadEpiphanyRoleResultStatus } from "./ThreadEpiphanyRoleResultS export type { ThreadEpiphanyRoleSelfPersistenceReview } from "./ThreadEpiphanyRoleSelfPersistenceReview"; export type { ThreadEpiphanyRoleSelfPersistenceStatus } from "./ThreadEpiphanyRoleSelfPersistenceStatus"; export type { ThreadEpiphanyRoleStatus } from "./ThreadEpiphanyRoleStatus"; -export type { ThreadEpiphanyRoleWorkerLaunchDocument } from "./ThreadEpiphanyRoleWorkerLaunchDocument"; export type { ThreadEpiphanyRolesSource } from "./ThreadEpiphanyRolesSource"; export type { ThreadEpiphanyScene } from "./ThreadEpiphanyScene"; export type { ThreadEpiphanySceneAction } from "./ThreadEpiphanySceneAction"; @@ -335,7 +329,6 @@ export type { ThreadEpiphanyViewLens } from "./ThreadEpiphanyViewLens"; export type { ThreadEpiphanyViewPlanning } from "./ThreadEpiphanyViewPlanning"; export type { ThreadEpiphanyViewReorient } from "./ThreadEpiphanyViewReorient"; export type { ThreadEpiphanyViewRoles } from "./ThreadEpiphanyViewRoles"; -export type { ThreadEpiphanyWorkerLaunchDocument } from "./ThreadEpiphanyWorkerLaunchDocument"; export type { ThreadForkParams } from "./ThreadForkParams"; export type { ThreadForkResponse } from "./ThreadForkResponse"; export type { ThreadInjectItemsParams } from "./ThreadInjectItemsParams"; diff --git a/vendor/codex/codex-rs/app-server-protocol/src/protocol/v2.rs b/vendor/codex/codex-rs/app-server-protocol/src/protocol/v2.rs index c09aa26c..5c94dc53 100644 --- a/vendor/codex/codex-rs/app-server-protocol/src/protocol/v2.rs +++ b/vendor/codex/codex-rs/app-server-protocol/src/protocol/v2.rs @@ -59,7 +59,6 @@ use codex_protocol::protocol::CodexErrorInfo as CoreCodexErrorInfo; use codex_protocol::protocol::CreditsSnapshot as CoreCreditsSnapshot; use epiphany_state_model::EpiphanyAcceptanceReceipt as CoreEpiphanyAcceptanceReceipt; use epiphany_state_model::EpiphanyChurnState as CoreEpiphanyChurnState; -use epiphany_state_model::EpiphanyCodeRef as CoreEpiphanyCodeRef; use epiphany_state_model::EpiphanyEvidenceRecord as CoreEpiphanyEvidenceRecord; use epiphany_state_model::EpiphanyGraphCheckpoint as CoreEpiphanyGraphCheckpoint; use epiphany_state_model::EpiphanyGraphEdge as CoreEpiphanyGraphEdge; @@ -71,7 +70,6 @@ use epiphany_state_model::EpiphanyInvariant as CoreEpiphanyInvariant; use epiphany_state_model::EpiphanyInvestigationCheckpoint as CoreEpiphanyInvestigationCheckpoint; use epiphany_state_model::EpiphanyInvestigationDisposition as CoreEpiphanyInvestigationDisposition; use epiphany_state_model::EpiphanyJobBinding as CoreEpiphanyJobBinding; -use epiphany_state_model::EpiphanyJobKind as CoreEpiphanyJobKind; use epiphany_state_model::EpiphanyModeState as CoreEpiphanyModeState; use epiphany_state_model::EpiphanyObservation as CoreEpiphanyObservation; use epiphany_state_model::EpiphanyPlanningState as CoreEpiphanyPlanningState; @@ -3903,32 +3901,6 @@ pub struct ThreadEpiphanyRoleLane { pub recommended_action: Option, } -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyRoleLaunchParams { - pub thread_id: String, - pub role_id: ThreadEpiphanyRoleId, - #[serde(default)] - #[ts(optional = nullable)] - pub expected_revision: Option, - #[serde(default)] - #[ts(optional = nullable)] - pub max_runtime_seconds: Option, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyRoleLaunchResponse { - pub thread_id: String, - pub role_id: ThreadEpiphanyRoleId, - pub revision: u64, - pub changed_fields: Vec, - pub epiphany_state: CoreEpiphanyThreadState, - pub job: ThreadEpiphanyJob, -} - #[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] #[serde(rename_all = "camelCase")] #[ts(export_to = "v2/")] @@ -3962,36 +3934,6 @@ pub struct ThreadEpiphanyRoleResultResponse { pub note: String, } -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyRoleAcceptParams { - pub thread_id: String, - pub role_id: ThreadEpiphanyRoleId, - #[serde(default)] - #[ts(optional = nullable)] - pub expected_revision: Option, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub binding_id: Option, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyRoleAcceptResponse { - pub revision: u64, - pub changed_fields: Vec, - pub epiphany_state: CoreEpiphanyThreadState, - pub role_id: ThreadEpiphanyRoleId, - pub binding_id: String, - pub accepted_receipt_id: String, - pub accepted_observation_id: String, - pub accepted_evidence_id: String, - pub applied_patch: ThreadEpiphanyUpdatePatch, - pub finding: ThreadEpiphanyRoleFinding, -} - #[derive(Serialize, Deserialize, Debug, Clone, Copy, PartialEq, Eq, JsonSchema, TS)] #[serde(rename_all = "camelCase")] #[ts(export_to = "v2/")] @@ -4586,36 +4528,6 @@ pub enum ThreadEpiphanyPressureBasis { ModelContextWindow, } -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyReorientLaunchParams { - pub thread_id: String, - #[serde(default)] - #[ts(optional = nullable)] - pub expected_revision: Option, - #[serde(default)] - #[ts(optional = nullable)] - pub max_runtime_seconds: Option, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyReorientLaunchResponse { - pub thread_id: String, - pub source: ThreadEpiphanyReorientSource, - pub state_status: ThreadEpiphanyReorientStateStatus, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub state_revision: Option, - pub decision: ThreadEpiphanyReorientDecision, - pub revision: u64, - pub changed_fields: Vec, - pub epiphany_state: CoreEpiphanyThreadState, - pub job: ThreadEpiphanyJob, -} - #[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] #[serde(rename_all = "camelCase")] #[ts(export_to = "v2/")] @@ -4647,37 +4559,6 @@ pub struct ThreadEpiphanyReorientResultResponse { pub note: String, } -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyReorientAcceptParams { - pub thread_id: String, - #[serde(default)] - #[ts(optional = nullable)] - pub expected_revision: Option, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub binding_id: Option, - #[serde(default, skip_serializing_if = "std::ops::Not::not")] - pub update_scratch: bool, - #[serde(default, skip_serializing_if = "std::ops::Not::not")] - pub update_investigation_checkpoint: bool, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyReorientAcceptResponse { - pub revision: u64, - pub changed_fields: Vec, - pub epiphany_state: CoreEpiphanyThreadState, - pub binding_id: String, - pub accepted_receipt_id: String, - pub accepted_observation_id: String, - pub accepted_evidence_id: String, - pub finding: ThreadEpiphanyReorientFinding, -} - #[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, JsonSchema, TS)] #[serde(rename_all = "camelCase")] #[ts(export_to = "v2/")] @@ -4951,91 +4832,6 @@ pub struct ThreadEpiphanyReorientDecision { pub note: String, } -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyIndexParams { - pub thread_id: String, - #[serde(default, skip_serializing_if = "std::ops::Not::not")] - pub force_full_rebuild: bool, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyIndexResponse { - pub index_summary: ThreadEpiphanyRetrieveIndexSummary, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyDistillParams { - pub thread_id: String, - pub source_kind: String, - pub status: String, - pub text: String, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub subject: Option, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub evidence_kind: Option, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub code_refs: Vec, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyDistillResponse { - pub expected_revision: u64, - pub patch: ThreadEpiphanyUpdatePatch, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyProposeParams { - pub thread_id: String, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub observation_ids: Vec, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyProposeResponse { - pub expected_revision: u64, - pub patch: ThreadEpiphanyUpdatePatch, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyPromoteParams { - pub thread_id: String, - #[serde(default)] - #[ts(optional = nullable)] - pub expected_revision: Option, - pub patch: ThreadEpiphanyUpdatePatch, - pub verifier_evidence: CoreEpiphanyEvidenceRecord, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyPromoteResponse { - pub accepted: bool, - pub reasons: Vec, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub revision: Option, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub changed_fields: Vec, - pub epiphany_state: Option, -} - #[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] #[serde(rename_all = "camelCase")] #[ts(export_to = "v2/")] @@ -5175,146 +4971,6 @@ pub enum ThreadEpiphanyJobsUpdatedSource { RuntimeProgress, } -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyJobLaunchParams { - pub thread_id: String, - #[serde(default)] - #[ts(optional = nullable)] - pub expected_revision: Option, - pub binding_id: String, - pub kind: CoreEpiphanyJobKind, - pub scope: String, - pub owner_role: String, - pub authority_scope: String, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub linked_subgoal_ids: Vec, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub linked_graph_node_ids: Vec, - pub instruction: String, - pub launch_document: ThreadEpiphanyWorkerLaunchDocument, - pub output_contract_id: String, - #[serde(default)] - #[ts(optional = nullable)] - pub max_runtime_seconds: Option, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase", tag = "documentKind")] -#[ts(export_to = "v2/")] -pub enum ThreadEpiphanyWorkerLaunchDocument { - Role(ThreadEpiphanyRoleWorkerLaunchDocument), - Reorient(ThreadEpiphanyReorientWorkerLaunchDocument), -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyRoleWorkerLaunchDocument { - pub thread_id: String, - pub role_id: String, - pub state_revision: u64, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub objective: Option, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub active_subgoal_id: Option, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub active_subgoals: Vec, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub active_graph_node_ids: Vec, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub investigation_checkpoint: Option, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub scratch: Option, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub invariants: Vec, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub graphs: Option, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub recent_evidence: Vec, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub recent_observations: Vec, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub graph_frontier: Option, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub graph_checkpoint: Option, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub planning: Option, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub churn: Option, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyReorientWorkerLaunchDocument { - pub thread_id: String, - pub mode: String, - pub checkpoint_id: String, - pub checkpoint_kind: String, - pub checkpoint_disposition: String, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub checkpoint_focus: Option, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub checkpoint_summary: Option, - pub checkpoint_next_action: String, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub checkpoint_open_questions: Vec, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub checkpoint_evidence_ids: Vec, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub checkpoint_code_refs: Vec, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub decision_reasons: Vec, - pub decision_note: String, - pub pressure_level: String, - pub retrieval_status: String, - pub graph_status: String, - pub watcher_status: String, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub checkpoint_dirty_paths: Vec, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub checkpoint_changed_paths: Vec, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub scratch: Option, - #[serde(default, skip_serializing_if = "Option::is_none")] - #[ts(optional = nullable)] - pub graphs: Option, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub recent_evidence: Vec, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub recent_observations: Vec, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub active_frontier_node_ids: Vec, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub linked_subgoal_ids: Vec, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub linked_graph_node_ids: Vec, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyJobLaunchResponse { - pub revision: u64, - pub changed_fields: Vec, - pub epiphany_state: CoreEpiphanyThreadState, - pub job: ThreadEpiphanyJob, -} - #[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] #[serde(rename_all = "camelCase")] #[ts(export_to = "v2/")] @@ -5342,83 +4998,6 @@ pub struct ThreadEpiphanyJobInterruptResponse { pub job: ThreadEpiphanyJob, } -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyRetrieveParams { - pub thread_id: String, - pub query: String, - #[ts(optional = nullable)] - pub limit: Option, - #[serde(default, skip_serializing_if = "Vec::is_empty")] - pub path_prefixes: Vec, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyRetrieveResponse { - pub query: String, - pub index_summary: ThreadEpiphanyRetrieveIndexSummary, - pub results: Vec, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyRetrieveIndexSummary { - pub workspace_root: AbsolutePathBuf, - pub index_revision: Option, - pub status: CoreEpiphanyRetrievalStatus, - pub semantic_available: bool, - #[ts(type = "number | null")] - pub last_indexed_at_unix_seconds: Option, - #[ts(type = "number | null")] - pub indexed_file_count: Option, - #[ts(type = "number | null")] - pub indexed_chunk_count: Option, - pub shards: Vec, - pub dirty_paths: Vec, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyRetrieveShardSummary { - pub shard_id: String, - pub path_prefix: PathBuf, - #[ts(type = "number | null")] - pub indexed_file_count: Option, - #[ts(type = "number | null")] - pub indexed_chunk_count: Option, - pub status: CoreEpiphanyRetrievalStatus, - pub exact_available: bool, - pub semantic_available: bool, -} - -#[derive(Serialize, Deserialize, Debug, Clone, Copy, PartialEq, Eq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(rename_all = "camelCase", export_to = "v2/")] -pub enum ThreadEpiphanyRetrieveResultKind { - ExactFile, - ExactDirectory, - SemanticChunk, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct ThreadEpiphanyRetrieveResult { - pub kind: ThreadEpiphanyRetrieveResultKind, - pub path: PathBuf, - pub score: f32, - #[ts(type = "number | null")] - pub line_start: Option, - #[ts(type = "number | null")] - pub line_end: Option, - pub excerpt: Option, -} - #[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] #[serde(rename_all = "camelCase")] #[ts(export_to = "v2/")]