From 1ecae3946490a92bb26fbe7d075bc0f199524f17 Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Thu, 14 May 2026 00:07:29 +0100 Subject: [PATCH] Remove dead Codex skill mutation routes --- notes/fresh-workspace-handoff.md | 7 + state/ledgers.msgpack | Bin 107363 -> 107765 bytes state/map.yaml | 7 +- .../schema/json/ApplyPatchApprovalParams.json | 168 +- .../json/ApplyPatchApprovalResponse.json | 118 +- .../json/ChatgptAuthTokensRefreshParams.json | 36 +- .../ChatgptAuthTokensRefreshResponse.json | 14 +- .../schema/json/ClientNotification.json | 26 +- .../schema/json/ClientRequest.json | 7665 ++-- ...CommandExecutionRequestApprovalParams.json | 548 +- ...mmandExecutionRequestApprovalResponse.json | 114 +- .../schema/json/DynamicToolCallParams.json | 20 +- .../schema/json/DynamicToolCallResponse.json | 108 +- .../json/ExecCommandApprovalParams.json | 154 +- .../json/ExecCommandApprovalResponse.json | 118 +- .../json/FileChangeRequestApprovalParams.json | 16 +- .../FileChangeRequestApprovalResponse.json | 78 +- .../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 | 422 +- .../McpServerElicitationRequestResponse.json | 30 +- .../PermissionsRequestApprovalParams.json | 606 +- .../PermissionsRequestApprovalResponse.json | 250 +- .../schema/json/RequestId.json | 8 +- .../schema/json/ServerNotification.json | 5890 ++- .../schema/json/ServerRequest.json | 1474 +- .../json/ToolRequestUserInputParams.json | 88 +- .../json/ToolRequestUserInputResponse.json | 54 +- .../codex_app_server_protocol.schemas.json | 36380 ++++++++-------- .../codex_app_server_protocol.v2.schemas.json | 33966 +++++++-------- .../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 | 332 +- .../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 | 118 +- .../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 | 116 +- .../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 | 890 +- ...anApprovalReviewCompletedNotification.json | 450 +- ...dianApprovalReviewStartedNotification.json | 438 +- .../json/v2/ItemStartedNotification.json | 890 +- .../json/v2/ListMcpServerStatusParams.json | 32 +- .../json/v2/ListMcpServerStatusResponse.json | 124 +- .../schema/json/v2/LoginAccountParams.json | 64 +- .../schema/json/v2/LoginAccountResponse.json | 86 +- .../schema/json/v2/McpResourceReadParams.json | 14 +- .../json/v2/McpResourceReadResponse.json | 56 +- ...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 | 586 +- ...ReasoningSummaryPartAddedNotification.json | 22 +- ...ReasoningSummaryTextDeltaNotification.json | 24 +- .../v2/ReasoningTextDeltaNotification.json | 24 +- .../schema/json/v2/ReviewStartParams.json | 128 +- .../schema/json/v2/ReviewStartResponse.json | 1070 +- .../v2/SendAddCreditsNudgeEmailParams.json | 28 +- .../v2/SendAddCreditsNudgeEmailResponse.json | 28 +- .../v2/ServerRequestResolvedNotification.json | 38 +- .../json/v2/SkillsChangedNotification.json | 6 - .../json/v2/SkillsConfigWriteParams.json | 37 - .../json/v2/SkillsConfigWriteResponse.json | 13 - .../schema/json/v2/SkillsListParams.json | 58 +- .../schema/json/v2/SkillsListResponse.json | 132 +- .../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 | 120 +- ...hreadEpiphanyStateUpdatedNotification.json | 778 +- .../schema/json/v2/ThreadForkParams.json | 758 +- .../schema/json/v2/ThreadForkResponse.json | 2484 +- .../json/v2/ThreadInjectItemsParams.json | 24 +- .../schema/json/v2/ThreadListParams.json | 126 +- .../schema/json/v2/ThreadListResponse.json | 2018 +- .../json/v2/ThreadLoadedListParams.json | 12 +- .../json/v2/ThreadLoadedListResponse.json | 16 +- .../json/v2/ThreadMetadataUpdateParams.json | 48 +- .../json/v2/ThreadMetadataUpdateResponse.json | 1984 +- .../v2/ThreadNameUpdatedNotification.json | 12 +- .../schema/json/v2/ThreadReadParams.json | 14 +- .../schema/json/v2/ThreadReadResponse.json | 1984 +- .../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 | 2582 +- .../schema/json/v2/ThreadResumeResponse.json | 2484 +- .../schema/json/v2/ThreadRollbackParams.json | 26 +- .../json/v2/ThreadRollbackResponse.json | 1994 +- .../schema/json/v2/ThreadSetNameParams.json | 14 +- .../json/v2/ThreadShellCommandParams.json | 14 +- .../schema/json/v2/ThreadStartParams.json | 902 +- .../schema/json/v2/ThreadStartResponse.json | 2484 +- .../json/v2/ThreadStartedNotification.json | 1984 +- .../v2/ThreadStatusChangedNotification.json | 180 +- .../ThreadTokenUsageUpdatedNotification.json | 140 +- .../schema/json/v2/ThreadTurnsListParams.json | 38 +- .../json/v2/ThreadTurnsListResponse.json | 1094 +- .../schema/json/v2/ThreadUnarchiveParams.json | 12 +- .../json/v2/ThreadUnarchiveResponse.json | 1984 +- .../json/v2/ThreadUnarchivedNotification.json | 12 +- .../json/v2/ThreadUnsubscribeParams.json | 12 +- .../json/v2/ThreadUnsubscribeResponse.json | 30 +- .../json/v2/TurnCompletedNotification.json | 1068 +- .../json/v2/TurnDiffUpdatedNotification.json | 16 +- .../schema/json/v2/TurnInterruptParams.json | 14 +- .../json/v2/TurnPlanUpdatedNotification.json | 68 +- .../schema/json/v2/TurnStartParams.json | 786 +- .../schema/json/v2/TurnStartResponse.json | 1060 +- .../json/v2/TurnStartedNotification.json | 1068 +- .../schema/json/v2/TurnSteerParams.json | 166 +- .../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 | 36 +- .../schema/typescript/ClientRequest.ts | 3 +- .../schema/typescript/ServerNotification.ts | 3 +- .../v2/SkillsChangedNotification.ts | 11 - .../typescript/v2/SkillsConfigWriteParams.ts | 14 - .../v2/SkillsConfigWriteResponse.ts | 5 - .../schema/typescript/v2/index.ts | 3 - .../src/protocol/common.rs | 5 - .../app-server-protocol/src/protocol/v2.rs | 29 - vendor/codex/codex-rs/app-server/README.md | 40 +- .../app-server/src/bespoke_event_handling.rs | 10 - .../app-server/src/codex_message_processor.rs | 26 - .../codex/codex-rs/core/src/session/turn.rs | 1 - .../codex/codex-rs/core/tests/suite/client.rs | 70 - .../codex-rs/core/tests/suite/live_reload.rs | 153 - vendor/codex/codex-rs/core/tests/suite/mod.rs | 1 - .../mcp-server/src/codex_tool_runner.rs | 1 - .../codex/codex-rs/protocol/src/protocol.rs | 3 - vendor/codex/codex-rs/rollout/src/policy.rs | 1 - .../tui/src/app/app_server_adapter.rs | 3 +- vendor/codex/codex-rs/tui/src/app/tests.rs | 7 +- vendor/codex/codex-rs/tui/src/chatwidget.rs | 6 - 221 files changed, 64555 insertions(+), 65243 deletions(-) delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsChangedNotification.json delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteParams.json delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteResponse.json delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/SkillsChangedNotification.ts delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteParams.ts delete mode 100644 vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteResponse.ts delete mode 100644 vendor/codex/codex-rs/core/tests/suite/live_reload.rs diff --git a/notes/fresh-workspace-handoff.md b/notes/fresh-workspace-handoff.md index e4f740a5..0a7dfcf8 100644 --- a/notes/fresh-workspace-handoff.md +++ b/notes/fresh-workspace-handoff.md @@ -892,6 +892,13 @@ were deleted from the workspace, and `SkillsManager::new` no longer installs anything into `CODEX_HOME/skills/.system`. The legacy cache path remains only so stale bundled samples can be removed when bundled skills are disabled. +The dead skill mutation/notification edge is gone too. `skills/config/write`, +`skills/changed`, and `EventMsg::SkillsUpdateAvailable` no longer exist in the +shared protocol, generated schemas, app-server dispatch, core event handling, +TUI refresh reactions, or docs. The fake live-reload/developer-message skill +tests were deleted rather than repaired into a new compatibility lie. Only the +inert `skills/list` projection remains for legacy callers. + That husk has now been cut from `codex-core`. The root core crate no longer exports `plugins`, no longer depends on `codex-core-plugins` or `codex-plugin`, and the core plugin manager / marketplace add-remove-sync modules and tests diff --git a/state/ledgers.msgpack b/state/ledgers.msgpack index 819ac7a609226abb01c5747e7006448842cfd447..2e4193ae92a661288c96e67876bec665492a0a73 100644 GIT binary patch delta 388 zcmY+Ay-LJD5XXsywl;Pa17eq$Gsh{!LPRVqw9vaoZ053)+~Q_8?CeFYPVfcp5IkGK z7Z3ysuNHg`pTXXZUtl%g|KH5Kzs`TW&5u{+9$p?-Z-Zd@dKNs-f?#q#Jsk&&3rRa| zZKkc8$ut}t9#Ls(5+Dc#>>5EAz-Lk^D2EQ6G&q}>4*X?om-QKX*?CflQu``Tx9@_bhAhBnb-8x+l(dqKsMU$q+ufhnc1}J4 D^SO-* delta 49 zcmex*lI`&^wh78ii#0c@PGe-0Zr;PVeGen!#D!uFTZ{~h%ybP*bq$R}jEt;|46KZe FqX5k*59$B_ diff --git a/state/map.yaml b/state/map.yaml index e856c586..7a308c83 100644 --- a/state/map.yaml +++ b/state/map.yaml @@ -280,7 +280,7 @@ rejected_paths: reason: making Epiphany cleaner inside Codex still preserves the wrong organ; Codex must be starved down to OpenAI subscription auth/model transport, while Epiphany data and subsystem communication move to typed CultCache/CultNet. current_status: - summary: The Codex starvation pass has five typing receipts, forty-five processor/foundation cuts, a real physical extraction in `epiphany-codex-bridge`, a root `epiphany-state-model` crate for durable Epiphany state, a source-grounded Codex auth spine inventory, the native `epiphany-openai-adapter` document boundary, a buildable Codex auth/model wrapper in `epiphany-openai-codex-spine`, the first native runtime caller in `epiphany-openai-runtime`, native heartbeat launch planning/job opening in `epiphany-core`, native state-update contract/validation/application in `epiphany-core`, native exact retrieval path matching in `epiphany-core`, and the route-facing mutation/view/coordinator projection services in `epiphany-codex-bridge`. `codex-protocol` no longer defines the durable `Epiphany*` state structs; it re-exports the native model for legacy rollout/API compatibility while `epiphany-core` imports the native model directly. `epiphany-core` now has no direct vendored Codex dependency: pressure derivation accepts native `EpiphanyTokenUsageSnapshot`, Codex rollout replay moved to `codex-core::epiphany_rollout`, and exact retrieval search uses Epiphany-owned workspace walking/path scoring instead of `codex-file-search`. The bridge owns Codex-facing Epiphany adapters for scene, jobs, context/planning/graph query, retrieval/indexing projection, result projection, runtime-spine result adaptation, launch/prompt doctrine, mutation document mechanics, mutation service update/promote/role-accept/reorient-accept/role-launch/reorient-launch/job-launch/job-interrupt application, live-state projection, pressure/pre-compaction rendering, freshness/reorientation projection, CRRC/coordinator/role-board projection, watcher invalidation adaptation, full `thread/epiphany/view` response construction, freshness/context/graph-query response construction, role/reorient result response construction, distill/propose patch-response construction, coordinator status/view construction, and acceptance/evidence signal helpers. Vendored app-server no longer retains root Epiphany modules; `codex_message_processor.rs` still contains route dispatch, JSON-RPC response shaping, watcher registration/snapshotting calls, and notification emission, but its root no longer imports the evacuated Epiphany policy/protocol registry or owns the watcher invalidation manager. Codex product surfaces for apps, skills, plugins, marketplace, and external agent config import are now inert in the app-server compatibility path: list routes return empty lists, mutation/detail/import routes report disabled, `externalAgentConfig/detect` returns no import candidates, helper/import modules and stale implementation-shape tests were deleted, runtime feature enablement no longer supports `apps` or `plugins`, config writes no longer emit plugin-toggle analytics, plugin/skill cache invalidation on config writes is gone, plugin startup warmups and app-list refreshes were removed, and app-server no longer directly depends on `codex-plugin`, `codex-chatgpt`, or `codex-core-plugins`. `Config::to_mcp_config` now keeps user-declared MCP servers but no longer accepts `PluginsManager`, folds plugin MCP servers into the runtime, enables Codex apps, enables skill MCP dependency install, or advertises plugin capability summaries; `TurnContext::apps_enabled()` now returns false so model turns cannot awaken Codex Apps through ChatGPT auth or feature flags; session startup and per-turn context no longer load skills, turns receive an empty `SkillLoadOutcome`, internal `Op::ListSkills` returns empty compatibility entries without loading config layers, plugin roots, skill files, or conversion helpers, the Codex skill watcher has been collapsed to a no-op marker with no file watcher, skill-root registration, cache-clear task, or `SkillsUpdateAvailable` session listener, model turns no longer run skill mention collection, skill env-var prompts, skill MCP dependency installation, skill instruction injection, or implicit skill invocation analytics from shell tools, and the turn prompt/router path no longer loads plugin/app capability summaries, injects available-skill/available-plugin/plugin instruction fragments, parses plugin/app mentions, records app/plugin invocation telemetry, or filters MCP tools through Codex app connectors. The TUI app connector product path is also deleted: no `/apps` slash command, app-link view, connector AppEvent variants, app connector cache/popup/refresh loop, app mention insertion, `app://` mention codec support, stale app-popup tests, or TUI browser-opening shim remains. The `app/list` route and `app/list/updated` notification are gone from app-server protocol, generated schemas, app-server dispatch, test helpers, and docs; `AppInfo`/app-list metadata schema structs are deleted; the orphaned `codex-connectors` crate and `core::connectors` shim are deleted from the workspace; Codex app analytics no longer tracks `codex_app_mentioned` / `codex_app_used` facts, events, reducer arms, client APIs, or dedupe cache state; `[apps.*]`, `Feature::Apps`, `include_apps_instructions`, app config/read schemas, app managed requirements, app prompt tests, and app file-MCP tests are gone; `Feature::Plugins`, `Feature::RemotePlugin`, `plugin://` structured mentions, plugin instruction tags, and stale plugin popup snapshots are gone too; `[plugins]` / `[marketplaces]`, `PluginConfig`, `MarketplaceConfig`, marketplace edit helpers, stale plugin/external-agent README route claims, and generated schema entries are removed from config; and the bundled `codex-skills` sample-skill crate plus embedded imagegen/openai-docs/plugin-creator/skill-creator/skill-installer payloads are deleted from the workspace. Live MCP tool approval is named `McpToolApproval`, not `AppToolApproval`, and remains under MCP server config; live structured tool mentions are MCP/skill-shaped only. `codex_message_processor.rs` is about 9,637 lines; root `message_processor.rs` is about 1,292 lines after the external-agent/config-product cuts; `epiphany_read_routes.rs` is about 579 lines after the full view and read-response extractions; `epiphany_mutation_routes.rs` is about 694 lines after route-load/notification helper cuts and product-surface starvation; `epiphany_state_helpers.rs` is down to a 19-line rollout-state loader; and `codex_thread.rs` is about 1,425 lines after state-update law moved native. `epiphany-openai-adapter` defines CultCache `DatabaseEntry` request/event/receipt/auth-status documents with no Codex app-server or generic JSON dependency. `epiphany-openai-codex-spine` owns all direct Codex auth/model-transport imports for the native OpenAI path: it exposes `default_codex_home` and `auth_manager`, projects `AuthManager` / `CodexAuth` into typed `EpiphanyOpenAiAdapterStatus`, maps typed `EpiphanyOpenAiModelRequest` into Codex API `ResponsesApiRequest`, resolves auth/provider through keeper Codex crates, opens HTTP Responses streams through `codex-api`, maps deltas / completion into typed stream events and receipts, and no longer directly depends on `codex-app-server-protocol` just to name auth mode. `epiphany-openai-runtime` no longer depends directly on `codex-login`; it writes OpenAI status/request/stream-event/receipt records plus runtime sessions/jobs/results/events into `epiphany-core::runtime_spine_cache`, can emit the assistant text artifact for legacy result consumers, is now the default executor for startup-only repo birth specialists, and now has `run-worker` to load a durable `EpiphanyRuntimeWorkerLaunchRequest`, call the typed OpenAI runtime through the spine, persist typed `EpiphanyRuntimeRoleWorkerResult` / `EpiphanyRuntimeReorientWorkerResult` documents, and complete the original heartbeat/specialist runtime job without Codex worker execution; `codex exec` survives only as explicit fallback in repo-birth startup. `epiphany-mvp-coordinator` now invokes `epiphany-openai-runtime run-worker` for launched runtime job ids and no longer creates a second coordinator-owned shadow runtime job/result as a compensator. `epiphany-core::plan_runtime_spine_heartbeat_launch` validates launch contracts/conflicts and projects durable job bindings/runtime links; `epiphany-core::open_runtime_spine_heartbeat_job` owns the initialize-runtime/ensure-session/create-job sequence and now persists `EpiphanyRuntimeWorkerLaunchRequest` CultCache records keyed by runtime job id, with indexed kind/contract fields plus MessagePack-encoded typed launch documents instead of discarding work intent after queue receipt creation; `roleResult` and `reorientResult` now prefer typed worker result documents and fall back only to generic job summaries for older receipts; `epiphany-core::EpiphanyStateUpdate`, `epiphany_state_update_validation_errors`, and `apply_epiphany_state_update` own state-update document shape and mutation law while `codex-core` calls them for compatibility. Vendored `CodexThread::epiphany_launch_job` is now mostly revision check, persistence validation, launch request handoff, and rollout/session writeback for the compatibility route. Vendored `codex-core` no longer has `epiphany_distillation`, `epiphany_promotion`, `epiphany_proposal`, or `epiphany_retrieval` husk modules; it re-exports native surfaces from `epiphany-core` directly, and now owns only the real Codex rollout adapter because it is a host seam. `epiphany-runtime-spine` advertises OpenAI adapter status/model-request/stream-event/receipt CultNet schemas and mutation contracts, so the native caller now has a real storage route instead of only JSON-RPC. MCP itself is correctly JSON at its protocol edge; the target is typed Epiphany intent/result/receipt wrappers around MCP, not replacing MCP JSON. The current OpenAI spine still pulls `codex-api` and a large transport dependency stack, so its next cut is dependency starvation after richer live callers move. + summary: The Codex starvation pass has five typing receipts, forty-six processor/foundation cuts, a real physical extraction in `epiphany-codex-bridge`, a root `epiphany-state-model` crate for durable Epiphany state, a source-grounded Codex auth spine inventory, the native `epiphany-openai-adapter` document boundary, a buildable Codex auth/model wrapper in `epiphany-openai-codex-spine`, the first native runtime caller in `epiphany-openai-runtime`, native heartbeat launch planning/job opening in `epiphany-core`, native state-update contract/validation/application in `epiphany-core`, native exact retrieval path matching in `epiphany-core`, and the route-facing mutation/view/coordinator projection services in `epiphany-codex-bridge`. `codex-protocol` no longer defines the durable `Epiphany*` state structs; it re-exports the native model for legacy rollout/API compatibility while `epiphany-core` imports the native model directly. `epiphany-core` now has no direct vendored Codex dependency: pressure derivation accepts native `EpiphanyTokenUsageSnapshot`, Codex rollout replay moved to `codex-core::epiphany_rollout`, and exact retrieval search uses Epiphany-owned workspace walking/path scoring instead of `codex-file-search`. The bridge owns Codex-facing Epiphany adapters for scene, jobs, context/planning/graph query, retrieval/indexing projection, result projection, runtime-spine result adaptation, launch/prompt doctrine, mutation document mechanics, mutation service update/promote/role-accept/reorient-accept/role-launch/reorient-launch/job-launch/job-interrupt application, live-state projection, pressure/pre-compaction rendering, freshness/reorientation projection, CRRC/coordinator/role-board projection, watcher invalidation adaptation, full `thread/epiphany/view` response construction, freshness/context/graph-query response construction, role/reorient result response construction, distill/propose patch-response construction, coordinator status/view construction, and acceptance/evidence signal helpers. Vendored app-server no longer retains root Epiphany modules; `codex_message_processor.rs` still contains route dispatch, JSON-RPC response shaping, watcher registration/snapshotting calls, and notification emission, but its root no longer imports the evacuated Epiphany policy/protocol registry or owns the watcher invalidation manager. Codex product surfaces for apps, skills, plugins, marketplace, and external agent config import are now inert in the app-server compatibility path: list routes return empty lists, mutation/detail/import routes report disabled, `externalAgentConfig/detect` returns no import candidates, helper/import modules and stale implementation-shape tests were deleted, runtime feature enablement no longer supports `apps` or `plugins`, config writes no longer emit plugin-toggle analytics, plugin/skill cache invalidation on config writes is gone, plugin startup warmups and app-list refreshes were removed, and app-server no longer directly depends on `codex-plugin`, `codex-chatgpt`, or `codex-core-plugins`. `Config::to_mcp_config` now keeps user-declared MCP servers but no longer accepts `PluginsManager`, folds plugin MCP servers into the runtime, enables Codex apps, enables skill MCP dependency install, or advertises plugin capability summaries; `TurnContext::apps_enabled()` now returns false so model turns cannot awaken Codex Apps through ChatGPT auth or feature flags; session startup and per-turn context no longer load skills, turns receive an empty `SkillLoadOutcome`, internal `Op::ListSkills` returns empty compatibility entries without loading config layers, plugin roots, skill files, or conversion helpers, the Codex skill watcher has been collapsed to a no-op marker with no file watcher, skill-root registration, cache-clear task, or `SkillsUpdateAvailable` session listener, model turns no longer run skill mention collection, skill env-var prompts, skill MCP dependency installation, skill instruction injection, or implicit skill invocation analytics from shell tools, and the turn prompt/router path no longer loads plugin/app capability summaries, injects available-skill/available-plugin/plugin instruction fragments, parses plugin/app mentions, records app/plugin invocation telemetry, or filters MCP tools through Codex app connectors. Skill mutation/notification is gone from the app-server edge too: `skills/config/write`, `skills/changed`, `EventMsg::SkillsUpdateAvailable`, the disabled handler, TUI refresh reactions, and fake live-reload/developer-message tests were deleted; only inert `skills/list` compatibility projection remains. The TUI app connector product path is also deleted: no `/apps` slash command, app-link view, connector AppEvent variants, app connector cache/popup/refresh loop, app mention insertion, `app://` mention codec support, stale app-popup tests, or TUI browser-opening shim remains. The `app/list` route and `app/list/updated` notification are gone from app-server protocol, generated schemas, app-server dispatch, test helpers, and docs; `AppInfo`/app-list metadata schema structs are deleted; the orphaned `codex-connectors` crate and `core::connectors` shim are deleted from the workspace; Codex app analytics no longer tracks `codex_app_mentioned` / `codex_app_used` facts, events, reducer arms, client APIs, or dedupe cache state; `[apps.*]`, `Feature::Apps`, `include_apps_instructions`, app config/read schemas, app managed requirements, app prompt tests, and app file-MCP tests are gone; `Feature::Plugins`, `Feature::RemotePlugin`, `plugin://` structured mentions, plugin instruction tags, and stale plugin popup snapshots are gone too; `[plugins]` / `[marketplaces]`, `PluginConfig`, `MarketplaceConfig`, marketplace edit helpers, stale plugin/external-agent README route claims, and generated schema entries are removed from config; and the bundled `codex-skills` sample-skill crate plus embedded imagegen/openai-docs/plugin-creator/skill-creator/skill-installer payloads are deleted from the workspace. Live MCP tool approval is named `McpToolApproval`, not `AppToolApproval`, and remains under MCP server config; live structured tool mentions are MCP/skill-shaped only. `codex_message_processor.rs` is about 9,637 lines; root `message_processor.rs` is about 1,292 lines after the external-agent/config-product cuts; `epiphany_read_routes.rs` is about 579 lines after the full view and read-response extractions; `epiphany_mutation_routes.rs` is about 694 lines after route-load/notification helper cuts and product-surface starvation; `epiphany_state_helpers.rs` is down to a 19-line rollout-state loader; and `codex_thread.rs` is about 1,425 lines after state-update law moved native. `epiphany-openai-adapter` defines CultCache `DatabaseEntry` request/event/receipt/auth-status documents with no Codex app-server or generic JSON dependency. `epiphany-openai-codex-spine` owns all direct Codex auth/model-transport imports for the native OpenAI path: it exposes `default_codex_home` and `auth_manager`, projects `AuthManager` / `CodexAuth` into typed `EpiphanyOpenAiAdapterStatus`, maps typed `EpiphanyOpenAiModelRequest` into Codex API `ResponsesApiRequest`, resolves auth/provider through keeper Codex crates, opens HTTP Responses streams through `codex-api`, maps deltas / completion into typed stream events and receipts, and no longer directly depends on `codex-app-server-protocol` just to name auth mode. `epiphany-openai-runtime` no longer depends directly on `codex-login`; it writes OpenAI status/request/stream-event/receipt records plus runtime sessions/jobs/results/events into `epiphany-core::runtime_spine_cache`, can emit the assistant text artifact for legacy result consumers, is now the default executor for startup-only repo birth specialists, and now has `run-worker` to load a durable `EpiphanyRuntimeWorkerLaunchRequest`, call the typed OpenAI runtime through the spine, persist typed `EpiphanyRuntimeRoleWorkerResult` / `EpiphanyRuntimeReorientWorkerResult` documents, and complete the original heartbeat/specialist runtime job without Codex worker execution; `codex exec` survives only as explicit fallback in repo-birth startup. `epiphany-mvp-coordinator` now invokes `epiphany-openai-runtime run-worker` for launched runtime job ids and no longer creates a second coordinator-owned shadow runtime job/result as a compensator. `epiphany-core::plan_runtime_spine_heartbeat_launch` validates launch contracts/conflicts and projects durable job bindings/runtime links; `epiphany-core::open_runtime_spine_heartbeat_job` owns the initialize-runtime/ensure-session/create-job sequence and now persists `EpiphanyRuntimeWorkerLaunchRequest` CultCache records keyed by runtime job id, with indexed kind/contract fields plus MessagePack-encoded typed launch documents instead of discarding work intent after queue receipt creation; `roleResult` and `reorientResult` now prefer typed worker result documents and fall back only to generic job summaries for older receipts; `epiphany-core::EpiphanyStateUpdate`, `epiphany_state_update_validation_errors`, and `apply_epiphany_state_update` own state-update document shape and mutation law while `codex-core` calls them for compatibility. Vendored `CodexThread::epiphany_launch_job` is now mostly revision check, persistence validation, launch request handoff, and rollout/session writeback for the compatibility route. Vendored `codex-core` no longer has `epiphany_distillation`, `epiphany_promotion`, `epiphany_proposal`, or `epiphany_retrieval` husk modules; it re-exports native surfaces from `epiphany-core` directly, and now owns only the real Codex rollout adapter because it is a host seam. `epiphany-runtime-spine` advertises OpenAI adapter status/model-request/stream-event/receipt CultNet schemas and mutation contracts, so the native caller now has a real storage route instead of only JSON-RPC. MCP itself is correctly JSON at its protocol edge; the target is typed Epiphany intent/result/receipt wrappers around MCP, not replacing MCP JSON. The current OpenAI spine still pulls `codex-api` and a large transport dependency stack, so its next cut is dependency starvation after richer live callers move. latest_cut: > Codex Apps no longer have privileged MCP/runtime treatment in the keeper path. MCP exposure is now uniform: small tool sets are direct, large or @@ -376,6 +376,11 @@ current_status: The bundled `codex-skills` crate is gone as well: no embedded sample skill payloads are installed into `CODEX_HOME/skills/.system`; the old cache path remains only so stale cached samples can be removed. + The dead skill mutation/notification surface is also gone: + `skills/config/write`, `skills/changed`, `EventMsg::SkillsUpdateAvailable`, + app-server disabled/notification handlers, TUI refresh reactions, generated + schema entries, and stale live-reload/developer-message tests were deleted; + only inert `skills/list` compatibility projection remains. MCP remains JSON-RPC at the edge; user-declared MCP servers are the only runtime MCP authority. next_action: Continue starving coordinator/runtime execution and operator surfaces off app-server JSON-RPC and out of `codex_message_processor.rs`; keep the vestigial Codex organ narrowed to subscription auth/model transport. 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 d1174a05..1be3fa06 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,80 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "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].", @@ -84,10 +16,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).", @@ -104,11 +36,79 @@ ] } }, - "required": [ - "callId", - "conversationId", - "fileChanges" - ], - "title": "ApplyPatchApprovalParams", - "type": "object" + "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" + } + } } \ 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 84c36edf..d672a062 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,7 +1,22 @@ { "$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" @@ -9,116 +24,101 @@ "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.", - "properties": { - "approved_execpolicy_amendment": { - "properties": { - "proposed_execpolicy_amendment": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "proposed_execpolicy_amendment" - ], - "type": "object" - } - }, + "type": "object", "required": [ "approved_execpolicy_amendment" ], - "title": "ApprovedExecpolicyAmendmentReviewDecision", - "type": "object" + "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" - ], - "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" + } } }, - "required": [ - "network_policy_amendment" - ], - "title": "NetworkPolicyAmendmentReviewDecision", - "type": "object" + "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" - ], - "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 8b320fd6..81616f49 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,18 +1,10 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "ChatgptAuthTokensRefreshReason": { - "oneOf": [ - { - "description": "Codex attempted a backend request and received `401 Unauthorized`.", - "enum": [ - "unauthorized" - ], - "type": "string" - } - ] - } - }, + "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`).", @@ -25,9 +17,17 @@ "$ref": "#/definitions/ChatgptAuthTokensRefreshReason" } }, - "required": [ - "reason" - ], - "title": "ChatgptAuthTokensRefreshParams", - "type": "object" + "definitions": { + "ChatgptAuthTokensRefreshReason": { + "oneOf": [ + { + "description": "Codex attempted a backend request and received `401 Unauthorized`.", + "type": "string", + "enum": [ + "unauthorized" + ] + } + ] + } + } } \ 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 6d88e784..30956ff5 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,5 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ChatgptAuthTokensRefreshResponse", + "type": "object", + "required": [ + "accessToken", + "chatgptAccountId" + ], "properties": { "accessToken": { "type": "string" @@ -13,11 +19,5 @@ "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 dde0b31f..a9be2746 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": [ { - "properties": { - "method": { - "enum": [ - "initialized" - ], - "title": "InitializedNotificationMethod", - "type": "string" - } - }, + "type": "object", "required": [ "method" ], - "title": "InitializedNotification", - "type": "object" + "properties": { + "method": { + "type": "string", + "enum": [ + "initialized" + ], + "title": "InitializedNotificationMethod" + } + }, + "title": "InitializedNotification" } - ], - "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 e5f98895..2542f142 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,41 +1,1496 @@ { "$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": [ + "skills/list" + ], + "title": "Skills/listRequestMethod" + }, + "params": { + "$ref": "#/definitions/SkillsListParams" + } + }, + "title": "Skills/listRequest" + }, + { + "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" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "granular" + ], "properties": { "granular": { + "type": "object", + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -54,54 +1509,50 @@ "default": false, "type": "boolean" } - }, - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "type": "object" + } } }, - "required": [ - "granular" - ], - "title": "GranularAskForApproval", - "type": "object" + "additionalProperties": false, + "title": "GranularAskForApproval" } ] }, "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "CancelLoginAccountParams": { + "type": "object", + "required": [ + "loginId" + ], "properties": { "loginId": { "type": "string" } - }, - "required": [ - "loginId" - ], - "type": "object" + } }, "ClientInfo": { + "type": "object", + "required": [ + "name", + "version" + ], "properties": { "name": { "type": "string" @@ -115,15 +1566,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" @@ -131,22 +1582,42 @@ "settings": { "$ref": "#/definitions/Settings" } - }, + } + }, + "WindowsSandboxSetupStartParams": { + "type": "object", "required": [ - "mode", - "settings" + "mode" ], - "type": "object" + "properties": { + "cwd": { + "anyOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + }, + { + "type": "null" + } + ] + }, + "mode": { + "$ref": "#/definitions/WindowsSandboxSetupMode" + } + } }, "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.", @@ -164,26 +1635,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.", @@ -193,6 +1664,7 @@ ] }, "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" @@ -200,10 +1672,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" @@ -211,8 +1683,7 @@ { "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`.", @@ -224,81 +1695,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.", - "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" - } - }, + "type": "object", "required": [ "cols", "rows" ], - "type": "object" + "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 + } + } }, "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" - ], - "type": "object" + } }, "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.", @@ -315,19 +1786,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": [ @@ -346,13 +1817,15 @@ "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" @@ -361,15 +1834,10 @@ "$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).", @@ -382,10 +1850,15 @@ "default": false, "type": "boolean" } - }, - "type": "object" + } }, "ConfigValueWriteParams": { + "type": "object", + "required": [ + "keyPath", + "mergeStrategy", + "value" + ], "properties": { "expectedVersion": { "type": [ @@ -407,37 +1880,36 @@ "$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", - "type": "string" + "title": "InputTextContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextContentItem", - "type": "object" + "title": "InputTextContentItem" }, { + "type": "object", + "required": [ + "image_url", + "type" + ], "properties": { "detail": { "anyOf": [ @@ -453,44 +1925,44 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "input_image" ], - "title": "InputImageContentItemType", - "type": "string" + "title": "InputImageContentItemType" } }, - "required": [ - "image_url", - "type" - ], - "title": "InputImageContentItem", - "type": "object" + "title": "InputImageContentItem" }, { + "type": "object", + "required": [ + "text", + "type" + ], "properties": { "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "output_text" ], - "title": "OutputTextContentItemType", - "type": "string" + "title": "OutputTextContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "OutputTextContentItem", - "type": "object" + "title": "OutputTextContentItem" } ] }, "DeviceKeyCreateParams": { "description": "Create a controller-local device key with a random key id.", + "type": "object", + "required": [ + "accountUserId", + "clientId" + ], "properties": { "accountUserId": { "type": "string" @@ -499,6 +1971,7 @@ "type": "string" }, "protectionPolicy": { + "description": "Defaults to `hardware_only` when omitted.", "anyOf": [ { "$ref": "#/definitions/DeviceKeyProtectionPolicy" @@ -506,38 +1979,37 @@ { "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" @@ -545,18 +2017,27 @@ "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" @@ -572,10 +2053,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.", @@ -591,39 +2072,38 @@ }, "tokenExpiresAt": { "description": "Remote-control token expiration as Unix seconds.", - "format": "int64", - "type": "integer" + "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", - "type": "string" + "title": "RemoteControlClientConnectionDeviceKeySignPayloadType" } }, - "required": [ - "accountUserId", - "audience", - "clientId", - "nonce", - "scopes", - "sessionId", - "targetOrigin", - "targetPath", - "tokenExpiresAt", - "tokenSha256Base64url", - "type" - ], - "title": "RemoteControlClientConnectionDeviceKeySignPayload", - "type": "object" + "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" @@ -633,8 +2113,8 @@ }, "challengeExpiresAt": { "description": "Enrollment challenge expiration as Unix seconds.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "challengeId": { "description": "Backend-issued enrollment challenge id that this proof authorizes.", @@ -659,31 +2139,24 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "remoteControlClientEnrollment" ], - "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType", - "type": "string" + "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType" } }, - "required": [ - "accountUserId", - "audience", - "challengeExpiresAt", - "challengeId", - "clientId", - "deviceIdentitySha256Base64url", - "nonce", - "targetOrigin", - "targetPath", - "type" - ], - "title": "RemoteControlClientEnrollmentDeviceKeySignPayload", - "type": "object" + "title": "RemoteControlClientEnrollmentDeviceKeySignPayload" } ] }, "DynamicToolSpec": { + "type": "object", + "required": [ + "description", + "inputSchema", + "name" + ], "properties": { "deferLoading": { "type": "boolean" @@ -701,15 +2174,20 @@ "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" @@ -753,41 +2231,42 @@ "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": [ @@ -796,10 +2275,10 @@ ] }, "evidence_refs": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "horizon": { "type": "string" @@ -811,10 +2290,10 @@ "type": "string" }, "lane_hints": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -823,10 +2302,10 @@ "type": "string" }, "source_refs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "type": "array" + } }, "status": { "type": "string" @@ -843,21 +2322,14 @@ "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" @@ -872,12 +2344,12 @@ "type": "string" }, "unexplained_writes": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "warning": { "type": [ @@ -885,22 +2357,21 @@ "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": [ @@ -912,12 +2383,12 @@ "type": "string" }, "start_line": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "symbol": { "type": [ @@ -925,19 +2396,22 @@ "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" @@ -951,59 +2425,57 @@ "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, - "type": "integer" + "minimum": 0.0 }, "open_gap_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "open_question_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1011,20 +2483,21 @@ "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": [ @@ -1053,59 +2526,58 @@ "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" @@ -1116,20 +2588,21 @@ "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" @@ -1158,15 +2631,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "purpose", - "title" - ], - "type": "object" + } }, "EpiphanyGraphs": { + "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -1175,15 +2643,20 @@ "$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" @@ -1200,15 +2673,16 @@ "status": { "type": "string" } - }, - "required": [ - "description", - "id", - "status" - ], - "type": "object" + } }, "EpiphanyInvestigationCheckpoint": { + "type": "object", + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], "properties": { "captured_at_turn_id": { "type": [ @@ -1220,19 +2694,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" @@ -1247,10 +2721,10 @@ ] }, "open_questions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1258,23 +2732,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": [ @@ -1295,16 +2769,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" @@ -1312,32 +2786,29 @@ "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": [ @@ -1352,31 +2823,36 @@ "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" @@ -1385,25 +2861,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" @@ -1414,18 +2890,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "type": "object" + } }, "EpiphanyObjectiveDraftLanePlan": { + "type": "object", "properties": { "body": { "type": [ @@ -1463,39 +2931,45 @@ "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" @@ -1509,16 +2983,17 @@ "summary": { "type": "string" } - }, - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "type": "object" + } }, "EpiphanyPlanningCapture": { + "type": "object", + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], "properties": { "body": { "type": [ @@ -1551,10 +3026,10 @@ "type": "string" }, "tags": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": "string" @@ -1565,23 +3040,20 @@ "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": [ @@ -1611,10 +3083,10 @@ ] }, "unblocks": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "urgency": { "type": [ @@ -1625,20 +3097,19 @@ "value": { "type": "string" } - }, - "required": [ - "rationale", - "value" - ], - "type": "object" + } }, "EpiphanyPlanningSourceRef": { + "type": "object", + "required": [ + "kind" + ], "properties": { "assignees": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "author": { "type": [ @@ -1659,11 +3130,11 @@ ] }, "database_id": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "external_id": { "type": [ @@ -1684,21 +3155,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": [ @@ -1748,37 +3219,34 @@ "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": [ @@ -1786,25 +3254,31 @@ "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": [ @@ -1827,16 +3301,18 @@ "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" @@ -1848,16 +3324,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" @@ -1874,18 +3350,10 @@ "surface": { "type": "string" } - }, - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "type": "object" + } }, "EpiphanyScratchPad": { + "type": "object", "properties": { "hypothesis": { "type": [ @@ -1900,10 +3368,10 @@ ] }, "notes": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1911,10 +3379,15 @@ "null" ] } - }, - "type": "object" + } }, "EpiphanySubgoal": { + "type": "object", + "required": [ + "id", + "status", + "title" + ], "properties": { "id": { "type": "string" @@ -1931,30 +3404,25 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "status", - "title" - ], - "type": "object" + } }, "ExperimentalFeatureEnablementSetParams": { - "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" - } - }, + "type": "object", "required": [ "enablement" ], - "type": "object" + "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" + } + } + } }, "ExperimentalFeatureListParams": { + "type": "object", "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -1965,29 +3433,33 @@ }, "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" @@ -1999,13 +3471,13 @@ ] }, "tags": { - "additionalProperties": { - "type": "string" - }, "type": [ "object", "null" - ] + ], + "additionalProperties": { + "type": "string" + } }, "threadId": { "type": [ @@ -2013,86 +3485,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", - "type": "string" + "title": "PathFileSystemPathType" } }, - "required": [ - "path", - "type" - ], - "title": "PathFileSystemPath", - "type": "object" + "title": "PathFileSystemPath" }, { + "type": "object", + "required": [ + "pattern", + "type" + ], "properties": { "pattern": { "type": "string" }, "type": { + "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType", - "type": "string" + "title": "GlobPatternFileSystemPathType" } }, - "required": [ - "pattern", - "type" - ], - "title": "GlobPatternFileSystemPath", - "type": "object" + "title": "GlobPatternFileSystemPath" }, { + "type": "object", + "required": [ + "type", + "value" + ], "properties": { "type": { + "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType", - "type": "string" + "title": "SpecialFileSystemPathType" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "required": [ - "type", - "value" - ], - "title": "SpecialFileSystemPath", - "type": "object" + "title": "SpecialFileSystemPath" } ] }, "FileSystemSandboxEntry": { + "type": "object", + "required": [ + "access", + "path" + ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -2100,67 +3572,66 @@ "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": [ @@ -2169,49 +3640,50 @@ ] } }, + "title": "KindFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "KindFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "tmpdir" - ], - "type": "string" + ] } }, + "title": "TmpdirFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "TmpdirFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "slash_tmp" - ], - "type": "string" + ] } }, - "required": [ - "kind" - ], - "title": "SlashTmpFileSystemSpecialPath", - "type": "object" + "title": "SlashTmpFileSystemSpecialPath" }, { + "type": "object", + "required": [ + "kind", + "path" + ], "properties": { "kind": { + "type": "string", "enum": [ "unknown" - ], - "type": "string" + ] }, "path": { "type": "string" @@ -2222,55 +3694,54 @@ "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`.", @@ -2279,65 +3750,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." + ] } - }, - "required": [ - "path" - ], - "type": "object" + } }, "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`.", @@ -2347,12 +3818,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`.", @@ -2361,68 +3832,64 @@ "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": [ @@ -2430,10 +3897,10 @@ "type": "string" }, { + "type": "array", "items": { "$ref": "#/definitions/FunctionCallOutputContentItem" - }, - "type": "array" + } } ] }, @@ -2441,26 +3908,31 @@ "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", - "type": "string" + "title": "InputTextFunctionCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextFunctionCallOutputContentItem", - "type": "object" + "title": "InputTextFunctionCallOutputContentItem" }, { + "type": "object", + "required": [ + "image_url", + "type" + ], "properties": { "detail": { "anyOf": [ @@ -2476,23 +3948,23 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "input_image" ], - "title": "InputImageFunctionCallOutputContentItemType", - "type": "string" + "title": "InputImageFunctionCallOutputContentItemType" } }, - "required": [ - "image_url", - "type" - ], - "title": "InputImageFunctionCallOutputContentItem", - "type": "object" + "title": "InputImageFunctionCallOutputContentItem" } ] }, "FuzzyFileSearchParams": { + "type": "object", + "required": [ + "query", + "roots" + ], "properties": { "cancellationToken": { "type": [ @@ -2504,30 +3976,181 @@ "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": [ + "skill" + ], + "title": "SkillUserInputType" + } + }, + "title": "SkillUserInput" + }, + { + "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": [ - "query", - "roots" + "expectedTurnId", + "input", + "threadId" ], - "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": { + "type": "array", + "items": { + "$ref": "#/definitions/UserInput" + } + }, + "threadId": { + "type": "string" + } + } }, "GetAccountParams": { + "type": "object", "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`.", + "default": false, "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" @@ -2539,56 +4162,54 @@ ] }, "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": { - "default": false, "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`).", - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } } - }, - "type": "object" + } }, "InitializeParams": { + "type": "object", + "required": [ + "clientInfo" + ], "properties": { "capabilities": { "anyOf": [ @@ -2603,13 +4224,10 @@ "clientInfo": { "$ref": "#/definitions/ClientInfo" } - }, - "required": [ - "clientInfo" - ], - "type": "object" + } }, "ListMcpServerStatusParams": { + "type": "object", "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -2619,6 +4237,7 @@ ] }, "detail": { + "description": "Controls how much MCP inventory data to fetch for each server. Defaults to `Full` when omitted.", "anyOf": [ { "$ref": "#/definitions/McpServerStatusDetail" @@ -2626,54 +4245,57 @@ { "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", - "type": "string" + "title": "ExecLocalShellActionType" }, "user": { "type": [ @@ -2688,79 +4310,80 @@ ] } }, - "required": [ - "command", - "type" - ], - "title": "ExecLocalShellAction", - "type": "object" + "title": "ExecLocalShellAction" } ] }, "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", - "type": "string" + "title": "ApiKeyLoginAccountParamsType" } }, - "required": [ - "apiKey", - "type" - ], - "title": "ApiKeyLoginAccountParams", - "type": "object" + "title": "ApiKeyLoginAccountParams" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "chatgpt" ], - "title": "ChatgptLoginAccountParamsType", - "type": "string" + "title": "ChatgptLoginAccountParamsType" } }, + "title": "ChatgptLoginAccountParams" + }, + { + "type": "object", "required": [ "type" ], - "title": "ChatgptLoginAccountParams", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "chatgptDeviceCode" ], - "title": "ChatgptDeviceCodeLoginAccountParamsType", - "type": "string" + "title": "ChatgptDeviceCodeLoginAccountParamsType" } }, - "required": [ - "type" - ], - "title": "ChatgptDeviceCodeLoginAccountParams", - "type": "object" + "title": "ChatgptDeviceCodeLoginAccountParams" }, { "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.", @@ -2778,24 +4401,23 @@ ] }, "type": { + "type": "string", "enum": [ "chatgptAuthTokens" ], - "title": "ChatgptAuthTokensLoginAccountParamsType", - "type": "string" + "title": "ChatgptAuthTokensLoginAccountParamsType" } }, - "required": [ - "accessToken", - "chatgptAccountId", - "type" - ], - "title": "ChatgptAuthTokensLoginAccountParams", - "type": "object" + "title": "ChatgptAuthTokensLoginAccountParams" } ] }, "McpResourceReadParams": { + "type": "object", + "required": [ + "server", + "uri" + ], "properties": { "server": { "type": "string" @@ -2809,48 +4431,49 @@ "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, @@ -2863,49 +4486,174 @@ "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" + } + ] + }, + "summary": { + "description": "Override the reasoning summary for this turn and subsequent turns.", + "anyOf": [ + { + "$ref": "#/definitions/ReasoningSummary" + }, + { + "type": "null" + } + ] + }, + "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" + } + ] + }, + "serviceTier": { + "description": "Override the service tier for this turn and subsequent turns.", + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "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" + } + ] + }, + "threadId": { + "type": "string" + }, + "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.", @@ -2923,24 +4671,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": [ @@ -2962,32 +4710,32 @@ } ] } - }, - "type": "object" + } }, "PermissionProfileFileSystemPermissions": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - }, - "type": "array" - }, - "globScanMaxDepth": { - "format": "uint", - "minimum": 1.0, - "type": [ - "integer", - "null" - ] - } - }, + "type": "object", "required": [ "entries" ], - "type": "object" + "properties": { + "entries": { + "type": "array", + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + } + }, + "globScanMaxDepth": { + "type": [ + "integer", + "null" + ], + "format": "uint", + "minimum": 1.0 + } + } }, "PermissionProfileNetworkPermissions": { + "type": "object", "properties": { "enabled": { "type": [ @@ -2995,20 +4743,23 @@ "null" ] } - }, - "type": "object" + } }, "Personality": { + "type": "string", "enum": [ "none", "friendly", "pragmatic" - ], - "type": "string" + ] }, "ReadOnlyAccess": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "includePlatformDefaults": { "default": true, @@ -3016,51 +4767,48 @@ }, "readableRoots": { "default": [], + "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "restricted" ], - "title": "RestrictedReadOnlyAccessType", - "type": "string" + "title": "RestrictedReadOnlyAccessType" } }, + "title": "RestrictedReadOnlyAccess" + }, + { + "type": "object", "required": [ "type" ], - "title": "RestrictedReadOnlyAccess", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "fullAccess" ], - "title": "FullAccessReadOnlyAccessType", - "type": "string" + "title": "FullAccessReadOnlyAccessType" } }, - "required": [ - "type" - ], - "title": "FullAccessReadOnlyAccess", - "type": "object" + "title": "FullAccessReadOnlyAccess" } ] }, "RealtimeOutputModality": { + "type": "string", "enum": [ "text", "audio" - ], - "type": "string" + ] }, "RealtimeVoice": { + "type": "string", "enum": [ "alloy", "arbor", @@ -3081,11 +4829,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", @@ -3093,74 +4841,73 @@ "medium", "high", "xhigh" - ], - "type": "string" + ] }, "ReasoningItemContent": { "oneOf": [ { + "type": "object", + "required": [ + "text", + "type" + ], "properties": { "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "reasoning_text" ], - "title": "ReasoningTextReasoningItemContentType", - "type": "string" + "title": "ReasoningTextReasoningItemContentType" } }, + "title": "ReasoningTextReasoningItemContent" + }, + { + "type": "object", "required": [ "text", "type" ], - "title": "ReasoningTextReasoningItemContent", - "type": "object" - }, - { "properties": { "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextReasoningItemContentType", - "type": "string" + "title": "TextReasoningItemContentType" } }, - "required": [ - "text", - "type" - ], - "title": "TextReasoningItemContent", - "type": "object" + "title": "TextReasoningItemContent" } ] }, "ReasoningItemReasoningSummary": { "oneOf": [ { + "type": "object", + "required": [ + "text", + "type" + ], "properties": { "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "summary_text" ], - "title": "SummaryTextReasoningItemReasoningSummaryType", - "type": "string" + "title": "SummaryTextReasoningItemReasoningSummaryType" } }, - "required": [ - "text", - "type" - ], - "title": "SummaryTextReasoningItemReasoningSummary", - "type": "object" + "title": "SummaryTextReasoningItemReasoningSummary" } ] }, @@ -3168,35 +4915,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": [ @@ -3204,20 +4951,26 @@ "type": "string" }, { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } ] }, "ResponseItem": { "oneOf": [ { + "type": "object", + "required": [ + "content", + "role", + "type" + ], "properties": { "content": { + "type": "array", "items": { "$ref": "#/definitions/ContentItem" - }, - "type": "array" + } }, "end_turn": { "type": [ @@ -3226,11 +4979,11 @@ ] }, "id": { + "writeOnly": true, "type": [ "string", "null" - ], - "writeOnly": true + ] }, "phase": { "anyOf": [ @@ -3246,32 +4999,31 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "message" ], - "title": "MessageResponseItemType", - "type": "string" + "title": "MessageResponseItemType" } }, - "required": [ - "content", - "role", - "type" - ], - "title": "MessageResponseItem", - "type": "object" + "title": "MessageResponseItem" }, { + "type": "object", + "required": [ + "summary", + "type" + ], "properties": { "content": { "default": null, - "items": { - "$ref": "#/definitions/ReasoningItemContent" - }, "type": [ "array", "null" - ] + ], + "items": { + "$ref": "#/definitions/ReasoningItemContent" + } }, "encrypted_content": { "type": [ @@ -3280,27 +5032,28 @@ ] }, "summary": { + "type": "array", "items": { "$ref": "#/definitions/ReasoningItemReasoningSummary" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningResponseItemType", - "type": "string" + "title": "ReasoningResponseItemType" } }, - "required": [ - "summary", - "type" - ], - "title": "ReasoningResponseItem", - "type": "object" + "title": "ReasoningResponseItem" }, { + "type": "object", + "required": [ + "action", + "status", + "type" + ], "properties": { "action": { "$ref": "#/definitions/LocalShellAction" @@ -3314,32 +5067,33 @@ }, "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", - "type": "string" + "title": "LocalShellCallResponseItemType" } }, - "required": [ - "action", - "status", - "type" - ], - "title": "LocalShellCallResponseItem", - "type": "object" + "title": "LocalShellCallResponseItem" }, { + "type": "object", + "required": [ + "arguments", + "call_id", + "name", + "type" + ], "properties": { "arguments": { "type": "string" @@ -3348,11 +5102,11 @@ "type": "string" }, "id": { + "writeOnly": true, "type": [ "string", "null" - ], - "writeOnly": true + ] }, "name": { "type": "string" @@ -3364,23 +5118,22 @@ ] }, "type": { + "type": "string", "enum": [ "function_call" ], - "title": "FunctionCallResponseItemType", - "type": "string" + "title": "FunctionCallResponseItemType" } }, - "required": [ - "arguments", - "call_id", - "name", - "type" - ], - "title": "FunctionCallResponseItem", - "type": "object" + "title": "FunctionCallResponseItem" }, { + "type": "object", + "required": [ + "arguments", + "execution", + "type" + ], "properties": { "arguments": true, "call_id": { @@ -3393,11 +5146,11 @@ "type": "string" }, "id": { + "writeOnly": true, "type": [ "string", "null" - ], - "writeOnly": true + ] }, "status": { "type": [ @@ -3406,22 +5159,22 @@ ] }, "type": { + "type": "string", "enum": [ "tool_search_call" ], - "title": "ToolSearchCallResponseItemType", - "type": "string" + "title": "ToolSearchCallResponseItemType" } }, - "required": [ - "arguments", - "execution", - "type" - ], - "title": "ToolSearchCallResponseItem", - "type": "object" + "title": "ToolSearchCallResponseItem" }, { + "type": "object", + "required": [ + "call_id", + "output", + "type" + ], "properties": { "call_id": { "type": "string" @@ -3430,32 +5183,33 @@ "$ref": "#/definitions/FunctionCallOutputBody" }, "type": { + "type": "string", "enum": [ "function_call_output" ], - "title": "FunctionCallOutputResponseItemType", - "type": "string" + "title": "FunctionCallOutputResponseItemType" } }, - "required": [ - "call_id", - "output", - "type" - ], - "title": "FunctionCallOutputResponseItem", - "type": "object" + "title": "FunctionCallOutputResponseItem" }, { + "type": "object", + "required": [ + "call_id", + "input", + "name", + "type" + ], "properties": { "call_id": { "type": "string" }, "id": { + "writeOnly": true, "type": [ "string", "null" - ], - "writeOnly": true + ] }, "input": { "type": "string" @@ -3470,23 +5224,22 @@ ] }, "type": { + "type": "string", "enum": [ "custom_tool_call" ], - "title": "CustomToolCallResponseItemType", - "type": "string" + "title": "CustomToolCallResponseItemType" } }, - "required": [ - "call_id", - "input", - "name", - "type" - ], - "title": "CustomToolCallResponseItem", - "type": "object" + "title": "CustomToolCallResponseItem" }, { + "type": "object", + "required": [ + "call_id", + "output", + "type" + ], "properties": { "call_id": { "type": "string" @@ -3501,22 +5254,23 @@ "$ref": "#/definitions/FunctionCallOutputBody" }, "type": { + "type": "string", "enum": [ "custom_tool_call_output" ], - "title": "CustomToolCallOutputResponseItemType", - "type": "string" + "title": "CustomToolCallOutputResponseItemType" } }, - "required": [ - "call_id", - "output", - "type" - ], - "title": "CustomToolCallOutputResponseItem", - "type": "object" + "title": "CustomToolCallOutputResponseItem" }, { + "type": "object", + "required": [ + "execution", + "status", + "tools", + "type" + ], "properties": { "call_id": { "type": [ @@ -3531,27 +5285,24 @@ "type": "string" }, "tools": { - "items": true, - "type": "array" + "type": "array", + "items": true }, "type": { + "type": "string", "enum": [ "tool_search_output" ], - "title": "ToolSearchOutputResponseItemType", - "type": "string" + "title": "ToolSearchOutputResponseItemType" } }, - "required": [ - "execution", - "status", - "tools", - "type" - ], - "title": "ToolSearchOutputResponseItem", - "type": "object" + "title": "ToolSearchOutputResponseItem" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "action": { "anyOf": [ @@ -3564,11 +5315,11 @@ ] }, "id": { + "writeOnly": true, "type": [ "string", "null" - ], - "writeOnly": true + ] }, "status": { "type": [ @@ -3577,20 +5328,23 @@ ] }, "type": { + "type": "string", "enum": [ "web_search_call" ], - "title": "WebSearchCallResponseItemType", - "type": "string" + "title": "WebSearchCallResponseItemType" } }, - "required": [ - "type" - ], - "title": "WebSearchCallResponseItem", - "type": "object" + "title": "WebSearchCallResponseItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -3608,92 +5362,89 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "image_generation_call" ], - "title": "ImageGenerationCallResponseItemType", - "type": "string" + "title": "ImageGenerationCallResponseItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationCallResponseItem", - "type": "object" + "title": "ImageGenerationCallResponseItem" }, { + "type": "object", + "required": [ + "ghost_commit", + "type" + ], "properties": { "ghost_commit": { "$ref": "#/definitions/GhostCommit" }, "type": { + "type": "string", "enum": [ "ghost_snapshot" ], - "title": "GhostSnapshotResponseItemType", - "type": "string" + "title": "GhostSnapshotResponseItemType" } }, - "required": [ - "ghost_commit", - "type" - ], - "title": "GhostSnapshotResponseItem", - "type": "object" + "title": "GhostSnapshotResponseItem" }, { + "type": "object", + "required": [ + "encrypted_content", + "type" + ], "properties": { "encrypted_content": { "type": "string" }, "type": { + "type": "string", "enum": [ "compaction" ], - "title": "CompactionResponseItemType", - "type": "string" + "title": "CompactionResponseItemType" } }, - "required": [ - "encrypted_content", - "type" - ], - "title": "CompactionResponseItem", - "type": "object" + "title": "CompactionResponseItem" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherResponseItemType", - "type": "string" + "title": "OtherResponseItemType" } }, - "required": [ - "type" - ], - "title": "OtherResponseItem", - "type": "object" + "title": "OtherResponseItem" } ] }, "ResponsesApiWebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -3702,27 +5453,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchResponsesApiWebSearchActionType", - "type": "string" + "title": "SearchResponsesApiWebSearchActionType" } }, + "title": "SearchResponsesApiWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchResponsesApiWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "open_page" ], - "title": "OpenPageResponsesApiWebSearchActionType", - "type": "string" + "title": "OpenPageResponsesApiWebSearchActionType" }, "url": { "type": [ @@ -3731,13 +5482,13 @@ ] } }, + "title": "OpenPageResponsesApiWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageResponsesApiWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -3746,11 +5497,11 @@ ] }, "type": { + "type": "string", "enum": [ "find_in_page" ], - "title": "FindInPageResponsesApiWebSearchActionType", - "type": "string" + "title": "FindInPageResponsesApiWebSearchActionType" }, "url": { "type": [ @@ -3759,40 +5510,43 @@ ] } }, + "title": "FindInPageResponsesApiWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageResponsesApiWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherResponsesApiWebSearchActionType", - "type": "string" + "title": "OtherResponsesApiWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherResponsesApiWebSearchAction", - "type": "object" + "title": "OtherResponsesApiWebSearchAction" } ] }, "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" @@ -3800,9 +5554,7 @@ { "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" @@ -3810,55 +5562,55 @@ "threadId": { "type": "string" } - }, - "required": [ - "target", - "threadId" - ], - "type": "object" + } }, "ReviewTarget": { "oneOf": [ { "description": "Review the working tree: staged, unstaged, and untracked files.", - "properties": { - "type": { - "enum": [ - "uncommittedChanges" - ], - "title": "UncommittedChangesReviewTargetType", - "type": "string" - } - }, + "type": "object", "required": [ "type" ], - "title": "UncommittedChangesReviewTarget", - "type": "object" + "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", - "type": "string" + "title": "BaseBranchReviewTargetType" } }, - "required": [ - "branch", - "type" - ], - "title": "BaseBranchReviewTarget", - "type": "object" + "title": "BaseBranchReviewTarget" }, { "description": "Review the changes introduced by a specific commit.", + "type": "object", + "required": [ + "sha", + "type" + ], "properties": { "sha": { "type": "string" @@ -3871,124 +5623,123 @@ ] }, "type": { + "type": "string", "enum": [ "commit" ], - "title": "CommitReviewTargetType", - "type": "string" + "title": "CommitReviewTargetType" } }, - "required": [ - "sha", - "type" - ], - "title": "CommitReviewTarget", - "type": "object" + "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", - "type": "string" + "title": "CustomReviewTargetType" } }, - "required": [ - "instructions", - "type" - ], - "title": "CustomReviewTarget", - "type": "object" + "title": "CustomReviewTarget" } ] }, "SandboxMode": { + "type": "string", "enum": [ "read-only", "workspace-write", "danger-full-access" - ], - "type": "string" + ] }, "SandboxPolicy": { "oneOf": [ { - "properties": { - "type": { - "enum": [ - "dangerFullAccess" - ], - "title": "DangerFullAccessSandboxPolicyType", - "type": "string" - } - }, + "type": "object", "required": [ "type" ], - "title": "DangerFullAccessSandboxPolicy", - "type": "object" + "properties": { + "type": { + "type": "string", + "enum": [ + "dangerFullAccess" + ], + "title": "DangerFullAccessSandboxPolicyType" + } + }, + "title": "DangerFullAccessSandboxPolicy" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "access": { + "default": { + "type": "fullAccess" + }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ], - "default": { - "type": "fullAccess" - } + ] }, "networkAccess": { "default": false, "type": "boolean" }, "type": { + "type": "string", "enum": [ "readOnly" ], - "title": "ReadOnlySandboxPolicyType", - "type": "string" + "title": "ReadOnlySandboxPolicyType" } }, + "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", - "type": "string" + "title": "ExternalSandboxSandboxPolicyType" } }, + "title": "ExternalSandboxSandboxPolicy" + }, + { + "type": "object", "required": [ "type" ], - "title": "ExternalSandboxSandboxPolicy", - "type": "object" - }, - { "properties": { "excludeSlashTmp": { "default": false, @@ -4003,58 +5754,58 @@ "type": "boolean" }, "readOnlyAccess": { + "default": { + "type": "fullAccess" + }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ], - "default": { - "type": "fullAccess" - } + ] }, "type": { + "type": "string", "enum": [ "workspaceWrite" ], - "title": "WorkspaceWriteSandboxPolicyType", - "type": "string" + "title": "WorkspaceWriteSandboxPolicyType" }, "writableRoots": { "default": [], + "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" + } } }, - "required": [ - "type" - ], - "title": "WorkspaceWriteSandboxPolicy", - "type": "object" + "title": "WorkspaceWriteSandboxPolicy" } ] }, "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": [ @@ -4075,102 +5826,73 @@ } ] } - }, - "required": [ - "model" - ], - "type": "object" - }, - "SkillsConfigWriteParams": { - "properties": { - "enabled": { - "type": "boolean" - }, - "name": { - "description": "Name-based selector.", - "type": [ - "string", - "null" - ] - }, - "path": { - "anyOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - }, - { - "type": "null" - } - ], - "description": "Path-based selector." - } - }, - "required": [ - "enabled" - ], - "type": "object" + } }, "SkillsListExtraRootsForCwd": { + "type": "object", + "required": [ + "cwd", + "extraUserRoots" + ], "properties": { "cwd": { "type": "string" }, "extraUserRoots": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } } - }, - "required": [ - "cwd", - "extraUserRoots" - ], - "type": "object" + } }, "SkillsListParams": { + "type": "object", "properties": { "cwds": { "description": "When empty, defaults to the current session working directory.", + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "forceReload": { "description": "When true, bypass the skills cache and re-scan skills from disk.", "type": "boolean" }, "perCwdExtraUserRoots": { - "default": null, "description": "Optional per-cwd extra roots to scan as user-scoped skills.", - "items": { - "$ref": "#/definitions/SkillsListExtraRootsForCwd" - }, + "default": null, "type": [ "array", "null" - ] + ], + "items": { + "$ref": "#/definitions/SkillsListExtraRootsForCwd" + } } - }, - "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.", @@ -4179,13 +5901,14 @@ "null" ] } - }, - "required": [ - "byteRange" - ], - "type": "object" + } }, "ThreadApproveGuardianDeniedActionParams": { + "type": "object", + "required": [ + "event", + "threadId" + ], "properties": { "event": { "description": "Serialized `codex_protocol::protocol::GuardianAssessmentEvent`." @@ -4193,47 +5916,137 @@ "threadId": { "type": "string" } - }, - "required": [ - "event", - "threadId" - ], - "type": "object" + } }, "ThreadArchiveParams": { + "type": "object", + "required": [ + "threadId" + ], "properties": { "threadId": { "type": "string" } - }, + } + }, + "TurnInterruptParams": { + "type": "object", "required": [ - "threadId" + "threadId", + "turnId" ], - "type": "object" + "properties": { + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + } }, "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" ], - "type": "object" - }, - "ThreadEpiphanyGraphQuery": { "properties": { - "depth": { - "description": "Defaults to 1 and is capped by the server.", - "format": "uint32", - "minimum": 0.0, + "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": [ - "integer", + "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" + } + } + }, + "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" @@ -4241,20 +6054,19 @@ { "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.", @@ -4267,63 +6079,612 @@ "$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" ], - "type": "string" + "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 + } + } }, "ThreadEpiphanyRoleId": { + "type": "string", "enum": [ "implementation", "imagination", "modeling", "verification", "reorientation" + ] + }, + "ThreadMemoryMode": { + "type": "string", + "enum": [ + "enabled", + "disabled" + ] + }, + "ThreadRealtimeAudioChunk": { + "description": "EXPERIMENTAL - thread realtime audio chunk.", + "type": "object", + "required": [ + "data", + "numChannels", + "sampleRate" ], - "type": "string" + "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" + } + } }, "ThreadEpiphanyUpdatePatch": { + "type": "object", "properties": { "acceptanceReceipts": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyAcceptanceReceipt" - }, - "type": "array" + } }, "activeSubgoalId": { "type": [ @@ -4342,10 +6703,10 @@ ] }, "evidence": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - }, - "type": "array" + } }, "graphCheckpoint": { "anyOf": [ @@ -4378,13 +6739,13 @@ ] }, "invariants": { - "items": { - "$ref": "#/definitions/EpiphanyInvariant" - }, "type": [ "array", "null" - ] + ], + "items": { + "$ref": "#/definitions/EpiphanyInvariant" + } }, "investigationCheckpoint": { "anyOf": [ @@ -4397,13 +6758,13 @@ ] }, "jobBindings": { - "items": { - "$ref": "#/definitions/EpiphanyJobBinding" - }, "type": [ "array", "null" - ] + ], + "items": { + "$ref": "#/definitions/EpiphanyJobBinding" + } }, "mode": { "anyOf": [ @@ -4422,10 +6783,10 @@ ] }, "observations": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - }, - "type": "array" + } }, "planning": { "anyOf": [ @@ -4438,10 +6799,10 @@ ] }, "runtimeLinks": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - }, - "type": "array" + } }, "scratch": { "anyOf": [ @@ -4454,18 +6815,18 @@ ] }, "subgoals": { - "items": { - "$ref": "#/definitions/EpiphanySubgoal" - }, "type": [ "array", "null" - ] + ], + "items": { + "$ref": "#/definitions/EpiphanySubgoal" + } } - }, - "type": "object" + } }, "ThreadEpiphanyViewLens": { + "type": "string", "enum": [ "scene", "jobs", @@ -4475,18 +6836,50 @@ "reorient", "crrc", "coordinator" - ], - "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" + ] + } + } }, "ThreadEpiphanyWorkerLaunchDocument": { "oneOf": [ { + "type": "object", + "required": [ + "documentKind", + "roleId", + "stateRevision", + "threadId" + ], "properties": { "activeGraphNodeIds": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "activeSubgoalId": { "type": [ @@ -4495,10 +6888,10 @@ ] }, "activeSubgoals": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - }, - "type": "array" + } }, "churn": { "anyOf": [ @@ -4511,10 +6904,10 @@ ] }, "documentKind": { + "type": "string", "enum": [ "role" - ], - "type": "string" + ] }, "graphCheckpoint": { "anyOf": [ @@ -4547,10 +6940,10 @@ ] }, "invariants": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - }, - "type": "array" + } }, "investigationCheckpoint": { "anyOf": [ @@ -4579,16 +6972,16 @@ ] }, "recentEvidence": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - }, - "type": "array" + } }, "recentObservations": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - }, - "type": "array" + } }, "roleId": { "type": "string" @@ -4604,56 +6997,64 @@ ] }, "stateRevision": { + "type": "integer", "format": "uint64", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "threadId": { "type": "string" } - }, - "required": [ - "documentKind", - "roleId", - "stateRevision", - "threadId" - ], - "type": "object" + } }, { + "type": "object", + "required": [ + "checkpointDisposition", + "checkpointId", + "checkpointKind", + "checkpointNextAction", + "decisionNote", + "documentKind", + "graphStatus", + "mode", + "pressureLevel", + "retrievalStatus", + "threadId", + "watcherStatus" + ], "properties": { "activeFrontierNodeIds": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "checkpointChangedPaths": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "checkpointCodeRefs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyCodeRef" - }, - "type": "array" + } }, "checkpointDirtyPaths": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "checkpointDisposition": { "type": "string" }, "checkpointEvidenceIds": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "checkpointFocus": { "type": [ @@ -4671,10 +7072,10 @@ "type": "string" }, "checkpointOpenQuestions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "checkpointSummary": { "type": [ @@ -4686,16 +7087,16 @@ "type": "string" }, "decisionReasons": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "documentKind": { + "type": "string", "enum": [ "reorient" - ], - "type": "string" + ] }, "graphStatus": { "type": "string" @@ -4711,16 +7112,16 @@ ] }, "linkedGraphNodeIds": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "linkedSubgoalIds": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "mode": { "type": "string" @@ -4729,16 +7130,16 @@ "type": "string" }, "recentEvidence": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyEvidenceRecord" - }, - "type": "array" + } }, "recentObservations": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyObservation" - }, - "type": "array" + } }, "retrievalStatus": { "type": "string" @@ -4759,27 +7160,16 @@ "watcherStatus": { "type": "string" } - }, - "required": [ - "checkpointDisposition", - "checkpointId", - "checkpointKind", - "checkpointNextAction", - "decisionNote", - "documentKind", - "graphStatus", - "mode", - "pressureLevel", - "retrievalStatus", - "threadId", - "watcherStatus" - ], - "type": "object" + } } ] }, "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": [ @@ -4792,6 +7182,7 @@ ] }, "approvalsReviewer": { + "description": "Override where approval requests are routed for review on this thread and subsequent turns.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -4799,8 +7190,7 @@ { "type": "null" } - ], - "description": "Override where approval requests are routed for review on this thread and subsequent turns." + ] }, "baseInstructions": { "type": [ @@ -4809,11 +7199,11 @@ ] }, "config": { - "additionalProperties": true, "type": [ "object", "null" - ] + ], + "additionalProperties": true }, "cwd": { "type": [ @@ -4843,27 +7233,6 @@ "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": [ { @@ -4881,31 +7250,64 @@ } ] }, + "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" + } + ] } - }, + } + }, + "ThreadReadParams": { + "type": "object", "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" + "includeTurns": { + "description": "When true, include turns and their items from rollout history.", + "default": false, + "type": "boolean" }, "threadId": { "type": "string" } - }, + } + }, + "ThreadInjectItemsParams": { + "type": "object", "required": [ "items", "threadId" ], - "type": "object" + "properties": { + "items": { + "description": "Raw Responses API items to append to the thread's model-visible history.", + "type": "array", + "items": true + }, + "threadId": { + "type": "string" + } + } }, "ThreadListCwdFilter": { "anyOf": [ @@ -4913,2467 +7315,12 @@ "type": "string" }, { + "type": "array", "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": { - "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" - ], - "type": "object" - }, - "ThreadRollbackParams": { - "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" - ], - "type": "object" - }, - "ThreadSetNameParams": { - "properties": { - "name": { - "type": "string" - }, - "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": { - "$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": [ - "skill" - ], - "title": "SkillUserInputType", - "type": "string" - } - }, - "required": [ - "name", - "path", - "type" - ], - "title": "SkillUserInput", - "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": [ - "skills/list" - ], - "title": "Skills/listRequestMethod", - "type": "string" - }, - "params": { - "$ref": "#/definitions/SkillsListParams" - } - }, - "required": [ - "id", - "method", - "params" - ], - "title": "Skills/listRequest", - "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": [ - "skills/config/write" - ], - "title": "Skills/config/writeRequestMethod", - "type": "string" - }, - "params": { - "$ref": "#/definitions/SkillsConfigWriteParams" - } - }, - "required": [ - "id", - "method", - "params" - ], - "title": "Skills/config/writeRequest", - "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 3968da2a..e0fa2766 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,51 +1,143 @@ { "$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": [ @@ -53,10 +145,10 @@ "null" ] } - }, - "type": "object" + } }, "AdditionalPermissionProfile": { + "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -78,12 +170,18 @@ } ] } - }, - "type": "object" + } }, "CommandAction": { "oneOf": [ { + "type": "object", + "required": [ + "command", + "name", + "path", + "type" + ], "properties": { "command": { "type": "string" @@ -95,23 +193,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -123,21 +219,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -155,39 +251,34 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, @@ -195,154 +286,159 @@ "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.", - "properties": { - "acceptWithExecpolicyAmendment": { - "properties": { - "execpolicy_amendment": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "execpolicy_amendment" - ], - "type": "object" - } - }, + "type": "object", "required": [ "acceptWithExecpolicyAmendment" ], - "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision", - "type": "object" + "properties": { + "acceptWithExecpolicyAmendment": { + "type": "object", + "required": [ + "execpolicy_amendment" + ], + "properties": { + "execpolicy_amendment": { + "type": "array", + "items": { + "type": "string" + } + } + } + } + }, + "additionalProperties": false, + "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision" }, { - "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" + } } }, - "required": [ - "applyNetworkPolicyAmendment" - ], - "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision", - "type": "object" + "additionalProperties": false, + "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision" }, { "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", - "type": "string" + "title": "PathFileSystemPathType" } }, - "required": [ - "path", - "type" - ], - "title": "PathFileSystemPath", - "type": "object" + "title": "PathFileSystemPath" }, { + "type": "object", + "required": [ + "pattern", + "type" + ], "properties": { "pattern": { "type": "string" }, "type": { + "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType", - "type": "string" + "title": "GlobPatternFileSystemPathType" } }, - "required": [ - "pattern", - "type" - ], - "title": "GlobPatternFileSystemPath", - "type": "object" + "title": "GlobPatternFileSystemPath" }, { + "type": "object", + "required": [ + "type", + "value" + ], "properties": { "type": { + "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType", - "type": "string" + "title": "SpecialFileSystemPathType" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "required": [ - "type", - "value" - ], - "title": "SpecialFileSystemPath", - "type": "object" + "title": "SpecialFileSystemPath" } ] }, "FileSystemSandboxEntry": { + "type": "object", + "required": [ + "access", + "path" + ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -350,67 +446,66 @@ "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": [ @@ -419,49 +514,50 @@ ] } }, + "title": "KindFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "KindFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "tmpdir" - ], - "type": "string" + ] } }, + "title": "TmpdirFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "TmpdirFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "slash_tmp" - ], - "type": "string" + ] } }, - "required": [ - "kind" - ], - "title": "SlashTmpFileSystemSpecialPath", - "type": "object" + "title": "SlashTmpFileSystemSpecialPath" }, { + "type": "object", + "required": [ + "kind", + "path" + ], "properties": { "kind": { + "type": "string", "enum": [ "unknown" - ], - "type": "string" + ] }, "path": { "type": "string" @@ -472,16 +568,16 @@ "null" ] } - }, - "required": [ - "kind", - "path" - ], - "type": "object" + } } ] }, "NetworkApprovalContext": { + "type": "object", + "required": [ + "host", + "protocol" + ], "properties": { "host": { "type": "string" @@ -489,23 +585,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" @@ -513,110 +609,14 @@ "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 0b7986fb..60036c05 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,86 +1,101 @@ { "$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.", - "properties": { - "acceptWithExecpolicyAmendment": { - "properties": { - "execpolicy_amendment": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "execpolicy_amendment" - ], - "type": "object" - } - }, + "type": "object", "required": [ "acceptWithExecpolicyAmendment" ], - "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision", - "type": "object" + "properties": { + "acceptWithExecpolicyAmendment": { + "type": "object", + "required": [ + "execpolicy_amendment" + ], + "properties": { + "execpolicy_amendment": { + "type": "array", + "items": { + "type": "string" + } + } + } + } + }, + "additionalProperties": false, + "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision" }, { - "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" + } } }, - "required": [ - "applyNetworkPolicyAmendment" - ], - "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision", - "type": "object" + "additionalProperties": false, + "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision" }, { "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" @@ -88,29 +103,14 @@ "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 991733da..7ffebbea 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,5 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "DynamicToolCallParams", + "type": "object", + "required": [ + "arguments", + "callId", + "threadId", + "tool", + "turnId" + ], "properties": { "arguments": true, "callId": { @@ -20,14 +29,5 @@ "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 e0e29641..e168790f 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#", - "definitions": { - "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" - } - ] - } - }, + "title": "DynamicToolCallResponse", + "type": "object", + "required": [ + "contentItems", + "success" + ], "properties": { "contentItems": { + "type": "array", "items": { "$ref": "#/definitions/DynamicToolCallOutputContentItem" - }, - "type": "array" + } }, "success": { "type": "boolean" } }, - "required": [ - "contentItems", - "success" - ], - "title": "DynamicToolCallResponse", - "type": "object" + "definitions": { + "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" + } + ] + } + } } \ 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 43f85d21..aee30339 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,9 +1,62 @@ { "$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" @@ -16,23 +69,21 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadParsedCommandType", - "type": "string" + "title": "ReadParsedCommandType" } }, - "required": [ - "cmd", - "name", - "path", - "type" - ], - "title": "ReadParsedCommand", - "type": "object" + "title": "ReadParsedCommand" }, { + "type": "object", + "required": [ + "cmd", + "type" + ], "properties": { "cmd": { "type": "string" @@ -44,21 +95,21 @@ ] }, "type": { + "type": "string", "enum": [ "list_files" ], - "title": "ListFilesParsedCommandType", - "type": "string" + "title": "ListFilesParsedCommandType" } }, + "title": "ListFilesParsedCommand" + }, + { + "type": "object", "required": [ "cmd", "type" ], - "title": "ListFilesParsedCommand", - "type": "object" - }, - { "properties": { "cmd": { "type": "string" @@ -76,90 +127,39 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchParsedCommandType", - "type": "string" + "title": "SearchParsedCommandType" } }, + "title": "SearchParsedCommand" + }, + { + "type": "object", "required": [ "cmd", "type" ], - "title": "SearchParsedCommand", - "type": "object" - }, - { "properties": { "cmd": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownParsedCommandType", - "type": "string" + "title": "UnknownParsedCommandType" } }, - "required": [ - "cmd", - "type" - ], - "title": "UnknownParsedCommand", - "type": "object" + "title": "UnknownParsedCommand" } ] }, "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 477109e2..abafe36c 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,7 +1,22 @@ { "$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" @@ -9,116 +24,101 @@ "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.", - "properties": { - "approved_execpolicy_amendment": { - "properties": { - "proposed_execpolicy_amendment": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "proposed_execpolicy_amendment" - ], - "type": "object" - } - }, + "type": "object", "required": [ "approved_execpolicy_amendment" ], - "title": "ApprovedExecpolicyAmendmentReviewDecision", - "type": "object" + "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" - ], - "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" + } } }, - "required": [ - "network_policy_amendment" - ], - "title": "NetworkPolicyAmendmentReviewDecision", - "type": "object" + "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" - ], - "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 f52e98cd..f7e561c3 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,5 +1,12 @@ { "$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).", @@ -24,12 +31,5 @@ "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 f20035e3..ace77406 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#", - "definitions": { - "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" - } - ] - } - }, + "title": "FileChangeRequestApprovalResponse", + "type": "object", + "required": [ + "decision" + ], "properties": { "decision": { "$ref": "#/definitions/FileChangeApprovalDecision" } }, - "required": [ - "decision" - ], - "title": "FileChangeRequestApprovalResponse", - "type": "object" + "definitions": { + "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" + ] + } + ] + } + } } \ 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 3a72939d..06078566 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,5 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "FuzzyFileSearchParams", + "type": "object", + "required": [ + "query", + "roots" + ], "properties": { "cancellationToken": { "type": [ @@ -11,16 +17,10 @@ "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 3c91a79c..808171ab 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,29 +1,50 @@ { "$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" @@ -35,32 +56,11 @@ "type": "string" }, "score": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 } - }, - "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 c8924e77..2312b219 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 b69ad9b2..d1babb04 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,29 +1,58 @@ { "$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" @@ -35,40 +64,11 @@ "type": "string" }, "score": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 } - }, - "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 6db5d1a7..54cc21b9 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,36 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - ] - } - }, + "title": "JSONRPCError", "description": "A response to a request that indicates an error occurred.", + "type": "object", + "required": [ + "error", + "id" + ], "properties": { "error": { "$ref": "#/definitions/JSONRPCErrorError" @@ -39,10 +15,34 @@ "$ref": "#/definitions/RequestId" } }, - "required": [ - "error", - "id" - ], - "title": "JSONRPCError", - "type": "object" + "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" + } + ] + } + } } \ 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 932ef33c..32594508 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": { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "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 27b78b90..cb4a6733 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,5 +1,7 @@ { "$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" @@ -17,6 +19,11 @@ "definitions": { "JSONRPCError": { "description": "A response to a request that indicates an error occurred.", + "type": "object", + "required": [ + "error", + "id" + ], "properties": { "error": { "$ref": "#/definitions/JSONRPCErrorError" @@ -24,45 +31,45 @@ "id": { "$ref": "#/definitions/RequestId" } - }, - "required": [ - "error", - "id" - ], - "type": "object" + } }, "JSONRPCErrorError": { + "type": "object", + "required": [ + "code", + "message" + ], "properties": { "code": { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "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" @@ -72,6 +79,7 @@ }, "params": true, "trace": { + "description": "Optional W3C Trace Context for distributed tracing.", "anyOf": [ { "$ref": "#/definitions/W3cTraceContext" @@ -79,29 +87,23 @@ { "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": [ @@ -109,12 +111,13 @@ "type": "string" }, { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } ] }, "W3cTraceContext": { + "type": "object", "properties": { "traceparent": { "type": [ @@ -128,10 +131,7 @@ "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 2ddd61a8..8d367137 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 e4ea7c20..6fc6d65f 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,5 +1,32 @@ { "$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": [ @@ -7,12 +34,13 @@ "type": "string" }, { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } ] }, "W3cTraceContext": { + "type": "object", "properties": { "traceparent": { "type": [ @@ -26,35 +54,7 @@ "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 9f1ec295..86a74bd4 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,5 +1,18 @@ { "$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": [ @@ -7,23 +20,10 @@ "type": "string" }, { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } ] } - }, - "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 aa7fa817..44ec7e04 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,14 +1,90 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "McpElicitationArrayType": { - "enum": [ - "array" + "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" + ] + }, "McpElicitationBooleanSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "type" + ], "properties": { "default": { "type": [ @@ -32,19 +108,20 @@ "$ref": "#/definitions/McpElicitationBooleanType" } }, - "required": [ - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationBooleanType": { + "type": "string", "enum": [ "boolean" - ], - "type": "string" + ] }, "McpElicitationConstOption": { - "additionalProperties": false, + "type": "object", + "required": [ + "const", + "title" + ], "properties": { "const": { "type": "string" @@ -53,11 +130,7 @@ "type": "string" } }, - "required": [ - "const", - "title" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationEnumSchema": { "anyOf": [ @@ -73,7 +146,11 @@ ] }, "McpElicitationLegacyTitledEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "enum", + "type" + ], "properties": { "default": { "type": [ @@ -88,19 +165,19 @@ ] }, "enum": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "enumNames": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "title": { "type": [ @@ -112,11 +189,7 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "enum", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationMultiSelectEnumSchema": { "anyOf": [ @@ -129,14 +202,17 @@ ] }, "McpElicitationNumberSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "type" + ], "properties": { "default": { - "format": "double", "type": [ "number", "null" - ] + ], + "format": "double" }, "description": { "type": [ @@ -145,18 +221,18 @@ ] }, "maximum": { - "format": "double", "type": [ "number", "null" - ] + ], + "format": "double" }, "minimum": { - "format": "double", "type": [ "number", "null" - ] + ], + "format": "double" }, "title": { "type": [ @@ -168,23 +244,20 @@ "$ref": "#/definitions/McpElicitationNumberType" } }, - "required": [ - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationNumberType": { + "type": "string", "enum": [ "number", "integer" - ], - "type": "string" + ] }, "McpElicitationObjectType": { + "type": "string", "enum": [ "object" - ], - "type": "string" + ] }, "McpElicitationPrimitiveSchema": { "anyOf": [ @@ -203,8 +276,12 @@ ] }, "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": [ @@ -213,29 +290,25 @@ ] }, "properties": { + "type": "object", "additionalProperties": { "$ref": "#/definitions/McpElicitationPrimitiveSchema" - }, - "type": "object" + } }, "required": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "type": { "$ref": "#/definitions/McpElicitationObjectType" } }, - "required": [ - "properties", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationSingleSelectEnumSchema": { "anyOf": [ @@ -248,16 +321,19 @@ ] }, "McpElicitationStringFormat": { + "type": "string", "enum": [ "email", "uri", "date", "date-time" - ], - "type": "string" + ] }, "McpElicitationStringSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "type" + ], "properties": { "default": { "type": [ @@ -282,20 +358,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": [ @@ -307,43 +383,44 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationStringType": { + "type": "string", "enum": [ "string" - ], - "type": "string" + ] }, "McpElicitationTitledEnumItems": { - "additionalProperties": false, - "properties": { - "anyOf": { - "items": { - "$ref": "#/definitions/McpElicitationConstOption" - }, - "type": "array" - } - }, + "type": "object", "required": [ "anyOf" ], - "type": "object" + "properties": { + "anyOf": { + "type": "array", + "items": { + "$ref": "#/definitions/McpElicitationConstOption" + } + } + }, + "additionalProperties": false }, "McpElicitationTitledMultiSelectEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "items", + "type" + ], "properties": { "default": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "description": { "type": [ @@ -355,20 +432,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": [ @@ -380,14 +457,14 @@ "$ref": "#/definitions/McpElicitationArrayType" } }, - "required": [ - "items", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationTitledSingleSelectEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "oneOf", + "type" + ], "properties": { "default": { "type": [ @@ -402,10 +479,10 @@ ] }, "oneOf": { + "type": "array", "items": { "$ref": "#/definitions/McpElicitationConstOption" - }, - "type": "array" + } }, "title": { "type": [ @@ -417,42 +494,42 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "oneOf", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationUntitledEnumItems": { - "additionalProperties": false, + "type": "object", + "required": [ + "enum", + "type" + ], "properties": { "enum": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "type": { "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "enum", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationUntitledMultiSelectEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "items", + "type" + ], "properties": { "default": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "description": { "type": [ @@ -464,20 +541,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": [ @@ -489,14 +566,14 @@ "$ref": "#/definitions/McpElicitationArrayType" } }, - "required": [ - "items", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationUntitledSingleSelectEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "enum", + "type" + ], "properties": { "default": { "type": [ @@ -511,10 +588,10 @@ ] }, "enum": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": [ @@ -526,84 +603,7 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "enum", - "type" - ], - "type": "object" + "additionalProperties": false } - }, - "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 13390a06..f0fe3105 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,15 +1,10 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "McpServerElicitationAction": { - "enum": [ - "accept", - "decline", - "cancel" - ], - "type": "string" - } - }, + "title": "McpServerElicitationRequestResponse", + "type": "object", + "required": [ + "action" + ], "properties": { "_meta": { "description": "Optional client metadata for form-mode action handling." @@ -21,9 +16,14 @@ "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" + "definitions": { + "McpServerElicitationAction": { + "type": "string", + "enum": [ + "accept", + "decline", + "cancel" + ] + } + } } \ 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 c2e26c55..84e9e326 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,299 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "title": "PermissionsRequestApprovalParams", + "type": "object", + "required": [ + "cwd", + "itemId", + "permissions", + "threadId", + "turnId" + ], "properties": { "cwd": { "$ref": "#/definitions/AbsolutePathBuf" @@ -317,13 +32,298 @@ "type": "string" } }, - "required": [ - "cwd", - "itemId", - "permissions", - "threadId", - "turnId" - ], - "title": "PermissionsRequestApprovalParams", - "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" + }, + "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 + } + } } \ 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 e066108e..abeb7079 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,51 +1,77 @@ { "$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": [ @@ -53,82 +79,86 @@ "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", - "type": "string" + "title": "PathFileSystemPathType" } }, - "required": [ - "path", - "type" - ], - "title": "PathFileSystemPath", - "type": "object" + "title": "PathFileSystemPath" }, { + "type": "object", + "required": [ + "pattern", + "type" + ], "properties": { "pattern": { "type": "string" }, "type": { + "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType", - "type": "string" + "title": "GlobPatternFileSystemPathType" } }, - "required": [ - "pattern", - "type" - ], - "title": "GlobPatternFileSystemPath", - "type": "object" + "title": "GlobPatternFileSystemPath" }, { + "type": "object", + "required": [ + "type", + "value" + ], "properties": { "type": { + "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType", - "type": "string" + "title": "SpecialFileSystemPathType" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "required": [ - "type", - "value" - ], - "title": "SpecialFileSystemPath", - "type": "object" + "title": "SpecialFileSystemPath" } ] }, "FileSystemSandboxEntry": { + "type": "object", + "required": [ + "access", + "path" + ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -136,67 +166,66 @@ "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": [ @@ -205,49 +234,50 @@ ] } }, + "title": "KindFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "KindFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "tmpdir" - ], - "type": "string" + ] } }, + "title": "TmpdirFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "TmpdirFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "slash_tmp" - ], - "type": "string" + ] } }, - "required": [ - "kind" - ], - "title": "SlashTmpFileSystemSpecialPath", - "type": "object" + "title": "SlashTmpFileSystemSpecialPath" }, { + "type": "object", + "required": [ + "kind", + "path" + ], "properties": { "kind": { + "type": "string", "enum": [ "unknown" - ], - "type": "string" + ] }, "path": { "type": "string" @@ -258,16 +288,12 @@ "null" ] } - }, - "required": [ - "kind", - "path" - ], - "type": "object" + } } ] }, "GrantedPermissionProfile": { + "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -289,40 +315,14 @@ } ] } - }, - "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 d0fa43db..8cb7b945 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" }, { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } - ], - "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 787f3019..1f757591 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,11 +1,1144 @@ { "$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": [ @@ -22,24 +1155,21 @@ "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": [ @@ -61,50 +1191,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": [ @@ -112,10 +1242,16 @@ "null" ] } - }, - "type": "object" + } }, "AgentMessageDeltaNotification": { + "type": "object", + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], "properties": { "delta": { "type": "string" @@ -129,14 +1265,7 @@ "turnId": { "type": "string" } - }, - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], - "type": "object" + } }, "AgentPath": { "type": "string" @@ -146,64 +1275,65 @@ "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": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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", @@ -214,129 +1344,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -347,13 +1480,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -362,30 +1492,36 @@ "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" @@ -397,23 +1533,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -425,21 +1559,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -457,44 +1591,46 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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.", @@ -509,42 +1645,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" @@ -558,34 +1694,31 @@ "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.", @@ -602,6 +1735,7 @@ ] }, "range": { + "description": "Optional range for the error location inside the config file.", "anyOf": [ { "$ref": "#/definitions/TextRange" @@ -609,21 +1743,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" @@ -631,14 +1765,14 @@ "turnId": { "type": "string" } - }, - "required": [ - "threadId", - "turnId" - ], - "type": "object" + } }, "CreditsSnapshot": { + "type": "object", + "required": [ + "hasCredits", + "unlimited" + ], "properties": { "balance": { "type": [ @@ -652,14 +1786,13 @@ "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.", @@ -672,65 +1805,72 @@ "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "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" @@ -774,41 +1914,42 @@ "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": [ @@ -817,10 +1958,10 @@ ] }, "evidence_refs": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "horizon": { "type": "string" @@ -832,10 +1973,10 @@ "type": "string" }, "lane_hints": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -844,10 +1985,10 @@ "type": "string" }, "source_refs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "type": "array" + } }, "status": { "type": "string" @@ -864,21 +2005,14 @@ "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" @@ -893,12 +2027,12 @@ "type": "string" }, "unexplained_writes": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "warning": { "type": [ @@ -906,22 +2040,21 @@ "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": [ @@ -933,12 +2066,12 @@ "type": "string" }, "start_line": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "symbol": { "type": [ @@ -946,19 +2079,22 @@ "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" @@ -972,59 +2108,57 @@ "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, - "type": "integer" + "minimum": 0.0 }, "open_gap_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "open_question_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1032,20 +2166,21 @@ "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": [ @@ -1074,59 +2209,58 @@ "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" @@ -1137,20 +2271,21 @@ "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" @@ -1179,15 +2314,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "purpose", - "title" - ], - "type": "object" + } }, "EpiphanyGraphs": { + "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -1196,15 +2326,20 @@ "$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" @@ -1221,15 +2356,16 @@ "status": { "type": "string" } - }, - "required": [ - "description", - "id", - "status" - ], - "type": "object" + } }, "EpiphanyInvestigationCheckpoint": { + "type": "object", + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], "properties": { "captured_at_turn_id": { "type": [ @@ -1241,19 +2377,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" @@ -1268,10 +2404,10 @@ ] }, "open_questions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1279,23 +2415,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": [ @@ -1316,16 +2452,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" @@ -1333,32 +2469,29 @@ "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": [ @@ -1373,31 +2506,36 @@ "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" @@ -1406,25 +2544,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" @@ -1435,18 +2573,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "type": "object" + } }, "EpiphanyObjectiveDraftLanePlan": { + "type": "object", "properties": { "body": { "type": [ @@ -1484,39 +2614,45 @@ "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" @@ -1530,16 +2666,17 @@ "summary": { "type": "string" } - }, - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "type": "object" + } }, "EpiphanyPlanningCapture": { + "type": "object", + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], "properties": { "body": { "type": [ @@ -1572,10 +2709,10 @@ "type": "string" }, "tags": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": "string" @@ -1586,23 +2723,20 @@ "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": [ @@ -1632,10 +2766,10 @@ ] }, "unblocks": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "urgency": { "type": [ @@ -1646,20 +2780,19 @@ "value": { "type": "string" } - }, - "required": [ - "rationale", - "value" - ], - "type": "object" + } }, "EpiphanyPlanningSourceRef": { + "type": "object", + "required": [ + "kind" + ], "properties": { "assignees": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "author": { "type": [ @@ -1680,11 +2813,11 @@ ] }, "database_id": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "external_id": { "type": [ @@ -1705,21 +2838,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": [ @@ -1769,37 +2902,34 @@ "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": [ @@ -1807,29 +2937,33 @@ "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" @@ -1841,27 +2975,26 @@ "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": [ @@ -1870,79 +3003,82 @@ ] }, "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": [ @@ -1965,16 +3101,18 @@ "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" @@ -1986,16 +3124,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" @@ -2012,18 +3150,10 @@ "surface": { "type": "string" } - }, - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "type": "object" + } }, "EpiphanyScratchPad": { + "type": "object", "properties": { "hypothesis": { "type": [ @@ -2038,10 +3168,10 @@ ] }, "notes": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -2049,10 +3179,15 @@ "null" ] } - }, - "type": "object" + } }, "EpiphanySubgoal": { + "type": "object", + "required": [ + "id", + "status", + "title" + ], "properties": { "id": { "type": "string" @@ -2069,21 +3204,19 @@ "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": [ @@ -2125,10 +3258,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - }, - "type": "array" + } }, "investigation_checkpoint": { "anyOf": [ @@ -2141,10 +3274,10 @@ ] }, "job_bindings": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - }, - "type": "array" + } }, "last_updated_turn_id": { "type": [ @@ -2169,19 +3302,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": [ @@ -2194,15 +3327,15 @@ ] }, "revision": { + "type": "integer", "format": "uint64", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "runtime_links": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - }, - "type": "array" + } }, "scratch": { "anyOf": [ @@ -2215,18 +3348,21 @@ ] }, "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" @@ -2240,16 +3376,16 @@ "willRetry": { "type": "boolean" } - }, - "required": [ - "error", - "threadId", - "turnId", - "willRetry" - ], - "type": "object" + } }, "FileChangeOutputDeltaNotification": { + "type": "object", + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], "properties": { "delta": { "type": "string" @@ -2263,22 +3399,22 @@ "turnId": { "type": "string" } - }, + } + }, + "FileChangePatchUpdatedNotification": { + "type": "object", "required": [ - "delta", + "changes", "itemId", "threadId", "turnId" ], - "type": "object" - }, - "FileChangePatchUpdatedNotification": { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "itemId": { "type": "string" @@ -2289,88 +3425,86 @@ "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", - "type": "string" + "title": "PathFileSystemPathType" } }, - "required": [ - "path", - "type" - ], - "title": "PathFileSystemPath", - "type": "object" + "title": "PathFileSystemPath" }, { + "type": "object", + "required": [ + "pattern", + "type" + ], "properties": { "pattern": { "type": "string" }, "type": { + "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType", - "type": "string" + "title": "GlobPatternFileSystemPathType" } }, - "required": [ - "pattern", - "type" - ], - "title": "GlobPatternFileSystemPath", - "type": "object" + "title": "GlobPatternFileSystemPath" }, { + "type": "object", + "required": [ + "type", + "value" + ], "properties": { "type": { + "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType", - "type": "string" + "title": "SpecialFileSystemPathType" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "required": [ - "type", - "value" - ], - "title": "SpecialFileSystemPath", - "type": "object" + "title": "SpecialFileSystemPath" } ] }, "FileSystemSandboxEntry": { + "type": "object", + "required": [ + "access", + "path" + ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -2378,67 +3512,66 @@ "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": [ @@ -2447,49 +3580,50 @@ ] } }, + "title": "KindFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "KindFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "tmpdir" - ], - "type": "string" + ] } }, + "title": "TmpdirFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "TmpdirFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "slash_tmp" - ], - "type": "string" + ] } }, - "required": [ - "kind" - ], - "title": "SlashTmpFileSystemSpecialPath", - "type": "object" + "title": "SlashTmpFileSystemSpecialPath" }, { + "type": "object", + "required": [ + "kind", + "path" + ], "properties": { "kind": { + "type": "string", "enum": [ "unknown" - ], - "type": "string" + ] }, "path": { "type": "string" @@ -2500,16 +3634,17 @@ "null" ] } - }, - "required": [ - "kind", - "path" - ], - "type": "object" + } } ] }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -2520,58 +3655,60 @@ "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" @@ -2583,38 +3720,36 @@ "type": "string" }, "score": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 } - }, - "required": [ - "file_name", - "match_type", - "path", - "root", - "score" - ], - "type": "object" + } }, "FuzzyFileSearchSessionCompletedNotification": { + "type": "object", + "required": [ + "sessionId" + ], "properties": { "sessionId": { "type": "string" } - }, - "required": [ - "sessionId" - ], - "type": "object" + } }, "FuzzyFileSearchSessionUpdatedNotification": { + "type": "object", + "required": [ + "files", + "query", + "sessionId" + ], "properties": { "files": { + "type": "array", "items": { "$ref": "#/definitions/FuzzyFileSearchResult" - }, - "type": "array" + } }, "query": { "type": "string" @@ -2622,15 +3757,10 @@ "sessionId": { "type": "string" } - }, - "required": [ - "files", - "query", - "sessionId" - ], - "type": "object" + } }, "GitInfo": { + "type": "object", "properties": { "branch": { "type": [ @@ -2650,11 +3780,14 @@ "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": [ @@ -2685,15 +3818,18 @@ } ] } - }, - "required": [ - "status" - ], - "type": "object" + } }, "GuardianApprovalReviewAction": { "oneOf": [ { + "type": "object", + "required": [ + "command", + "cwd", + "source", + "type" + ], "properties": { "command": { "type": "string" @@ -2705,29 +3841,30 @@ "$ref": "#/definitions/GuardianCommandSource" }, "type": { + "type": "string", "enum": [ "command" ], - "title": "CommandGuardianApprovalReviewActionType", - "type": "string" + "title": "CommandGuardianApprovalReviewActionType" } }, + "title": "CommandGuardianApprovalReviewAction" + }, + { + "type": "object", "required": [ - "command", + "argv", "cwd", + "program", "source", "type" ], - "title": "CommandGuardianApprovalReviewAction", - "type": "object" - }, - { "properties": { "argv": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "cwd": { "$ref": "#/definitions/AbsolutePathBuf" @@ -2739,59 +3876,59 @@ "$ref": "#/definitions/GuardianCommandSource" }, "type": { + "type": "string", "enum": [ "execve" ], - "title": "ExecveGuardianApprovalReviewActionType", - "type": "string" + "title": "ExecveGuardianApprovalReviewActionType" } }, - "required": [ - "argv", - "cwd", - "program", - "source", - "type" - ], - "title": "ExecveGuardianApprovalReviewAction", - "type": "object" + "title": "ExecveGuardianApprovalReviewAction" }, { - "properties": { - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "files": { - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" - }, - "type": { - "enum": [ - "applyPatch" - ], - "title": "ApplyPatchGuardianApprovalReviewActionType", - "type": "string" - } - }, + "type": "object", "required": [ "cwd", "files", "type" ], - "title": "ApplyPatchGuardianApprovalReviewAction", - "type": "object" + "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": { "type": "string" }, "port": { + "type": "integer", "format": "uint16", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "protocol": { "$ref": "#/definitions/NetworkApprovalProtocol" @@ -2800,24 +3937,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "networkAccess" ], - "title": "NetworkAccessGuardianApprovalReviewActionType", - "type": "string" + "title": "NetworkAccessGuardianApprovalReviewActionType" } }, - "required": [ - "host", - "port", - "protocol", - "target", - "type" - ], - "title": "NetworkAccessGuardianApprovalReviewAction", - "type": "object" + "title": "NetworkAccessGuardianApprovalReviewAction" }, { + "type": "object", + "required": [ + "server", + "toolName", + "type" + ], "properties": { "connectorId": { "type": [ @@ -2844,22 +3979,21 @@ ] }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallGuardianApprovalReviewActionType", - "type": "string" + "title": "McpToolCallGuardianApprovalReviewActionType" } }, - "required": [ - "server", - "toolName", - "type" - ], - "title": "McpToolCallGuardianApprovalReviewAction", - "type": "object" + "title": "McpToolCallGuardianApprovalReviewAction" }, { + "type": "object", + "required": [ + "permissions", + "type" + ], "properties": { "permissions": { "$ref": "#/definitions/RequestPermissionProfile" @@ -2871,61 +4005,61 @@ ] }, "type": { + "type": "string", "enum": [ "requestPermissions" ], - "title": "RequestPermissionsGuardianApprovalReviewActionType", - "type": "string" + "title": "RequestPermissionsGuardianApprovalReviewActionType" } }, - "required": [ - "permissions", - "type" - ], - "title": "RequestPermissionsGuardianApprovalReviewAction", - "type": "object" + "title": "RequestPermissionsGuardianApprovalReviewAction" } ] }, "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.", @@ -2935,14 +4069,14 @@ "description": "Thread target for the guardian warning.", "type": "string" } - }, - "required": [ - "message", - "threadId" - ], - "type": "object" + } }, "HookCompletedNotification": { + "type": "object", + "required": [ + "run", + "threadId" + ], "properties": { "run": { "$ref": "#/definitions/HookRunSummary" @@ -2956,14 +4090,10 @@ "null" ] } - }, - "required": [ - "run", - "threadId" - ], - "type": "object" + } }, "HookEventName": { + "type": "string", "enum": [ "preToolUse", "permissionRequest", @@ -2971,25 +4101,29 @@ "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" @@ -2997,24 +4131,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" @@ -3022,48 +4156,56 @@ "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": { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "durationMs": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "entries": { + "type": "array", "items": { "$ref": "#/definitions/HookOutputEntry" - }, - "type": "array" + } }, "eventName": { "$ref": "#/definitions/HookEventName" @@ -3081,19 +4223,19 @@ "$ref": "#/definitions/HookScope" }, "source": { + "default": "unknown", "allOf": [ { "$ref": "#/definitions/HookSource" } - ], - "default": "unknown" + ] }, "sourcePath": { "$ref": "#/definitions/AbsolutePathBuf" }, "startedAt": { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "status": { "$ref": "#/definitions/HookRunStatus" @@ -3104,29 +4246,17 @@ "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", @@ -3136,10 +4266,14 @@ "legacyManagedConfigFile", "legacyManagedConfigMdm", "unknown" - ], - "type": "string" + ] }, "HookStartedNotification": { + "type": "object", + "required": [ + "run", + "threadId" + ], "properties": { "run": { "$ref": "#/definitions/HookRunSummary" @@ -3153,14 +4287,15 @@ "null" ] } - }, - "required": [ - "run", - "threadId" - ], - "type": "object" + } }, "ItemCompletedNotification": { + "type": "object", + "required": [ + "item", + "threadId", + "turnId" + ], "properties": { "item": { "$ref": "#/definitions/ThreadItem" @@ -3171,16 +4306,19 @@ "turnId": { "type": "string" } - }, - "required": [ - "item", - "threadId", - "turnId" - ], - "type": "object" + } }, "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" @@ -3208,19 +4346,18 @@ "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" @@ -3245,17 +4382,15 @@ "turnId": { "type": "string" } - }, + } + }, + "ItemStartedNotification": { + "type": "object", "required": [ - "action", - "review", - "reviewId", + "item", "threadId", "turnId" ], - "type": "object" - }, - "ItemStartedNotification": { "properties": { "item": { "$ref": "#/definitions/ThreadItem" @@ -3266,15 +4401,14 @@ "turnId": { "type": "string" } - }, - "required": [ - "item", - "threadId", - "turnId" - ], - "type": "object" + } }, "McpServerOauthLoginCompletedNotification": { + "type": "object", + "required": [ + "name", + "success" + ], "properties": { "error": { "type": [ @@ -3288,23 +4422,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": [ @@ -3318,25 +4452,27 @@ "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" @@ -3350,69 +4486,69 @@ "turnId": { "type": "string" } - }, - "required": [ - "itemId", - "message", - "threadId", - "turnId" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -3420,41 +4556,42 @@ "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" @@ -3471,76 +4608,72 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -3549,23 +4682,26 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "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" @@ -3579,16 +4715,10 @@ "turnId": { "type": "string" } - }, - "required": [ - "delta", - "itemId", - "threadId", - "turnId" - ], - "type": "object" + } }, "PlanType": { + "type": "string", "enum": [ "free", "go", @@ -3602,20 +4732,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": [ @@ -3679,44 +4809,44 @@ } ] } - }, - "type": "object" + } }, "RateLimitWindow": { - "properties": { - "resetsAt": { - "format": "int64", - "type": [ - "integer", - "null" - ] - }, - "usedPercent": { - "format": "int32", - "type": "integer" - }, - "windowDurationMins": { - "format": "int64", - "type": [ - "integer", - "null" - ] - } - }, + "type": "object", "required": [ "usedPercent" ], - "type": "object" + "properties": { + "resetsAt": { + "type": [ + "integer", + "null" + ], + "format": "int64" + }, + "usedPercent": { + "type": "integer", + "format": "int32" + }, + "windowDurationMins": { + "type": [ + "integer", + "null" + ], + "format": "int64" + } + } }, "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", @@ -3724,44 +4854,23 @@ "medium", "high", "xhigh" - ], - "type": "string" + ] }, "ReasoningSummaryPartAddedNotification": { - "properties": { - "itemId": { - "type": "string" - }, - "summaryIndex": { - "format": "int64", - "type": "integer" - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" - } - }, + "type": "object", "required": [ "itemId", "summaryIndex", "threadId", "turnId" ], - "type": "object" - }, - "ReasoningSummaryTextDeltaNotification": { "properties": { - "delta": { - "type": "string" - }, "itemId": { "type": "string" }, "summaryIndex": { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "threadId": { "type": "string" @@ -3769,7 +4878,10 @@ "turnId": { "type": "string" } - }, + } + }, + "ReasoningSummaryTextDeltaNotification": { + "type": "object", "required": [ "delta", "itemId", @@ -3777,27 +4889,27 @@ "threadId", "turnId" ], - "type": "object" - }, - "ReasoningTextDeltaNotification": { "properties": { - "contentIndex": { - "format": "int64", - "type": "integer" - }, "delta": { "type": "string" }, "itemId": { "type": "string" }, + "summaryIndex": { + "type": "integer", + "format": "int64" + }, "threadId": { "type": "string" }, "turnId": { "type": "string" } - }, + } + }, + "ReasoningTextDeltaNotification": { + "type": "object", "required": [ "contentIndex", "delta", @@ -3805,7 +4917,24 @@ "threadId", "turnId" ], - "type": "object" + "properties": { + "contentIndex": { + "type": "integer", + "format": "int64" + }, + "delta": { + "type": "string" + }, + "itemId": { + "type": "string" + }, + "threadId": { + "type": "string" + }, + "turnId": { + "type": "string" + } + } }, "RequestId": { "anyOf": [ @@ -3813,13 +4942,13 @@ "type": "string" }, { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } ] }, "RequestPermissionProfile": { - "additionalProperties": false, + "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -3842,9 +4971,14 @@ ] } }, - "type": "object" + "additionalProperties": false }, "ServerRequestResolvedNotification": { + "type": "object", + "required": [ + "requestId", + "threadId" + ], "properties": { "requestId": { "$ref": "#/definitions/RequestId" @@ -3852,71 +4986,70 @@ "threadId": { "type": "string" } - }, - "required": [ - "requestId", - "threadId" - ], - "type": "object" + } }, "SessionSource": { "oneOf": [ { + "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "custom" + ], "properties": { "custom": { "type": "string" } }, - "required": [ - "custom" - ], - "title": "CustomSessionSource", - "type": "object" + "additionalProperties": false, + "title": "CustomSessionSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "subAgent" + ], "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "required": [ - "subAgent" - ], - "title": "SubAgentSessionSource", - "type": "object" + "additionalProperties": false, + "title": "SubAgentSessionSource" } ] }, - "SkillsChangedNotification": { - "description": "Notification emitted when watched local skill files change.\n\nTreat this as an invalidation signal and re-run `skills/list` with the client's current parameters when refreshed skill metadata is needed.", - "type": "object" - }, "SubAgentSource": { "oneOf": [ { + "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "thread_spawn" + ], "properties": { "thread_spawn": { + "type": "object", + "required": [ + "depth", + "parent_thread_id" + ], "properties": { "agent_nickname": { "default": null, @@ -3926,6 +5059,7 @@ ] }, "agent_path": { + "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -3933,8 +5067,7 @@ { "type": "null" } - ], - "default": null + ] }, "agent_role": { "default": null, @@ -3944,42 +5077,42 @@ ] }, "depth": { - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - }, - "required": [ - "depth", - "parent_thread_id" - ], - "type": "object" + } } }, - "required": [ - "thread_spawn" - ], - "title": "ThreadSpawnSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "ThreadSpawnSubAgentSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "other" + ], "properties": { "other": { "type": "string" } }, - "required": [ - "other" - ], - "title": "OtherSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "OtherSubAgentSource" } ] }, "TerminalInteractionNotification": { + "type": "object", + "required": [ + "itemId", + "processId", + "stdin", + "threadId", + "turnId" + ], "properties": { "itemId": { "type": "string" @@ -3996,25 +5129,21 @@ "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.", @@ -4023,34 +5152,35 @@ "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" - } - }, + "type": "object", "required": [ "column", "line" ], - "type": "object" + "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" @@ -4058,14 +5188,23 @@ "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.", @@ -4087,22 +5226,23 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "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" @@ -4110,8 +5250,7 @@ { "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.", @@ -4121,6 +5260,7 @@ ] }, "gitInfo": { + "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -4128,8 +5268,7 @@ { "type": "null" } - ], - "description": "Optional Git metadata captured when the thread was created." + ] }, "id": { "type": "string" @@ -4157,85 +5296,79 @@ "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.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } - }, - "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": [ @@ -4259,30 +5392,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": [ @@ -4291,16 +5424,16 @@ ] }, "linkedGraphNodeIds": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "linkedSubgoalIds": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "ownerRole": { "type": "string" @@ -4317,26 +5450,19 @@ "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", @@ -4347,45 +5473,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", @@ -4404,32 +5530,10 @@ "churn", "mode", "planning" - ], - "type": "string" + ] }, "ThreadEpiphanyStateUpdatedNotification": { - "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" - } - }, + "type": "object", "required": [ "changedFields", "epiphanyState", @@ -4437,9 +5541,31 @@ "source", "threadId" ], - "type": "object" + "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" + } + } }, "ThreadEpiphanyStateUpdatedSource": { + "type": "string", "enum": [ "update", "promote", @@ -4447,8 +5573,7 @@ "jobInterrupt", "reorientAccept", "roleAccept" - ], - "type": "string" + ] }, "ThreadId": { "type": "string" @@ -4456,65 +5581,72 @@ "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -4522,10 +5654,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -4533,30 +5665,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -4565,56 +5696,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -4629,34 +5763,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" @@ -4669,42 +5803,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -4713,32 +5845,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -4779,43 +5913,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -4839,31 +5972,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -4884,6 +6019,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -4891,57 +6027,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -4960,22 +6091,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -4984,22 +6115,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -5027,23 +6159,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -5052,22 +6183,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -5076,44 +6207,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "ThreadNameUpdatedNotification": { + "type": "object", + "required": [ + "threadId" + ], "properties": { "threadId": { "type": "string" @@ -5124,14 +6253,16 @@ "null" ] } - }, - "required": [ - "threadId" - ], - "type": "object" + } }, "ThreadRealtimeAudioChunk": { "description": "EXPERIMENTAL - thread realtime audio chunk.", + "type": "object", + "required": [ + "data", + "numChannels", + "sampleRate" + ], "properties": { "data": { "type": "string" @@ -5143,33 +6274,31 @@ ] }, "numChannels": { + "type": "integer", "format": "uint16", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "sampleRate": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "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": [ @@ -5180,14 +6309,15 @@ "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" @@ -5195,29 +6325,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" @@ -5225,15 +6355,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" @@ -5241,15 +6371,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": [ @@ -5263,15 +6393,16 @@ "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.", @@ -5283,16 +6414,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" @@ -5304,101 +6435,100 @@ "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", - "type": "string" + "title": "NotLoadedThreadStatusType" } }, + "title": "NotLoadedThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "NotLoadedThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType", - "type": "string" + "title": "IdleThreadStatusType" } }, + "title": "IdleThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "IdleThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType", - "type": "string" + "title": "SystemErrorThreadStatusType" } }, - "required": [ - "type" - ], - "title": "SystemErrorThreadStatus", - "type": "object" + "title": "SystemErrorThreadStatus" }, { - "properties": { - "activeFlags": { - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - }, - "type": "array" - }, - "type": { - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType", - "type": "string" - } - }, + "type": "object", "required": [ "activeFlags", "type" ], - "title": "ActiveThreadStatus", - "type": "object" + "properties": { + "activeFlags": { + "type": "array", + "items": { + "$ref": "#/definitions/ThreadActiveFlag" + } + }, + "type": { + "type": "string", + "enum": [ + "active" + ], + "title": "ActiveThreadStatusType" + } + }, + "title": "ActiveThreadStatus" } ] }, "ThreadStatusChangedNotification": { + "type": "object", + "required": [ + "status", + "threadId" + ], "properties": { "status": { "$ref": "#/definitions/ThreadStatus" @@ -5406,43 +6536,44 @@ "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" @@ -5453,48 +6584,21 @@ "turnId": { "type": "string" } - }, - "required": [ - "threadId", - "tokenUsage", - "turnId" - ], - "type": "object" + } }, "ThreadUnarchivedNotification": { + "type": "object", + "required": [ + "threadId" + ], "properties": { "threadId": { "type": "string" } - }, - "required": [ - "threadId" - ], - "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" - } - }, + "type": "object", "required": [ "cachedInputTokens", "inputTokens", @@ -5502,27 +6606,55 @@ "reasoningOutputTokens", "totalTokens" ], - "type": "object" + "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" + } + } }, "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" @@ -5530,39 +6662,37 @@ { "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" @@ -5570,15 +6700,16 @@ "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" @@ -5589,15 +6720,13 @@ "turnId": { "type": "string" } - }, - "required": [ - "diff", - "threadId", - "turnId" - ], - "type": "object" + } }, "TurnError": { + "type": "object", + "required": [ + "message" + ], "properties": { "additionalDetails": { "default": null, @@ -5619,13 +6748,14 @@ "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "TurnPlanStep": { + "type": "object", + "required": [ + "status", + "step" + ], "properties": { "status": { "$ref": "#/definitions/TurnPlanStepStatus" @@ -5633,22 +6763,23 @@ "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": [ @@ -5657,10 +6788,10 @@ ] }, "plan": { + "type": "array", "items": { "$ref": "#/definitions/TurnPlanStep" - }, - "type": "array" + } }, "threadId": { "type": "string" @@ -5668,15 +6799,14 @@ "turnId": { "type": "string" } - }, - "required": [ - "plan", - "threadId", - "turnId" - ], - "type": "object" + } }, "TurnStartedNotification": { + "type": "object", + "required": [ + "threadId", + "turn" + ], "properties": { "threadId": { "type": "string" @@ -5684,93 +6814,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -5779,22 +6910,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -5803,24 +6934,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WarningNotification": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "description": "Concise warning message for the user.", @@ -5833,24 +6962,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": [ @@ -5859,27 +6988,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -5888,13 +7017,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -5903,11 +7032,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -5916,31 +7045,32 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] }, "WindowsSandboxSetupCompletedNotification": { + "type": "object", + "required": [ + "mode", + "success" + ], "properties": { "error": { "type": [ @@ -5954,1192 +7084,38 @@ "success": { "type": "boolean" } - }, - "required": [ - "mode", - "success" - ], - "type": "object" + } }, "WindowsSandboxSetupMode": { + "type": "string", "enum": [ "elevated", "unelevated" - ], - "type": "string" + ] }, "WindowsWorldWritableWarningNotification": { - "properties": { - "extraCount": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "failedScan": { - "type": "boolean" - }, - "samplePaths": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "extraCount", "failedScan", "samplePaths" ], - "type": "object" + "properties": { + "extraCount": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "failedScan": { + "type": "boolean" + }, + "samplePaths": { + "type": "array", + "items": { + "type": "string" + } + } + } } - }, - "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": [ - "skills/changed" - ], - "title": "Skills/changedNotificationMethod", - "type": "string" - }, - "params": { - "$ref": "#/definitions/SkillsChangedNotification" - } - }, - "required": [ - "method", - "params" - ], - "title": "Skills/changedNotification", - "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 016dbe34..17abd327 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,51 +1,280 @@ { "$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": [ @@ -53,10 +282,10 @@ "null" ] } - }, - "type": "object" + } }, "AdditionalPermissionProfile": { + "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -78,10 +307,15 @@ } ] } - }, - "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].", @@ -91,10 +325,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).", @@ -110,15 +344,13 @@ "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`).", @@ -130,26 +362,29 @@ "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" @@ -161,23 +396,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -189,21 +422,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -221,39 +454,34 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, @@ -261,83 +489,92 @@ "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.", - "properties": { - "acceptWithExecpolicyAmendment": { - "properties": { - "execpolicy_amendment": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "execpolicy_amendment" - ], - "type": "object" - } - }, + "type": "object", "required": [ "acceptWithExecpolicyAmendment" ], - "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision", - "type": "object" + "properties": { + "acceptWithExecpolicyAmendment": { + "type": "object", + "required": [ + "execpolicy_amendment" + ], + "properties": { + "execpolicy_amendment": { + "type": "array", + "items": { + "type": "string" + } + } + } + } + }, + "additionalProperties": false, + "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision" }, { - "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" + } } }, - "required": [ - "applyNetworkPolicyAmendment" - ], - "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision", - "type": "object" + "additionalProperties": false, + "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision" }, { "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": [ @@ -345,6 +582,9 @@ "null" ] }, + "turnId": { + "type": "string" + }, "command": { "description": "The command to be executed.", "type": [ @@ -354,15 +594,16 @@ }, "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" @@ -370,13 +611,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" @@ -384,28 +625,27 @@ { "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).", @@ -413,22 +653,18 @@ "string", "null" ] - }, - "threadId": { - "type": "string" - }, - "turnId": { - "type": "string" } - }, - "required": [ - "itemId", - "threadId", - "turnId" - ], - "type": "object" + } }, "DynamicToolCallParams": { + "type": "object", + "required": [ + "arguments", + "callId", + "threadId", + "tool", + "turnId" + ], "properties": { "arguments": true, "callId": { @@ -449,17 +685,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.", @@ -473,10 +709,10 @@ "type": "string" }, "command": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "conversationId": { "$ref": "#/definitions/ThreadId" @@ -485,10 +721,10 @@ "type": "string" }, "parsedCmd": { + "type": "array", "items": { "$ref": "#/definitions/ParsedCommand" - }, - "type": "array" + } }, "reason": { "type": [ @@ -496,59 +732,56 @@ "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", - "type": "string" + "title": "AddFileChangeType" } }, + "title": "AddFileChange" + }, + { + "type": "object", "required": [ "content", "type" ], - "title": "AddFileChange", - "type": "object" - }, - { "properties": { "content": { "type": "string" }, "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeleteFileChangeType", - "type": "string" + "title": "DeleteFileChangeType" } }, - "required": [ - "content", - "type" - ], - "title": "DeleteFileChange", - "type": "object" + "title": "DeleteFileChange" }, { + "type": "object", + "required": [ + "type", + "unified_diff" + ], "properties": { "move_path": { "type": [ @@ -557,26 +790,27 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdateFileChangeType", - "type": "string" + "title": "UpdateFileChangeType" }, "unified_diff": { "type": "string" } }, - "required": [ - "type", - "unified_diff" - ], - "title": "UpdateFileChange", - "type": "object" + "title": "UpdateFileChange" } ] }, "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).", @@ -601,87 +835,86 @@ "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", - "type": "string" + "title": "PathFileSystemPathType" } }, - "required": [ - "path", - "type" - ], - "title": "PathFileSystemPath", - "type": "object" + "title": "PathFileSystemPath" }, { + "type": "object", + "required": [ + "pattern", + "type" + ], "properties": { "pattern": { "type": "string" }, "type": { + "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType", - "type": "string" + "title": "GlobPatternFileSystemPathType" } }, - "required": [ - "pattern", - "type" - ], - "title": "GlobPatternFileSystemPath", - "type": "object" + "title": "GlobPatternFileSystemPath" }, { + "type": "object", + "required": [ + "type", + "value" + ], "properties": { "type": { + "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType", - "type": "string" + "title": "SpecialFileSystemPathType" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "required": [ - "type", - "value" - ], - "title": "SpecialFileSystemPath", - "type": "object" + "title": "SpecialFileSystemPath" } ] }, "FileSystemSandboxEntry": { + "type": "object", + "required": [ + "access", + "path" + ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -689,67 +922,66 @@ "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": [ @@ -758,49 +990,50 @@ ] } }, + "title": "KindFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "KindFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "tmpdir" - ], - "type": "string" + ] } }, + "title": "TmpdirFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "TmpdirFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "slash_tmp" - ], - "type": "string" + ] } }, - "required": [ - "kind" - ], - "title": "SlashTmpFileSystemSpecialPath", - "type": "object" + "title": "SlashTmpFileSystemSpecialPath" }, { + "type": "object", + "required": [ + "kind", + "path" + ], "properties": { "kind": { + "type": "string", "enum": [ "unknown" - ], - "type": "string" + ] }, "path": { "type": "string" @@ -811,23 +1044,21 @@ "null" ] } - }, - "required": [ - "kind", - "path" - ], - "type": "object" + } } ] }, "McpElicitationArrayType": { + "type": "string", "enum": [ "array" - ], - "type": "string" + ] }, "McpElicitationBooleanSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "type" + ], "properties": { "default": { "type": [ @@ -851,19 +1082,20 @@ "$ref": "#/definitions/McpElicitationBooleanType" } }, - "required": [ - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationBooleanType": { + "type": "string", "enum": [ "boolean" - ], - "type": "string" + ] }, "McpElicitationConstOption": { - "additionalProperties": false, + "type": "object", + "required": [ + "const", + "title" + ], "properties": { "const": { "type": "string" @@ -872,11 +1104,7 @@ "type": "string" } }, - "required": [ - "const", - "title" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationEnumSchema": { "anyOf": [ @@ -892,7 +1120,11 @@ ] }, "McpElicitationLegacyTitledEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "enum", + "type" + ], "properties": { "default": { "type": [ @@ -907,19 +1139,19 @@ ] }, "enum": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "enumNames": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "title": { "type": [ @@ -931,11 +1163,7 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "enum", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationMultiSelectEnumSchema": { "anyOf": [ @@ -948,14 +1176,17 @@ ] }, "McpElicitationNumberSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "type" + ], "properties": { "default": { - "format": "double", "type": [ "number", "null" - ] + ], + "format": "double" }, "description": { "type": [ @@ -964,18 +1195,18 @@ ] }, "maximum": { - "format": "double", "type": [ "number", "null" - ] + ], + "format": "double" }, "minimum": { - "format": "double", "type": [ "number", "null" - ] + ], + "format": "double" }, "title": { "type": [ @@ -987,23 +1218,20 @@ "$ref": "#/definitions/McpElicitationNumberType" } }, - "required": [ - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationNumberType": { + "type": "string", "enum": [ "number", "integer" - ], - "type": "string" + ] }, "McpElicitationObjectType": { + "type": "string", "enum": [ "object" - ], - "type": "string" + ] }, "McpElicitationPrimitiveSchema": { "anyOf": [ @@ -1022,8 +1250,12 @@ ] }, "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": [ @@ -1032,29 +1264,25 @@ ] }, "properties": { + "type": "object", "additionalProperties": { "$ref": "#/definitions/McpElicitationPrimitiveSchema" - }, - "type": "object" + } }, "required": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "type": { "$ref": "#/definitions/McpElicitationObjectType" } }, - "required": [ - "properties", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationSingleSelectEnumSchema": { "anyOf": [ @@ -1067,16 +1295,19 @@ ] }, "McpElicitationStringFormat": { + "type": "string", "enum": [ "email", "uri", "date", "date-time" - ], - "type": "string" + ] }, "McpElicitationStringSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "type" + ], "properties": { "default": { "type": [ @@ -1101,20 +1332,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": [ @@ -1126,43 +1357,44 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationStringType": { + "type": "string", "enum": [ "string" - ], - "type": "string" + ] }, "McpElicitationTitledEnumItems": { - "additionalProperties": false, - "properties": { - "anyOf": { - "items": { - "$ref": "#/definitions/McpElicitationConstOption" - }, - "type": "array" - } - }, + "type": "object", "required": [ "anyOf" ], - "type": "object" + "properties": { + "anyOf": { + "type": "array", + "items": { + "$ref": "#/definitions/McpElicitationConstOption" + } + } + }, + "additionalProperties": false }, "McpElicitationTitledMultiSelectEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "items", + "type" + ], "properties": { "default": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "description": { "type": [ @@ -1174,20 +1406,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": [ @@ -1199,14 +1431,14 @@ "$ref": "#/definitions/McpElicitationArrayType" } }, - "required": [ - "items", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationTitledSingleSelectEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "oneOf", + "type" + ], "properties": { "default": { "type": [ @@ -1221,10 +1453,10 @@ ] }, "oneOf": { + "type": "array", "items": { "$ref": "#/definitions/McpElicitationConstOption" - }, - "type": "array" + } }, "title": { "type": [ @@ -1236,42 +1468,42 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "oneOf", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationUntitledEnumItems": { - "additionalProperties": false, + "type": "object", + "required": [ + "enum", + "type" + ], "properties": { "enum": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "type": { "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "enum", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationUntitledMultiSelectEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "items", + "type" + ], "properties": { "default": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "description": { "type": [ @@ -1283,20 +1515,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": [ @@ -1308,14 +1540,14 @@ "$ref": "#/definitions/McpElicitationArrayType" } }, - "required": [ - "items", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationUntitledSingleSelectEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "enum", + "type" + ], "properties": { "default": { "type": [ @@ -1330,10 +1562,10 @@ ] }, "enum": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": [ @@ -1345,38 +1577,42 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "enum", - "type" - ], - "type": "object" + "additionalProperties": false }, "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" } - }, - "required": [ - "message", - "mode", - "requestedSchema" - ], - "type": "object" + } }, { + "type": "object", + "required": [ + "elicitationId", + "message", + "mode", + "url" + ], "properties": { "_meta": true, "elicitationId": { @@ -1386,24 +1622,21 @@ "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" @@ -1418,14 +1651,14 @@ "null" ] } - }, - "required": [ - "serverName", - "threadId" - ], - "type": "object" + } }, "NetworkApprovalContext": { + "type": "object", + "required": [ + "host", + "protocol" + ], "properties": { "host": { "type": "string" @@ -1433,23 +1666,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" @@ -1457,23 +1690,25 @@ "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" @@ -1486,23 +1721,21 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadParsedCommandType", - "type": "string" + "title": "ReadParsedCommandType" } }, - "required": [ - "cmd", - "name", - "path", - "type" - ], - "title": "ReadParsedCommand", - "type": "object" + "title": "ReadParsedCommand" }, { + "type": "object", + "required": [ + "cmd", + "type" + ], "properties": { "cmd": { "type": "string" @@ -1514,21 +1747,21 @@ ] }, "type": { + "type": "string", "enum": [ "list_files" ], - "title": "ListFilesParsedCommandType", - "type": "string" + "title": "ListFilesParsedCommandType" } }, + "title": "ListFilesParsedCommand" + }, + { + "type": "object", "required": [ "cmd", "type" ], - "title": "ListFilesParsedCommand", - "type": "object" - }, - { "properties": { "cmd": { "type": "string" @@ -1546,43 +1779,46 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchParsedCommandType", - "type": "string" + "title": "SearchParsedCommandType" } }, + "title": "SearchParsedCommand" + }, + { + "type": "object", "required": [ "cmd", "type" ], - "title": "SearchParsedCommand", - "type": "object" - }, - { "properties": { "cmd": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownParsedCommandType", - "type": "string" + "title": "UnknownParsedCommandType" } }, - "required": [ - "cmd", - "type" - ], - "title": "UnknownParsedCommand", - "type": "object" + "title": "UnknownParsedCommand" } ] }, "PermissionsRequestApprovalParams": { + "type": "object", + "required": [ + "cwd", + "itemId", + "permissions", + "threadId", + "turnId" + ], "properties": { "cwd": { "$ref": "#/definitions/AbsolutePathBuf" @@ -1605,15 +1841,7 @@ "turnId": { "type": "string" } - }, - "required": [ - "cwd", - "itemId", - "permissions", - "threadId", - "turnId" - ], - "type": "object" + } }, "RequestId": { "anyOf": [ @@ -1621,13 +1849,13 @@ "type": "string" }, { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } ] }, "RequestPermissionProfile": { - "additionalProperties": false, + "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -1650,13 +1878,18 @@ ] } }, - "type": "object" + "additionalProperties": false }, "ThreadId": { "type": "string" }, "ToolRequestUserInputOption": { "description": "EXPERIMENTAL. Defines a single selectable option for request_user_input.", + "type": "object", + "required": [ + "description", + "label" + ], "properties": { "description": { "type": "string" @@ -1664,24 +1897,26 @@ "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" @@ -1689,17 +1924,16 @@ "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" @@ -1716,252 +1950,18 @@ "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 153d3bad..75b985dc 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,8 +1,39 @@ { "$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" @@ -10,15 +41,16 @@ "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" @@ -35,50 +67,18 @@ "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 3fd6fbc3..73d87dd0 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#", - "definitions": { - "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" - } - }, + "title": "ToolRequestUserInputResponse", "description": "EXPERIMENTAL. Response payload mapping question ids to answers.", - "properties": { - "answers": { - "additionalProperties": { - "$ref": "#/definitions/ToolRequestUserInputAnswer" - }, - "type": "object" - } - }, + "type": "object", "required": [ "answers" ], - "title": "ToolRequestUserInputResponse", - "type": "object" + "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", + "required": [ + "answers" + ], + "properties": { + "answers": { + "type": "array", + "items": { + "type": "string" + } + } + } + } + } } \ 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 6d878995..3e2e9762 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,11 +1,1810 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "CodexAppServerProtocol", + "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" + "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": [ + "skills/list" + ], + "title": "Skills/listRequestMethod" + }, + "params": { + "$ref": "#/definitions/v2/SkillsListParams" + } + }, + "title": "Skills/listRequest" + }, + { + "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" + } + ] }, "AdditionalPermissionProfile": { + "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -27,11 +1826,17 @@ } ] } - }, - "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].", @@ -41,10 +1846,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).", @@ -60,30 +1865,15 @@ "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`).", @@ -95,1645 +1885,111 @@ "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": [ - "skills/list" - ], - "title": "Skills/listRequestMethod", - "type": "string" - }, - "params": { - "$ref": "#/definitions/v2/SkillsListParams" - } - }, - "required": [ - "id", - "method", - "params" - ], - "title": "Skills/listRequest", - "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": [ - "skills/config/write" - ], - "title": "Skills/config/writeRequestMethod", - "type": "string" - }, - "params": { - "$ref": "#/definitions/v2/SkillsConfigWriteParams" - } - }, - "required": [ - "id", - "method", - "params" - ], - "title": "Skills/config/writeRequest", - "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.", - "properties": { - "acceptWithExecpolicyAmendment": { - "properties": { - "execpolicy_amendment": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "execpolicy_amendment" - ], - "type": "object" - } - }, + "type": "object", "required": [ "acceptWithExecpolicyAmendment" ], - "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision", - "type": "object" + "properties": { + "acceptWithExecpolicyAmendment": { + "type": "object", + "required": [ + "execpolicy_amendment" + ], + "properties": { + "execpolicy_amendment": { + "type": "array", + "items": { + "type": "string" + } + } + } + } + }, + "additionalProperties": false, + "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision" }, { - "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" + } } }, - "required": [ - "applyNetworkPolicyAmendment" - ], - "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision", - "type": "object" + "additionalProperties": false, + "title": "ApplyNetworkPolicyAmendmentCommandExecutionApprovalDecision" }, { "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": [ @@ -1741,6 +1997,9 @@ "null" ] }, + "turnId": { + "type": "string" + }, "command": { "description": "The command to be executed.", "type": [ @@ -1750,15 +2009,16 @@ }, "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" @@ -1766,13 +2026,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" @@ -1780,28 +2040,27 @@ { "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).", @@ -1809,37 +2068,20 @@ "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": { @@ -1860,39 +2102,19 @@ "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.", @@ -1906,10 +2128,10 @@ "type": "string" }, "command": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "conversationId": { "$ref": "#/definitions/v2/ThreadId" @@ -1918,10 +2140,10 @@ "type": "string" }, "parsedCmd": { + "type": "array", "items": { "$ref": "#/definitions/ParsedCommand" - }, - "type": "array" + } }, "reason": { "type": [ @@ -1929,73 +2151,56 @@ "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", - "type": "string" + "title": "AddFileChangeType" } }, + "title": "AddFileChange" + }, + { + "type": "object", "required": [ "content", "type" ], - "title": "AddFileChange", - "type": "object" - }, - { "properties": { "content": { "type": "string" }, "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeleteFileChangeType", - "type": "string" + "title": "DeleteFileChangeType" } }, - "required": [ - "content", - "type" - ], - "title": "DeleteFileChange", - "type": "object" + "title": "DeleteFileChange" }, { + "type": "object", + "required": [ + "type", + "unified_diff" + ], "properties": { "move_path": { "type": [ @@ -2004,59 +2209,29 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdateFileChangeType", - "type": "string" + "title": "UpdateFileChangeType" }, "unified_diff": { "type": "string" } }, - "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" + "title": "UpdateFileChange" } ] }, "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).", @@ -2081,381 +2256,19 @@ "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": { - "additionalProperties": false, + "type": "object", + "required": [ + "type" + ], "properties": { "default": { "type": [ @@ -2479,19 +2292,20 @@ "$ref": "#/definitions/McpElicitationBooleanType" } }, - "required": [ - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationBooleanType": { + "type": "string", "enum": [ "boolean" - ], - "type": "string" + ] }, "McpElicitationConstOption": { - "additionalProperties": false, + "type": "object", + "required": [ + "const", + "title" + ], "properties": { "const": { "type": "string" @@ -2500,11 +2314,7 @@ "type": "string" } }, - "required": [ - "const", - "title" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationEnumSchema": { "anyOf": [ @@ -2520,7 +2330,11 @@ ] }, "McpElicitationLegacyTitledEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "enum", + "type" + ], "properties": { "default": { "type": [ @@ -2535,19 +2349,19 @@ ] }, "enum": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "enumNames": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "title": { "type": [ @@ -2559,11 +2373,7 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "enum", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationMultiSelectEnumSchema": { "anyOf": [ @@ -2576,14 +2386,17 @@ ] }, "McpElicitationNumberSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "type" + ], "properties": { "default": { - "format": "double", "type": [ "number", "null" - ] + ], + "format": "double" }, "description": { "type": [ @@ -2592,18 +2405,18 @@ ] }, "maximum": { - "format": "double", "type": [ "number", "null" - ] + ], + "format": "double" }, "minimum": { - "format": "double", "type": [ "number", "null" - ] + ], + "format": "double" }, "title": { "type": [ @@ -2615,23 +2428,20 @@ "$ref": "#/definitions/McpElicitationNumberType" } }, - "required": [ - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationNumberType": { + "type": "string", "enum": [ "number", "integer" - ], - "type": "string" + ] }, "McpElicitationObjectType": { + "type": "string", "enum": [ "object" - ], - "type": "string" + ] }, "McpElicitationPrimitiveSchema": { "anyOf": [ @@ -2650,8 +2460,12 @@ ] }, "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": [ @@ -2660,29 +2474,25 @@ ] }, "properties": { + "type": "object", "additionalProperties": { "$ref": "#/definitions/McpElicitationPrimitiveSchema" - }, - "type": "object" + } }, "required": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "type": { "$ref": "#/definitions/McpElicitationObjectType" } }, - "required": [ - "properties", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationSingleSelectEnumSchema": { "anyOf": [ @@ -2695,16 +2505,19 @@ ] }, "McpElicitationStringFormat": { + "type": "string", "enum": [ "email", "uri", "date", "date-time" - ], - "type": "string" + ] }, "McpElicitationStringSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "type" + ], "properties": { "default": { "type": [ @@ -2729,20 +2542,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": [ @@ -2754,43 +2567,44 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationStringType": { + "type": "string", "enum": [ "string" - ], - "type": "string" + ] }, "McpElicitationTitledEnumItems": { - "additionalProperties": false, - "properties": { - "anyOf": { - "items": { - "$ref": "#/definitions/McpElicitationConstOption" - }, - "type": "array" - } - }, + "type": "object", "required": [ "anyOf" ], - "type": "object" + "properties": { + "anyOf": { + "type": "array", + "items": { + "$ref": "#/definitions/McpElicitationConstOption" + } + } + }, + "additionalProperties": false }, "McpElicitationTitledMultiSelectEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "items", + "type" + ], "properties": { "default": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "description": { "type": [ @@ -2802,20 +2616,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": [ @@ -2827,14 +2641,14 @@ "$ref": "#/definitions/McpElicitationArrayType" } }, - "required": [ - "items", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationTitledSingleSelectEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "oneOf", + "type" + ], "properties": { "default": { "type": [ @@ -2849,10 +2663,10 @@ ] }, "oneOf": { + "type": "array", "items": { "$ref": "#/definitions/McpElicitationConstOption" - }, - "type": "array" + } }, "title": { "type": [ @@ -2864,42 +2678,42 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "oneOf", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationUntitledEnumItems": { - "additionalProperties": false, + "type": "object", + "required": [ + "enum", + "type" + ], "properties": { "enum": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "type": { "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "enum", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationUntitledMultiSelectEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "items", + "type" + ], "properties": { "default": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "description": { "type": [ @@ -2911,20 +2725,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": [ @@ -2936,14 +2750,14 @@ "$ref": "#/definitions/McpElicitationArrayType" } }, - "required": [ - "items", - "type" - ], - "type": "object" + "additionalProperties": false }, "McpElicitationUntitledSingleSelectEnumSchema": { - "additionalProperties": false, + "type": "object", + "required": [ + "enum", + "type" + ], "properties": { "default": { "type": [ @@ -2958,10 +2772,10 @@ ] }, "enum": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": [ @@ -2973,47 +2787,44 @@ "$ref": "#/definitions/McpElicitationStringType" } }, - "required": [ - "enum", - "type" - ], - "type": "object" - }, - "McpServerElicitationAction": { - "enum": [ - "accept", - "decline", - "cancel" - ], - "type": "string" + "additionalProperties": false }, "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" } - }, - "required": [ - "message", - "mode", - "requestedSchema" - ], - "type": "object" + } }, { + "type": "object", + "required": [ + "elicitationId", + "message", + "mode", + "url" + ], "properties": { "_meta": true, "elicitationId": { @@ -3023,24 +2834,21 @@ "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" @@ -3055,34 +2863,14 @@ "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" @@ -3090,14 +2878,14 @@ "protocol": { "$ref": "#/definitions/v2/NetworkApprovalProtocol" } - }, - "required": [ - "host", - "protocol" - ], - "type": "object" + } }, "NetworkPolicyAmendment": { + "type": "object", + "required": [ + "action", + "host" + ], "properties": { "action": { "$ref": "#/definitions/NetworkPolicyRuleAction" @@ -3105,23 +2893,25 @@ "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" @@ -3134,23 +2924,21 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadParsedCommandType", - "type": "string" + "title": "ReadParsedCommandType" } }, - "required": [ - "cmd", - "name", - "path", - "type" - ], - "title": "ReadParsedCommand", - "type": "object" + "title": "ReadParsedCommand" }, { + "type": "object", + "required": [ + "cmd", + "type" + ], "properties": { "cmd": { "type": "string" @@ -3162,21 +2950,21 @@ ] }, "type": { + "type": "string", "enum": [ "list_files" ], - "title": "ListFilesParsedCommandType", - "type": "string" + "title": "ListFilesParsedCommandType" } }, + "title": "ListFilesParsedCommand" + }, + { + "type": "object", "required": [ "cmd", "type" ], - "title": "ListFilesParsedCommand", - "type": "object" - }, - { "properties": { "cmd": { "type": "string" @@ -3194,51 +2982,48 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchParsedCommandType", - "type": "string" + "title": "SearchParsedCommandType" } }, + "title": "SearchParsedCommand" + }, + { + "type": "object", "required": [ "cmd", "type" ], - "title": "SearchParsedCommand", - "type": "object" - }, - { "properties": { "cmd": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownParsedCommandType", - "type": "string" + "title": "UnknownParsedCommandType" } }, - "required": [ - "cmd", - "type" - ], - "title": "UnknownParsedCommand", - "type": "object" + "title": "UnknownParsedCommand" } ] }, - "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" @@ -3261,1545 +3046,15 @@ "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": [ - "skills/changed" - ], - "title": "Skills/changedNotificationMethod", - "type": "string" - }, - "params": { - "$ref": "#/definitions/v2/SkillsChangedNotification" - } - }, - "required": [ - "method", - "params" - ], - "title": "Skills/changedNotification", - "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" @@ -4807,25 +3062,28 @@ "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" @@ -4833,18 +3091,16 @@ "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" @@ -4861,110 +3117,3189 @@ "type": "boolean" }, "options": { - "items": { - "$ref": "#/definitions/ToolRequestUserInputOption" - }, "type": [ "array", "null" - ] + ], + "items": { + "$ref": "#/definitions/ToolRequestUserInputOption" + } }, "question": { "type": "string" } - }, - "required": [ - "header", - "id", - "question" - ], - "type": "object" + } }, - "ToolRequestUserInputResponse": { + "ServerRequest": { "$schema": "http://json-schema.org/draft-07/schema#", - "description": "EXPERIMENTAL. Response payload mapping question ids to answers.", - "properties": { - "answers": { - "additionalProperties": { - "$ref": "#/definitions/ToolRequestUserInputAnswer" + "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" + } }, - "type": "object" - } - }, - "required": [ - "answers" - ], - "title": "ToolRequestUserInputResponse", - "type": "object" - }, - "W3cTraceContext": { - "properties": { - "traceparent": { - "type": [ - "string", - "null" - ] + "title": "Item/commandExecution/requestApprovalRequest" }, - "tracestate": { - "type": [ - "string", - "null" - ] + { + "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" } - }, - "type": "object" + ] + }, + "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" + ], + "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 + } + } + }, + "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" + } + ] }, "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" }, - "Account": { + "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": [ { - "properties": { - "type": { - "enum": [ - "apiKey" - ], - "title": "ApiKeyAccountType", - "type": "string" - } - }, - "required": [ - "type" - ], - "title": "ApiKeyAccount", - "type": "object" + "type": "string", + "enum": [ + "untrusted", + "on-failure", + "on-request", + "never" + ] }, { + "type": "object", + "required": [ + "granular" + ], "properties": { - "email": { - "type": "string" - }, - "planType": { - "$ref": "#/definitions/v2/PlanType" - }, - "type": { - "enum": [ - "chatgpt" + "granular": { + "type": "object", + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" ], - "title": "ChatgptAccountType", - "type": "string" + "properties": { + "mcp_elicitations": { + "type": "boolean" + }, + "request_permissions": { + "default": false, + "type": "boolean" + }, + "rules": { + "type": "boolean" + }, + "sandbox_approval": { + "type": "boolean" + }, + "skill_approval": { + "default": false, + "type": "boolean" + } + } } }, - "required": [ - "email", - "planType", - "type" - ], - "title": "ChatgptAccount", - "type": "object" + "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": [ @@ -4981,28 +6316,7137 @@ "success": { "type": "boolean" } - }, + } + }, + "WindowsSandboxSetupCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "WindowsSandboxSetupCompletedNotification", + "type": "object", "required": [ + "mode", "success" ], - "title": "AccountLoginCompletedNotification", + "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", + "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" + } + } + }, + "SkillsListExtraRootsForCwd": { + "type": "object", + "required": [ + "cwd", + "extraUserRoots" + ], + "properties": { + "cwd": { + "type": "string" + }, + "extraUserRoots": { + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SkillsListParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "SkillsListParams", + "type": "object", + "properties": { + "cwds": { + "description": "When empty, defaults to the current session working directory.", + "type": "array", + "items": { + "type": "string" + } + }, + "forceReload": { + "description": "When true, bypass the skills cache and re-scan skills from disk.", + "type": "boolean" + }, + "perCwdExtraUserRoots": { + "description": "Optional per-cwd extra roots to scan as user-scoped skills.", + "default": null, + "type": [ + "array", + "null" + ], + "items": { + "$ref": "#/definitions/v2/SkillsListExtraRootsForCwd" + } + } + } + }, + "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": [ + "skill" + ], + "title": "SkillUserInputType" + } + }, + "title": "SkillUserInput" + }, + { + "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" + } + ] + }, + "summary": { + "description": "Override the reasoning summary for this turn and subsequent turns.", + "anyOf": [ + { + "$ref": "#/definitions/v2/ReasoningSummary" + }, + { + "type": "null" + } + ] + }, + "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" + } + ] + }, + "serviceTier": { + "description": "Override the service tier for this turn and subsequent turns.", + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/v2/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "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" + } + ] + }, + "threadId": { + "type": "string" + }, + "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": "ApiKeyv2::LoginAccountParams" + }, + { + "type": "object", + "required": [ + "type" + ], + "properties": { + "type": { + "type": "string", + "enum": [ + "chatgpt" + ], + "title": "Chatgptv2::LoginAccountParamsType" + } + }, + "title": "Chatgptv2::LoginAccountParams" + }, + { + "type": "object", + "required": [ + "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" + } + ] + }, + "CancelLoginAccountParams": { + "$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" + } + ] + }, + "message": { + "type": "string" + } + } + }, + "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" + ], + "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", "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": [ @@ -5024,77 +13468,2190 @@ } ] } - }, - "title": "AccountUpdatedNotification", + } + }, + "ThreadSetNameResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadSetNameResponse", "type": "object" }, - "AddCreditsNudgeCreditType": { - "enum": [ - "credits", - "usage_limit" + "ThreadMetadataUpdateResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadMetadataUpdateResponse", + "type": "object", + "required": [ + "thread" ], - "type": "string" - }, - "AddCreditsNudgeEmailStatus": { - "enum": [ - "sent", - "cooldown_active" - ], - "type": "string" - }, - "AdditionalFileSystemPermissions": { "properties": { - "entries": { - "items": { - "$ref": "#/definitions/v2/FileSystemSandboxEntry" - }, + "thread": { + "$ref": "#/definitions/v2/Thread" + } + } + }, + "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" + ] + } + ] + }, + "McpServerStatusUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "McpServerStatusUpdatedNotification", + "type": "object", + "required": [ + "name", + "status" + ], + "properties": { + "error": { "type": [ - "array", + "string", "null" ] }, - "globScanMaxDepth": { - "format": "uint", - "minimum": 1.0, + "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": [ - "integer", + "string", "null" ] }, - "read": { + "data": { + "type": "array", "items": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - "type": [ - "array", - "null" - ] + "$ref": "#/definitions/v2/Thread" + } }, - "write": { - "items": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, + "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": [ - "array", + "string", "null" ] } - }, - "type": "object" + } }, - "AdditionalNetworkPermissions": { + "ThreadLoadedListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadLoadedListResponse", + "type": "object", + "required": [ + "data" + ], "properties": { - "enabled": { + "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", + "launchModeling", + "reviewModelingResult", + "launchVerification", + "reviewVerificationResult", + "continueImplementation" + ] + }, + "ThreadEpiphanyCoordinatorSignals": { + "type": "object", + "required": [ + "crrcAction", + "modelingResultStatus", + "pressureLevel", + "reorientAction", + "reorientResultStatus", + "shouldPrepareCompaction", + "verificationResultStatus" + ], + "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" + }, + "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" + ] } - }, - "type": "object" + } }, - "AgentMessageDeltaNotification": { + "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" @@ -5108,383 +15665,1468 @@ "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" ], - "title": "AgentMessageDeltaNotification", - "type": "object" - }, - "AgentPath": { - "type": "string" - }, - "AnalyticsConfig": { - "additionalProperties": true, "properties": { - "enabled": { - "type": [ - "boolean", - "null" + "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" + } ] } - }, - "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": { + "CommandExecOutputStream": { + "description": "Stream label for `command/exec/outputDelta` notifications.", "oneOf": [ { + "description": "stdout stream. PTY mode multiplexes terminal output here.", + "type": "string", "enum": [ - "untrusted", - "on-failure", - "on-request", - "never" - ], - "type": "string" + "stdout" + ] }, { - "additionalProperties": false, - "properties": { - "granular": { - "properties": { - "mcp_elicitations": { - "type": "boolean" - }, - "request_permissions": { - "default": false, - "type": "boolean" - }, - "rules": { - "type": "boolean" - }, - "sandbox_approval": { - "type": "boolean" - }, - "skill_approval": { - "default": false, - "type": "boolean" - } - }, - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "type": "object" - } - }, - "required": [ - "granular" - ], - "title": "GranularAskForApproval", - "type": "object" + "description": "stderr stream.", + "type": "string", + "enum": [ + "stderr" + ] } ] }, - "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" - } - ] - }, - "AutoReviewDecisionSource": { - "description": "[UNSTABLE] Source that produced a terminal approval auto-review decision.", - "enum": [ - "agent" - ], - "type": "string" - }, - "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "ThreadEpiphanyRetrieveIndexSummary": { + "type": "object", "required": [ - "end", - "start" + "dirtyPaths", + "semanticAvailable", + "shards", + "status", + "workspaceRoot" ], - "type": "object" - }, - "CancelLoginAccountParams": { - "$schema": "http://json-schema.org/draft-07/schema#", "properties": { - "loginId": { - "type": "string" - } - }, - "required": [ - "loginId" - ], - "title": "CancelLoginAccountParams", - "type": "object" - }, - "CancelLoginAccountResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "properties": { - "status": { - "$ref": "#/definitions/v2/CancelLoginAccountStatus" - } - }, - "required": [ - "status" - ], - "title": "CancelLoginAccountResponse", - "type": "object" - }, - "CancelLoginAccountStatus": { - "enum": [ - "canceled", - "notFound" - ], - "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": [ - { - "enum": [ - "contextWindowExceeded", - "usageLimitExceeded", - "serverOverloaded", - "internalServerError", - "unauthorized", - "badRequest", - "threadRollbackFailed", - "sandboxError", - "other" - ], - "type": "string" + "dirtyPaths": { + "type": "array", + "items": { + "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/v2/NonSteerableTurnKind" - } - }, - "required": [ - "turnKind" - ], - "type": "object" - } - }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" - } - ] - }, - "CollabAgentState": { - "properties": { - "message": { + "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/CollabAgentStatus" + "$ref": "#/definitions/v2/EpiphanyRetrievalStatus" + }, + "workspaceRoot": { + "$ref": "#/definitions/v2/AbsolutePathBuf" } - }, + } + }, + "ThreadEpiphanyRetrieveShardSummary": { + "type": "object", "required": [ + "exactAvailable", + "pathPrefix", + "semanticAvailable", + "shardId", "status" ], - "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" + "exactAvailable": { + "type": "boolean" }, - "settings": { - "$ref": "#/definitions/v2/Settings" + "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" + } + } + }, + "ThreadEpiphanyRetrieveResult": { + "type": "object", + "required": [ + "kind", + "path", + "score" + ], + "properties": { + "excerpt": { + "type": [ + "string", + "null" + ] + }, + "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" + } + ] } }, + "additionalProperties": false + }, + "ThreadTurnsListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadTurnsListResponse", + "type": "object", "required": [ - "mode", - "settings" + "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/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" }, + "SkillDependencies": { + "type": "object", + "required": [ + "tools" + ], + "properties": { + "tools": { + "type": "array", + "items": { + "$ref": "#/definitions/v2/SkillToolDependency" + } + } + } + }, + "SkillErrorInfo": { + "type": "object", + "required": [ + "message", + "path" + ], + "properties": { + "message": { + "type": "string" + }, + "path": { + "type": "string" + } + } + }, + "SkillInterface": { + "type": "object", + "properties": { + "brandColor": { + "type": [ + "string", + "null" + ] + }, + "defaultPrompt": { + "type": [ + "string", + "null" + ] + }, + "displayName": { + "type": [ + "string", + "null" + ] + }, + "iconLarge": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + { + "type": "null" + } + ] + }, + "iconSmall": { + "anyOf": [ + { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + { + "type": "null" + } + ] + }, + "shortDescription": { + "type": [ + "string", + "null" + ] + } + } + }, + "SkillMetadata": { + "type": "object", + "required": [ + "description", + "enabled", + "name", + "path", + "scope" + ], + "properties": { + "dependencies": { + "anyOf": [ + { + "$ref": "#/definitions/v2/SkillDependencies" + }, + { + "type": "null" + } + ] + }, + "description": { + "type": "string" + }, + "enabled": { + "type": "boolean" + }, + "interface": { + "anyOf": [ + { + "$ref": "#/definitions/v2/SkillInterface" + }, + { + "type": "null" + } + ] + }, + "name": { + "type": "string" + }, + "path": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "scope": { + "$ref": "#/definitions/v2/SkillScope" + }, + "shortDescription": { + "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.", + "type": [ + "string", + "null" + ] + } + } + }, + "SkillScope": { + "type": "string", + "enum": [ + "user", + "repo", + "system", + "admin" + ] + }, + "SkillToolDependency": { + "type": "object", + "required": [ + "type", + "value" + ], + "properties": { + "command": { + "type": [ + "string", + "null" + ] + }, + "description": { + "type": [ + "string", + "null" + ] + }, + "transport": { + "type": [ + "string", + "null" + ] + }, + "type": { + "type": "string" + }, + "url": { + "type": [ + "string", + "null" + ] + }, + "value": { + "type": "string" + } + } + }, + "SkillsListEntry": { + "type": "object", + "required": [ + "cwd", + "errors", + "skills" + ], + "properties": { + "cwd": { + "type": "string" + }, + "errors": { + "type": "array", + "items": { + "$ref": "#/definitions/v2/SkillErrorInfo" + } + }, + "skills": { + "type": "array", + "items": { + "$ref": "#/definitions/v2/SkillMetadata" + } + } + } + }, + "SkillsListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "SkillsListResponse", + "type": "object", + "required": [ + "data" + ], + "properties": { + "data": { + "type": "array", + "items": { + "$ref": "#/definitions/v2/SkillsListEntry" + } + } + } + }, + "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": { + "$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.", + "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/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`.", + "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/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", + "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/v2/RealtimeVoice" + }, + "defaultV2": { + "$ref": "#/definitions/v2/RealtimeVoice" + }, + "v1": { + "type": "array", + "items": { + "$ref": "#/definitions/v2/RealtimeVoice" + } + }, + "v2": { + "type": "array", + "items": { + "$ref": "#/definitions/v2/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/v2/Turn" + } + } + }, + "InputModality": { + "description": "Canonical user-input modality tags advertised by a model.", + "oneOf": [ + { + "description": "Plain text turns and tool payloads.", + "type": "string", + "enum": [ + "text" + ] + }, + { + "description": "Image attachments included in user turns.", + "type": "string", + "enum": [ + "image" + ] + } + ] + }, + "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" + ], + "properties": { + "message": { + "type": "string" + } + } + }, + "ModelUpgradeInfo": { + "type": "object", + "required": [ + "model" + ], + "properties": { + "migrationMarkdown": { + "type": [ + "string", + "null" + ] + }, + "model": { + "type": "string" + }, + "modelLink": { + "type": [ + "string", + "null" + ] + }, + "upgradeCopy": { + "type": [ + "string", + "null" + ] + } + } + }, + "ReasoningEffortOption": { + "type": "object", + "required": [ + "description", + "reasoningEffort" + ], + "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" + } + } + } + }, "CollaborationModeMask": { "description": "EXPERIMENTAL - collaboration mode preset metadata for clients.", + "type": "object", + "required": [ + "name" + ], "properties": { "mode": { "anyOf": [ @@ -5522,317 +17164,886 @@ } ] } - }, - "required": [ - "name" - ], - "type": "object" + } }, - "CommandAction": { + "GuardianApprovalReviewAction": { "oneOf": [ { + "type": "object", + "required": [ + "command", + "cwd", + "source", + "type" + ], "properties": { "command": { "type": "string" }, - "name": { - "type": "string" - }, - "path": { + "cwd": { "$ref": "#/definitions/v2/AbsolutePathBuf" }, + "source": { + "$ref": "#/definitions/v2/GuardianCommandSource" + }, "type": { + "type": "string", "enum": [ - "read" + "command" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "CommandGuardianApprovalReviewActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "CommandGuardianApprovalReviewAction" }, { + "type": "object", + "required": [ + "argv", + "cwd", + "program", + "source", + "type" + ], "properties": { - "command": { + "argv": { + "type": "array", + "items": { + "type": "string" + } + }, + "cwd": { + "$ref": "#/definitions/v2/AbsolutePathBuf" + }, + "program": { "type": "string" }, - "path": { + "source": { + "$ref": "#/definitions/v2/GuardianCommandSource" + }, + "type": { + "type": "string", + "enum": [ + "execve" + ], + "title": "ExecveGuardianApprovalReviewActionType" + } + }, + "title": "ExecveGuardianApprovalReviewAction" + }, + { + "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": { + "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": { "type": [ "string", "null" ] }, "type": { + "type": "string", "enum": [ - "listFiles" + "mcpToolCall" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "McpToolCallGuardianApprovalReviewActionType" } }, - "required": [ - "command", - "type" - ], - "title": "ListFilesCommandAction", - "type": "object" + "title": "McpToolCallGuardianApprovalReviewAction" }, { + "type": "object", + "required": [ + "permissions", + "type" + ], "properties": { - "command": { - "type": "string" + "permissions": { + "$ref": "#/definitions/v2/RequestPermissionProfile" }, - "path": { - "type": [ - "string", - "null" - ] - }, - "query": { + "reason": { "type": [ "string", "null" ] }, "type": { + "type": "string", "enum": [ - "search" + "requestPermissions" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "RequestPermissionsGuardianApprovalReviewActionType" } }, - "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" + "title": "RequestPermissionsGuardianApprovalReviewAction" } ] }, - "CommandExecOutputDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "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": { - "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": { - "allOf": [ - { - "$ref": "#/definitions/v2/CommandExecOutputStream" - } - ], - "description": "Output stream for this chunk." - } - }, + "GuardianApprovalReview": { + "description": "[UNSTABLE] Temporary approval auto-review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.", + "type": "object", "required": [ - "capReached", - "deltaBase64", - "processId", - "stream" + "status" ], - "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.", + "rationale": { "type": [ "string", "null" ] }, - "disableOutputCap": { - "description": "Disable stdout/stderr capture truncation for this request.\n\nCannot be combined with `outputBytesCap`.", - "type": "boolean" + "riskLevel": { + "anyOf": [ + { + "$ref": "#/definitions/v2/GuardianRiskLevel" + }, + { + "type": "null" + } + ] }, - "disableTimeout": { - "description": "Disable the timeout entirely for this request.\n\nCannot be combined with `timeoutMs`.", - "type": "boolean" + "status": { + "$ref": "#/definitions/v2/GuardianApprovalReviewStatus" }, - "env": { + "userAuthorization": { + "anyOf": [ + { + "$ref": "#/definitions/v2/GuardianUserAuthorization" + }, + { + "type": "null" + } + ] + } + } + }, + "McpServerOauthLoginResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "McpServerOauthLoginResponse", + "type": "object", + "required": [ + "authorizationUrl" + ], + "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": { - "type": [ - "string", - "null" - ] + "$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" + } }, - "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.", + "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": { + "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" + } + ] + }, + "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" + } + ] + } + } + }, + "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.", + "allOf": [ + { + "$ref": "#/definitions/v2/RateLimitSnapshot" + } + ] + }, + "rateLimitsByLimitId": { + "description": "Multi-bucket view keyed by metered `limit_id` (for example, `codex`).", "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" - } ], - "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" + "additionalProperties": { + "$ref": "#/definitions/v2/RateLimitSnapshot" + } } - }, - "required": [ - "command" - ], - "title": "CommandExecParams", - "type": "object" + } }, - "CommandExecResizeParams": { + "AddCreditsNudgeEmailStatus": { + "type": "string", + "enum": [ + "sent", + "cooldown_active" + ] + }, + "SendAddCreditsNudgeEmailResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "description": "Resize a running PTY-backed `command/exec` session.", + "title": "SendAddCreditsNudgeEmailResponse", + "type": "object", + "required": [ + "status" + ], "properties": { - "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." + "status": { + "$ref": "#/definitions/v2/AddCreditsNudgeEmailStatus" } - }, - "required": [ - "processId", - "size" - ], - "title": "CommandExecResizeParams", - "type": "object" + } }, - "CommandExecResizeResponse": { + "FeedbackUploadResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "description": "Empty success response for `command/exec/resize`.", - "title": "CommandExecResizeResponse", - "type": "object" + "title": "FeedbackUploadResponse", + "type": "object", + "required": [ + "threadId" + ], + "properties": { + "threadId": { + "type": "string" + } + } }, "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.", - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "stderr": { "description": "Buffered stderr capture.\n\nEmpty when stderr was streamed via `command/exec/outputDelta`.", @@ -5842,135 +18053,40 @@ "description": "Buffered stdout capture.\n\nEmpty when stdout was streamed via `command/exec/outputDelta`.", "type": "string" } - }, - "required": [ - "exitCode", - "stderr", - "stdout" - ], - "title": "CommandExecResponse", - "type": "object" + } }, - "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": { + "CommandExecWriteResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "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", + "title": "CommandExecWriteResponse", + "description": "Empty success response for `command/exec/write`.", "type": "object" }, "CommandExecTerminateResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "description": "Empty success response for `command/exec/terminate`.", "title": "CommandExecTerminateResponse", + "description": "Empty success response for `command/exec/terminate`.", "type": "object" }, - "CommandExecWriteParams": { + "CommandExecResizeResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "description": "Write stdin bytes to a running `command/exec` session, close stdin, or both.", + "title": "CommandExecResizeResponse", + "description": "Empty success response for `command/exec/resize`.", + "type": "object" + }, + "AnalyticsConfig": { + "type": "object", "properties": { - "closeStdin": { - "description": "Close stdin after writing `deltaBase64`, if present.", - "type": "boolean" - }, - "deltaBase64": { - "description": "Optional base64-encoded stdin bytes to write.", + "enabled": { "type": [ - "string", + "boolean", "null" ] - }, - "processId": { - "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", - "type": "string" } }, - "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" + "additionalProperties": true }, "Config": { - "additionalProperties": true, + "type": "object", "properties": { "analytics": { "anyOf": [ @@ -5993,6 +18109,7 @@ ] }, "approvals_reviewer": { + "description": "[UNSTABLE] Optional default for where approval requests are routed for review.", "anyOf": [ { "$ref": "#/definitions/v2/ApprovalsReviewer" @@ -6000,8 +18117,7 @@ { "type": "null" } - ], - "description": "[UNSTABLE] Optional default for where approval requests are routed for review." + ] }, "compact_prompt": { "type": [ @@ -6044,18 +18160,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": [ @@ -6100,11 +18216,11 @@ ] }, "profiles": { + "default": {}, + "type": "object", "additionalProperties": { "$ref": "#/definitions/v2/ProfileV2" - }, - "default": {}, - "type": "object" + } }, "review_model": { "type": [ @@ -6163,59 +18279,15 @@ ] } }, - "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" + "additionalProperties": true }, "ConfigLayer": { + "type": "object", + "required": [ + "config", + "name", + "version" + ], "properties": { "config": true, "disabledReason": { @@ -6230,15 +18302,14 @@ "version": { "type": "string" } - }, + } + }, + "ConfigLayerMetadata": { + "type": "object", "required": [ - "config", "name", "version" ], - "type": "object" - }, - "ConfigLayerMetadata": { "properties": { "name": { "$ref": "#/definitions/v2/ConfigLayerSource" @@ -6246,17 +18317,18 @@ "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" @@ -6265,5392 +18337,153 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mdm" ], - "title": "MdmConfigLayerSourceType", - "type": "string" + "title": "MdmConfigLayerSourceType" } }, - "required": [ - "domain", - "key", - "type" - ], - "title": "MdmConfigLayerSource", - "type": "object" + "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/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", - "type": "string" + "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" ], - "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", - "type": "string" + "title": "UserConfigLayerSourceType" } }, - "required": [ - "file", - "type" - ], - "title": "UserConfigLayerSource", - "type": "object" + "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/v2/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "project" ], - "title": "ProjectConfigLayerSourceType", - "type": "string" + "title": "ProjectConfigLayerSourceType" } }, - "required": [ - "dotCodexFolder", - "type" - ], - "title": "ProjectConfigLayerSource", - "type": "object" + "title": "ProjectConfigLayerSource" }, { "description": "Session-layer overrides supplied via `-c`/`--config`.", - "properties": { - "type": { - "enum": [ - "sessionFlags" - ], - "title": "SessionFlagsConfigLayerSourceType", - "type": "string" - } - }, + "type": "object", "required": [ "type" ], - "title": "SessionFlagsConfigLayerSource", - "type": "object" + "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/v2/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "legacyManagedConfigTomlFromFile" ], - "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType", - "type": "string" + "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType" } }, - "required": [ - "file", - "type" - ], - "title": "LegacyManagedConfigTomlFromFileConfigLayerSource", - "type": "object" + "title": "LegacyManagedConfigTomlFromFileConfigLayerSource" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "legacyManagedConfigTomlFromMdm" ], - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType", - "type": "string" + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType" } }, - "required": [ - "type" - ], - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource", - "type": "object" + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource" } ] }, - "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": { - "additionalProperties": true, + "type": "object", "properties": { "approval_policy": { "anyOf": [ @@ -11663,6 +18496,7 @@ ] }, "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" @@ -11670,8 +18504,7 @@ { "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": [ @@ -11752,1487 +18585,10 @@ ] } }, - "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" - } - ] + "additionalProperties": true }, "SandboxWorkspaceWrite": { + "type": "object", "properties": { "exclude_slash_tmp": { "default": false, @@ -13248,5905 +18604,15 @@ }, "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" - }, - "SkillDependencies": { - "properties": { - "tools": { - "items": { - "$ref": "#/definitions/v2/SkillToolDependency" - }, - "type": "array" - } - }, - "required": [ - "tools" - ], - "type": "object" - }, - "SkillErrorInfo": { - "properties": { - "message": { - "type": "string" - }, - "path": { - "type": "string" - } - }, - "required": [ - "message", - "path" - ], - "type": "object" - }, - "SkillInterface": { - "properties": { - "brandColor": { - "type": [ - "string", - "null" - ] - }, - "defaultPrompt": { - "type": [ - "string", - "null" - ] - }, - "displayName": { - "type": [ - "string", - "null" - ] - }, - "iconLarge": { - "anyOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - { - "type": "null" - } - ] - }, - "iconSmall": { - "anyOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - { - "type": "null" - } - ] - }, - "shortDescription": { - "type": [ - "string", - "null" - ] - } - }, - "type": "object" - }, - "SkillMetadata": { - "properties": { - "dependencies": { - "anyOf": [ - { - "$ref": "#/definitions/v2/SkillDependencies" - }, - { - "type": "null" - } - ] - }, - "description": { - "type": "string" - }, - "enabled": { - "type": "boolean" - }, - "interface": { - "anyOf": [ - { - "$ref": "#/definitions/v2/SkillInterface" - }, - { - "type": "null" - } - ] - }, - "name": { - "type": "string" - }, - "path": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - "scope": { - "$ref": "#/definitions/v2/SkillScope" - }, - "shortDescription": { - "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.", - "type": [ - "string", - "null" - ] - } - }, - "required": [ - "description", - "enabled", - "name", - "path", - "scope" - ], - "type": "object" - }, - "SkillScope": { - "enum": [ - "user", - "repo", - "system", - "admin" - ], - "type": "string" - }, - "SkillToolDependency": { - "properties": { - "command": { - "type": [ - "string", - "null" - ] - }, - "description": { - "type": [ - "string", - "null" - ] - }, - "transport": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string" - }, - "url": { - "type": [ - "string", - "null" - ] - }, - "value": { - "type": "string" - } - }, - "required": [ - "type", - "value" - ], - "type": "object" - }, - "SkillsChangedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "description": "Notification emitted when watched local skill files change.\n\nTreat this as an invalidation signal and re-run `skills/list` with the client's current parameters when refreshed skill metadata is needed.", - "title": "SkillsChangedNotification", - "type": "object" - }, - "SkillsConfigWriteParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "properties": { - "enabled": { - "type": "boolean" - }, - "name": { - "description": "Name-based selector.", - "type": [ - "string", - "null" - ] - }, - "path": { - "anyOf": [ - { - "$ref": "#/definitions/v2/AbsolutePathBuf" - }, - { - "type": "null" - } - ], - "description": "Path-based selector." - } - }, - "required": [ - "enabled" - ], - "title": "SkillsConfigWriteParams", - "type": "object" - }, - "SkillsConfigWriteResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "properties": { - "effectiveEnabled": { - "type": "boolean" - } - }, - "required": [ - "effectiveEnabled" - ], - "title": "SkillsConfigWriteResponse", - "type": "object" - }, - "SkillsListEntry": { - "properties": { - "cwd": { - "type": "string" - }, - "errors": { - "items": { - "$ref": "#/definitions/v2/SkillErrorInfo" - }, - "type": "array" - }, - "skills": { - "items": { - "$ref": "#/definitions/v2/SkillMetadata" - }, - "type": "array" - } - }, - "required": [ - "cwd", - "errors", - "skills" - ], - "type": "object" - }, - "SkillsListExtraRootsForCwd": { - "properties": { - "cwd": { - "type": "string" - }, - "extraUserRoots": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "cwd", - "extraUserRoots" - ], - "type": "object" - }, - "SkillsListParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "properties": { - "cwds": { - "description": "When empty, defaults to the current session working directory.", - "items": { - "type": "string" - }, - "type": "array" - }, - "forceReload": { - "description": "When true, bypass the skills cache and re-scan skills from disk.", - "type": "boolean" - }, - "perCwdExtraUserRoots": { - "default": null, - "description": "Optional per-cwd extra roots to scan as user-scoped skills.", - "items": { - "$ref": "#/definitions/v2/SkillsListExtraRootsForCwd" - }, - "type": [ - "array", - "null" - ] - } - }, - "title": "SkillsListParams", - "type": "object" - }, - "SkillsListResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "properties": { - "data": { - "items": { - "$ref": "#/definitions/v2/SkillsListEntry" - }, - "type": "array" - } - }, - "required": [ - "data" - ], - "title": "SkillsListResponse", - "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", - "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" - }, - "shouldPrepareCompaction": { - "type": "boolean" - }, - "verificationResultStatus": { - "$ref": "#/definitions/v2/ThreadEpiphanyRoleResultStatus" - } - }, - "required": [ - "crrcAction", - "modelingResultStatus", - "pressureLevel", - "reorientAction", - "reorientResultStatus", - "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" - }, - "ThreadEpiphanyRetrieveIndexSummary": { - "properties": { - "dirtyPaths": { - "items": { - "type": "string" - }, - "type": "array" - }, - "indexRevision": { - "type": [ - "string", - "null" - ] - }, - "indexedChunkCount": { - "format": "uint32", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - }, - "indexedFileCount": { - "format": "uint32", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - }, - "lastIndexedAtUnixSeconds": { - "format": "int64", - "type": [ - "integer", - "null" - ] - }, - "semanticAvailable": { - "type": "boolean" - }, - "shards": { - "items": { - "$ref": "#/definitions/v2/ThreadEpiphanyRetrieveShardSummary" - }, - "type": "array" - }, - "status": { - "$ref": "#/definitions/v2/EpiphanyRetrievalStatus" - }, - "workspaceRoot": { - "$ref": "#/definitions/v2/AbsolutePathBuf" - } - }, - "required": [ - "dirtyPaths", - "semanticAvailable", - "shards", - "status", - "workspaceRoot" - ], - "type": "object" - }, - "ThreadEpiphanyRetrieveResult": { - "properties": { - "excerpt": { - "type": [ - "string", - "null" - ] - }, - "kind": { - "$ref": "#/definitions/v2/ThreadEpiphanyRetrieveResultKind" - }, - "lineEnd": { - "format": "uint32", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - }, - "lineStart": { - "format": "uint32", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - }, - "path": { - "type": "string" - }, - "score": { - "format": "float", - "type": "number" - } - }, - "required": [ - "kind", - "path", - "score" - ], - "type": "object" - }, - "ThreadEpiphanyRetrieveResultKind": { - "enum": [ - "exactFile", - "exactDirectory", - "semanticChunk" - ], - "type": "string" - }, - "ThreadEpiphanyRetrieveShardSummary": { - "properties": { - "exactAvailable": { - "type": "boolean" - }, - "indexedChunkCount": { - "format": "uint32", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - }, - "indexedFileCount": { - "format": "uint32", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - }, - "pathPrefix": { - "type": "string" - }, - "semanticAvailable": { - "type": "boolean" - }, - "shardId": { - "type": "string" - }, - "status": { - "$ref": "#/definitions/v2/EpiphanyRetrievalStatus" - } - }, - "required": [ - "exactAvailable", - "pathPrefix", - "semanticAvailable", - "shardId", - "status" - ], - "type": "object" - }, - "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", - "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" - }, - "ThreadEpiphanyWorkerLaunchDocument": { - "oneOf": [ - { - "properties": { - "activeGraphNodeIds": { - "items": { - "type": "string" - }, - "type": "array" - }, - "activeSubgoalId": { - "type": [ - "string", - "null" - ] - }, - "activeSubgoals": { - "items": { - "$ref": "#/definitions/v2/EpiphanySubgoal" - }, - "type": "array" - }, - "churn": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyChurnState" - }, - { - "type": "null" - } - ] - }, - "documentKind": { - "enum": [ - "role" - ], - "type": "string" - }, - "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" - }, - "investigationCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "objective": { - "type": [ - "string", - "null" - ] - }, - "planning": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyPlanningState" - }, - { - "type": "null" - } - ] - }, - "recentEvidence": { - "items": { - "$ref": "#/definitions/v2/EpiphanyEvidenceRecord" - }, - "type": "array" - }, - "recentObservations": { - "items": { - "$ref": "#/definitions/v2/EpiphanyObservation" - }, - "type": "array" - }, - "roleId": { - "type": "string" - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "stateRevision": { - "format": "uint64", - "minimum": 0.0, - "type": "integer" - }, - "threadId": { - "type": "string" - } - }, - "required": [ - "documentKind", - "roleId", - "stateRevision", - "threadId" - ], - "type": "object" - }, - { - "properties": { - "activeFrontierNodeIds": { - "items": { - "type": "string" - }, - "type": "array" - }, - "checkpointChangedPaths": { - "items": { - "type": "string" - }, - "type": "array" - }, - "checkpointCodeRefs": { - "items": { - "$ref": "#/definitions/v2/EpiphanyCodeRef" - }, - "type": "array" - }, - "checkpointDirtyPaths": { - "items": { - "type": "string" - }, - "type": "array" - }, - "checkpointDisposition": { - "type": "string" - }, - "checkpointEvidenceIds": { - "items": { - "type": "string" - }, - "type": "array" - }, - "checkpointFocus": { - "type": [ - "string", - "null" - ] - }, - "checkpointId": { - "type": "string" - }, - "checkpointKind": { - "type": "string" - }, - "checkpointNextAction": { - "type": "string" - }, - "checkpointOpenQuestions": { - "items": { - "type": "string" - }, - "type": "array" - }, - "checkpointSummary": { - "type": [ - "string", - "null" - ] - }, - "decisionNote": { - "type": "string" - }, - "decisionReasons": { - "items": { - "type": "string" - }, - "type": "array" - }, - "documentKind": { - "enum": [ - "reorient" - ], - "type": "string" - }, - "graphStatus": { - "type": "string" - }, - "graphs": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyGraphs" - }, - { - "type": "null" - } - ] - }, - "linkedGraphNodeIds": { - "items": { - "type": "string" - }, - "type": "array" - }, - "linkedSubgoalIds": { - "items": { - "type": "string" - }, - "type": "array" - }, - "mode": { - "type": "string" - }, - "pressureLevel": { - "type": "string" - }, - "recentEvidence": { - "items": { - "$ref": "#/definitions/v2/EpiphanyEvidenceRecord" - }, - "type": "array" - }, - "recentObservations": { - "items": { - "$ref": "#/definitions/v2/EpiphanyObservation" - }, - "type": "array" - }, - "retrievalStatus": { - "type": "string" - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/v2/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - }, - "watcherStatus": { - "type": "string" - } - }, - "required": [ - "checkpointDisposition", - "checkpointId", - "checkpointKind", - "checkpointNextAction", - "decisionNote", - "documentKind", - "graphStatus", - "mode", - "pressureLevel", - "retrievalStatus", - "threadId", - "watcherStatus" - ], - "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": [ @@ -19164,694 +18630,27 @@ } ] } - }, - "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": [ - "skill" - ], - "title": "SkillUserInputType", - "type": "string" - } - }, - "required": [ - "name", - "path", - "type" - ], - "title": "SkillUserInput", - "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": { - "additionalProperties": false, + "type": "object", "properties": { "city": { "type": [ @@ -19878,27 +18677,27 @@ ] } }, - "type": "object" + "additionalProperties": false }, "WebSearchMode": { + "type": "string", "enum": [ "disabled", "cached", "live" - ], - "type": "string" + ] }, "WebSearchToolConfig": { - "additionalProperties": false, + "type": "object", "properties": { "allowed_domains": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "context_size": { "anyOf": [ @@ -19921,109 +18720,1216 @@ ] } }, - "type": "object" + "additionalProperties": false }, - "WindowsSandboxSetupCompletedNotification": { + "ConfigReadResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "properties": { - "error": { - "type": [ - "string", - "null" - ] - }, - "mode": { - "$ref": "#/definitions/v2/WindowsSandboxSetupMode" - }, - "success": { - "type": "boolean" - } - }, + "title": "ConfigReadResponse", + "type": "object", "required": [ - "mode", - "success" + "config", + "origins" ], - "title": "WindowsSandboxSetupCompletedNotification", - "type": "object" - }, - "WindowsSandboxSetupMode": { - "enum": [ - "elevated", - "unelevated" - ], - "type": "string" - }, - "WindowsSandboxSetupStartParams": { - "$schema": "http://json-schema.org/draft-07/schema#", "properties": { - "cwd": { - "anyOf": [ + "config": { + "$ref": "#/definitions/v2/Config" + }, + "layers": { + "type": [ + "array", + "null" + ], + "items": { + "$ref": "#/definitions/v2/ConfigLayer" + } + }, + "origins": { + "type": "object", + "additionalProperties": { + "$ref": "#/definitions/v2/ConfigLayerMetadata" + } + } + } + }, + "OverriddenMetadata": { + "type": "object", + "required": [ + "effectiveValue", + "message", + "overridingLayer" + ], + "properties": { + "effectiveValue": true, + "message": { + "type": "string" + }, + "overridingLayer": { + "$ref": "#/definitions/v2/ConfigLayerMetadata" + } + } + }, + "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" } ] }, - "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" + "status": { + "$ref": "#/definitions/v2/WriteStatus" }, - "failedScan": { - "type": "boolean" + "version": { + "type": "string" + } + } + }, + "ConfigRequirements": { + "type": "object", + "properties": { + "allowedApprovalPolicies": { + "type": [ + "array", + "null" + ], + "items": { + "$ref": "#/definitions/v2/AskForApproval" + } }, - "samplePaths": { + "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" + } }, - "type": "array" + "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" + ] + } + } + } + }, + "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" } }, - "required": [ - "extraCount", - "failedScan", - "samplePaths" - ], - "title": "WindowsWorldWritableWarningNotification", - "type": "object" - }, - "WriteStatus": { - "enum": [ - "ok", - "okOverridden" - ], - "type": "string" + "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 dd27fee4..110f403d 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,56 +1,1707 @@ { "$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" }, - "Account": { + "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": [ { - "properties": { - "type": { - "enum": [ - "apiKey" - ], - "title": "ApiKeyAccountType", - "type": "string" - } - }, - "required": [ - "type" - ], - "title": "ApiKeyAccount", - "type": "object" + "type": "string", + "enum": [ + "untrusted", + "on-failure", + "on-request", + "never" + ] }, { + "type": "object", + "required": [ + "granular" + ], "properties": { - "email": { - "type": "string" - }, - "planType": { - "$ref": "#/definitions/PlanType" - }, - "type": { - "enum": [ - "chatgpt" + "granular": { + "type": "object", + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" ], - "title": "ChatgptAccountType", - "type": "string" + "properties": { + "mcp_elicitations": { + "type": "boolean" + }, + "request_permissions": { + "default": false, + "type": "boolean" + }, + "rules": { + "type": "boolean" + }, + "sandbox_approval": { + "type": "boolean" + }, + "skill_approval": { + "default": false, + "type": "boolean" + } + } } }, - "required": [ - "email", - "planType", - "type" - ], - "title": "ChatgptAccount", - "type": "object" + "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": [ @@ -67,28 +1718,7137 @@ "success": { "type": "boolean" } - }, + } + }, + "WindowsSandboxSetupCompletedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "WindowsSandboxSetupCompletedNotification", + "type": "object", "required": [ + "mode", "success" ], - "title": "AccountLoginCompletedNotification", + "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", + "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" + } + } + }, + "SkillsListExtraRootsForCwd": { + "type": "object", + "required": [ + "cwd", + "extraUserRoots" + ], + "properties": { + "cwd": { + "type": "string" + }, + "extraUserRoots": { + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SkillsListParams": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "SkillsListParams", + "type": "object", + "properties": { + "cwds": { + "description": "When empty, defaults to the current session working directory.", + "type": "array", + "items": { + "type": "string" + } + }, + "forceReload": { + "description": "When true, bypass the skills cache and re-scan skills from disk.", + "type": "boolean" + }, + "perCwdExtraUserRoots": { + "description": "Optional per-cwd extra roots to scan as user-scoped skills.", + "default": null, + "type": [ + "array", + "null" + ], + "items": { + "$ref": "#/definitions/SkillsListExtraRootsForCwd" + } + } + } + }, + "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": [ + "skill" + ], + "title": "SkillUserInputType" + } + }, + "title": "SkillUserInput" + }, + { + "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" + } + ] + }, + "summary": { + "description": "Override the reasoning summary for this turn and subsequent turns.", + "anyOf": [ + { + "$ref": "#/definitions/ReasoningSummary" + }, + { + "type": "null" + } + ] + }, + "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" + } + ] + }, + "serviceTier": { + "description": "Override the service tier for this turn and subsequent turns.", + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "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" + } + ] + }, + "threadId": { + "type": "string" + }, + "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": "ApiKeyv2::LoginAccountParams" + }, + { + "type": "object", + "required": [ + "type" + ], + "properties": { + "type": { + "type": "string", + "enum": [ + "chatgpt" + ], + "title": "Chatgptv2::LoginAccountParamsType" + } + }, + "title": "Chatgptv2::LoginAccountParams" + }, + { + "type": "object", + "required": [ + "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" + } + ] + }, + "CancelLoginAccountParams": { + "$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" + } + ] + }, + "message": { + "type": "string" + } + } + }, + "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" + ], + "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", "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": [ @@ -110,77 +8870,2190 @@ } ] } - }, - "title": "AccountUpdatedNotification", + } + }, + "ThreadSetNameResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadSetNameResponse", "type": "object" }, - "AddCreditsNudgeCreditType": { - "enum": [ - "credits", - "usage_limit" + "ThreadMetadataUpdateResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadMetadataUpdateResponse", + "type": "object", + "required": [ + "thread" ], - "type": "string" - }, - "AddCreditsNudgeEmailStatus": { - "enum": [ - "sent", - "cooldown_active" - ], - "type": "string" - }, - "AdditionalFileSystemPermissions": { "properties": { - "entries": { - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - }, + "thread": { + "$ref": "#/definitions/Thread" + } + } + }, + "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" + ] + } + ] + }, + "McpServerStatusUpdatedNotification": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "McpServerStatusUpdatedNotification", + "type": "object", + "required": [ + "name", + "status" + ], + "properties": { + "error": { "type": [ - "array", + "string", "null" ] }, - "globScanMaxDepth": { - "format": "uint", - "minimum": 1.0, + "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": [ - "integer", + "string", "null" ] }, - "read": { + "data": { + "type": "array", "items": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": [ - "array", - "null" - ] + "$ref": "#/definitions/Thread" + } }, - "write": { - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - }, + "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": [ - "array", + "string", "null" ] } - }, - "type": "object" + } }, - "AdditionalNetworkPermissions": { + "ThreadLoadedListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadLoadedListResponse", + "type": "object", + "required": [ + "data" + ], "properties": { - "enabled": { + "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", + "launchModeling", + "reviewModelingResult", + "launchVerification", + "reviewVerificationResult", + "continueImplementation" + ] + }, + "ThreadEpiphanyCoordinatorSignals": { + "type": "object", + "required": [ + "crrcAction", + "modelingResultStatus", + "pressureLevel", + "reorientAction", + "reorientResultStatus", + "shouldPrepareCompaction", + "verificationResultStatus" + ], + "properties": { + "crrcAction": { + "$ref": "#/definitions/ThreadEpiphanyCrrcAction" + }, + "modelingResultStatus": { + "$ref": "#/definitions/ThreadEpiphanyRoleResultStatus" + }, + "pressureLevel": { + "$ref": "#/definitions/ThreadEpiphanyPressureLevel" + }, + "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" + ] } - }, - "type": "object" + } }, - "AgentMessageDeltaNotification": { + "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" @@ -194,1877 +11067,1468 @@ "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" ], - "title": "AgentMessageDeltaNotification", - "type": "object" - }, - "AgentPath": { - "type": "string" - }, - "AnalyticsConfig": { - "additionalProperties": true, "properties": { - "enabled": { - "type": [ - "boolean", - "null" + "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" + } ] } - }, - "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" + "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" ], - "type": "string" - }, - "AskForApproval": { - "oneOf": [ - { - "enum": [ - "untrusted", - "on-failure", - "on-request", - "never" - ], - "type": "string" + "properties": { + "dirtyPaths": { + "type": "array", + "items": { + "type": "string" + } }, - { - "additionalProperties": false, - "properties": { - "granular": { - "properties": { - "mcp_elicitations": { - "type": "boolean" - }, - "request_permissions": { - "default": false, - "type": "boolean" - }, - "rules": { - "type": "boolean" - }, - "sandbox_approval": { - "type": "boolean" - }, - "skill_approval": { - "default": false, - "type": "boolean" - } - }, - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "type": "object" - } - }, - "required": [ - "granular" + "indexRevision": { + "type": [ + "string", + "null" + ] + }, + "indexedChunkCount": { + "type": [ + "integer", + "null" ], - "title": "GranularAskForApproval", - "type": "object" + "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" } - ] + } }, - "AuthMode": { - "description": "Authentication mode for OpenAI-backed providers.", - "oneOf": [ - { - "description": "OpenAI API key provided by the caller and stored by Codex.", - "enum": [ - "apikey" + "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" }, - { - "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).", - "enum": [ - "chatgpt" - ], + "semanticAvailable": { + "type": "boolean" + }, + "shardId": { "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" - ], + "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" }, - { - "description": "Programmatic Codex auth backed by a registered Agent Identity.", - "enum": [ - "agentIdentity" - ], + "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" - ], - "type": "string" + ] }, - "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, - "required": [ - "end", - "start" - ], - "type": "object" - }, - "CancelLoginAccountParams": { + "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": { - "loginId": { + "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": [ - "loginId" - ], - "title": "CancelLoginAccountParams", - "type": "object" + } }, - "CancelLoginAccountResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", + "ThreadEpiphanyRetrieveResult": { + "type": "object", + "required": [ + "kind", + "path", + "score" + ], "properties": { - "status": { - "$ref": "#/definitions/CancelLoginAccountStatus" + "excerpt": { + "type": [ + "string", + "null" + ] + }, + "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" + } + ] } }, + "additionalProperties": false + }, + "ThreadTurnsListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadTurnsListResponse", + "type": "object", "required": [ - "status" + "data" ], - "title": "CancelLoginAccountResponse", + "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" + ] + } + } + }, + "ThreadInjectItemsResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadInjectItemsResponse", "type": "object" }, - "CancelLoginAccountStatus": { - "enum": [ - "canceled", - "notFound" + "SkillDependencies": { + "type": "object", + "required": [ + "tools" ], - "type": "string" - }, - "ClientInfo": { "properties": { + "tools": { + "type": "array", + "items": { + "$ref": "#/definitions/SkillToolDependency" + } + } + } + }, + "SkillErrorInfo": { + "type": "object", + "required": [ + "message", + "path" + ], + "properties": { + "message": { + "type": "string" + }, + "path": { + "type": "string" + } + } + }, + "SkillInterface": { + "type": "object", + "properties": { + "brandColor": { + "type": [ + "string", + "null" + ] + }, + "defaultPrompt": { + "type": [ + "string", + "null" + ] + }, + "displayName": { + "type": [ + "string", + "null" + ] + }, + "iconLarge": { + "anyOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + }, + { + "type": "null" + } + ] + }, + "iconSmall": { + "anyOf": [ + { + "$ref": "#/definitions/AbsolutePathBuf" + }, + { + "type": "null" + } + ] + }, + "shortDescription": { + "type": [ + "string", + "null" + ] + } + } + }, + "SkillMetadata": { + "type": "object", + "required": [ + "description", + "enabled", + "name", + "path", + "scope" + ], + "properties": { + "dependencies": { + "anyOf": [ + { + "$ref": "#/definitions/SkillDependencies" + }, + { + "type": "null" + } + ] + }, + "description": { + "type": "string" + }, + "enabled": { + "type": "boolean" + }, + "interface": { + "anyOf": [ + { + "$ref": "#/definitions/SkillInterface" + }, + { + "type": "null" + } + ] + }, "name": { "type": "string" }, - "title": { + "path": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "scope": { + "$ref": "#/definitions/SkillScope" + }, + "shortDescription": { + "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.", + "type": [ + "string", + "null" + ] + } + } + }, + "SkillScope": { + "type": "string", + "enum": [ + "user", + "repo", + "system", + "admin" + ] + }, + "SkillToolDependency": { + "type": "object", + "required": [ + "type", + "value" + ], + "properties": { + "command": { "type": [ "string", "null" ] }, - "version": { + "description": { + "type": [ + "string", + "null" + ] + }, + "transport": { + "type": [ + "string", + "null" + ] + }, + "type": { + "type": "string" + }, + "url": { + "type": [ + "string", + "null" + ] + }, + "value": { "type": "string" } - }, + } + }, + "SkillsListEntry": { + "type": "object", "required": [ - "name", - "version" + "cwd", + "errors", + "skills" ], + "properties": { + "cwd": { + "type": "string" + }, + "errors": { + "type": "array", + "items": { + "$ref": "#/definitions/SkillErrorInfo" + } + }, + "skills": { + "type": "array", + "items": { + "$ref": "#/definitions/SkillMetadata" + } + } + } + }, + "SkillsListResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "SkillsListResponse", + "type": "object", + "required": [ + "data" + ], + "properties": { + "data": { + "type": "array", + "items": { + "$ref": "#/definitions/SkillsListEntry" + } + } + } + }, + "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": { + "$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" }, - "ClientRequest": { + "FsCreateDirectoryResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "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": [ - "skills/list" - ], - "title": "Skills/listRequestMethod", - "type": "string" - }, - "params": { - "$ref": "#/definitions/SkillsListParams" - } - }, - "required": [ - "id", - "method", - "params" - ], - "title": "Skills/listRequest", - "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": [ - "skills/config/write" - ], - "title": "Skills/config/writeRequestMethod", - "type": "string" - }, - "params": { - "$ref": "#/definitions/SkillsConfigWriteParams" - } - }, - "required": [ - "id", - "method", - "params" - ], - "title": "Skills/config/writeRequest", - "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" + "title": "FsCreateDirectoryResponse", + "description": "Successful response for `fs/createDirectory`.", + "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": [ - { - "enum": [ - "contextWindowExceeded", - "usageLimitExceeded", - "serverOverloaded", - "internalServerError", - "unauthorized", - "badRequest", - "threadRollbackFailed", - "sandboxError", - "other" - ], + "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" }, - { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" + "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" } - }, - "required": [ - "httpConnectionFailed" - ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" + ] + } + } + }, + "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.", + "oneOf": [ + { + "description": "Plain text turns and tool payloads.", + "type": "string", + "enum": [ + "text" + ] }, { - "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" + "description": "Image attachments included in user turns.", + "type": "string", + "enum": [ + "image" + ] } ] }, - "CollabAgentState": { + "Model": { + "type": "object", + "required": [ + "defaultReasoningEffort", + "description", + "displayName", + "hidden", + "id", + "isDefault", + "model", + "supportedReasoningEfforts" + ], "properties": { - "message": { + "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" ] }, - "status": { - "$ref": "#/definitions/CollabAgentStatus" + "upgradeInfo": { + "anyOf": [ + { + "$ref": "#/definitions/ModelUpgradeInfo" + }, + { + "type": "null" + } + ] } - }, + } + }, + "ModelAvailabilityNux": { + "type": "object", "required": [ - "status" + "message" ], - "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" + "message": { + "type": "string" } - }, + } + }, + "ModelUpgradeInfo": { + "type": "object", "required": [ - "mode", - "settings" + "model" ], - "type": "object" + "properties": { + "migrationMarkdown": { + "type": [ + "string", + "null" + ] + }, + "model": { + "type": "string" + }, + "modelLink": { + "type": [ + "string", + "null" + ] + }, + "upgradeCopy": { + "type": [ + "string", + "null" + ] + } + } + }, + "ReasoningEffortOption": { + "type": "object", + "required": [ + "description", + "reasoningEffort" + ], + "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" + } + } + } }, "CollaborationModeMask": { "description": "EXPERIMENTAL - collaboration mode preset metadata for clients.", + "type": "object", + "required": [ + "name" + ], "properties": { "mode": { "anyOf": [ @@ -2102,317 +12566,886 @@ } ] } - }, - "required": [ - "name" - ], - "type": "object" + } }, - "CommandAction": { + "GuardianApprovalReviewAction": { "oneOf": [ { + "type": "object", + "required": [ + "command", + "cwd", + "source", + "type" + ], "properties": { "command": { "type": "string" }, - "name": { - "type": "string" - }, - "path": { + "cwd": { "$ref": "#/definitions/AbsolutePathBuf" }, + "source": { + "$ref": "#/definitions/GuardianCommandSource" + }, "type": { + "type": "string", "enum": [ - "read" + "command" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "CommandGuardianApprovalReviewActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "CommandGuardianApprovalReviewAction" }, { + "type": "object", + "required": [ + "argv", + "cwd", + "program", + "source", + "type" + ], "properties": { - "command": { + "argv": { + "type": "array", + "items": { + "type": "string" + } + }, + "cwd": { + "$ref": "#/definitions/AbsolutePathBuf" + }, + "program": { "type": "string" }, - "path": { + "source": { + "$ref": "#/definitions/GuardianCommandSource" + }, + "type": { + "type": "string", + "enum": [ + "execve" + ], + "title": "ExecveGuardianApprovalReviewActionType" + } + }, + "title": "ExecveGuardianApprovalReviewAction" + }, + { + "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": { + "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": { "type": [ "string", "null" ] }, "type": { + "type": "string", "enum": [ - "listFiles" + "mcpToolCall" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "McpToolCallGuardianApprovalReviewActionType" } }, - "required": [ - "command", - "type" - ], - "title": "ListFilesCommandAction", - "type": "object" + "title": "McpToolCallGuardianApprovalReviewAction" }, { + "type": "object", + "required": [ + "permissions", + "type" + ], "properties": { - "command": { - "type": "string" + "permissions": { + "$ref": "#/definitions/RequestPermissionProfile" }, - "path": { - "type": [ - "string", - "null" - ] - }, - "query": { + "reason": { "type": [ "string", "null" ] }, "type": { + "type": "string", "enum": [ - "search" + "requestPermissions" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "RequestPermissionsGuardianApprovalReviewActionType" } }, - "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" + "title": "RequestPermissionsGuardianApprovalReviewAction" } ] }, - "CommandExecOutputDeltaNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "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": { - "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": { - "allOf": [ - { - "$ref": "#/definitions/CommandExecOutputStream" - } - ], - "description": "Output stream for this chunk." - } - }, + "GuardianApprovalReview": { + "description": "[UNSTABLE] Temporary approval auto-review payload used by `item/autoApprovalReview/*` notifications. This shape is expected to change soon.", + "type": "object", "required": [ - "capReached", - "deltaBase64", - "processId", - "stream" + "status" ], - "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.", + "rationale": { "type": [ "string", "null" ] }, - "disableOutputCap": { - "description": "Disable stdout/stderr capture truncation for this request.\n\nCannot be combined with `outputBytesCap`.", - "type": "boolean" + "riskLevel": { + "anyOf": [ + { + "$ref": "#/definitions/GuardianRiskLevel" + }, + { + "type": "null" + } + ] }, - "disableTimeout": { - "description": "Disable the timeout entirely for this request.\n\nCannot be combined with `timeoutMs`.", - "type": "boolean" + "status": { + "$ref": "#/definitions/GuardianApprovalReviewStatus" }, - "env": { + "userAuthorization": { + "anyOf": [ + { + "$ref": "#/definitions/GuardianUserAuthorization" + }, + { + "type": "null" + } + ] + } + } + }, + "McpServerOauthLoginResponse": { + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "McpServerOauthLoginResponse", + "type": "object", + "required": [ + "authorizationUrl" + ], + "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": { - "type": [ - "string", - "null" - ] + "$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" + } }, - "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.", + "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": { + "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" + } + ] + }, + "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" + } + ] + } + } + }, + "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.", + "allOf": [ + { + "$ref": "#/definitions/RateLimitSnapshot" + } + ] + }, + "rateLimitsByLimitId": { + "description": "Multi-bucket view keyed by metered `limit_id` (for example, `codex`).", "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" - } ], - "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" + "additionalProperties": { + "$ref": "#/definitions/RateLimitSnapshot" + } } - }, - "required": [ - "command" - ], - "title": "CommandExecParams", - "type": "object" + } }, - "CommandExecResizeParams": { + "AddCreditsNudgeEmailStatus": { + "type": "string", + "enum": [ + "sent", + "cooldown_active" + ] + }, + "SendAddCreditsNudgeEmailResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "description": "Resize a running PTY-backed `command/exec` session.", + "title": "SendAddCreditsNudgeEmailResponse", + "type": "object", + "required": [ + "status" + ], "properties": { - "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." + "status": { + "$ref": "#/definitions/AddCreditsNudgeEmailStatus" } - }, - "required": [ - "processId", - "size" - ], - "title": "CommandExecResizeParams", - "type": "object" + } }, - "CommandExecResizeResponse": { + "FeedbackUploadResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "description": "Empty success response for `command/exec/resize`.", - "title": "CommandExecResizeResponse", - "type": "object" + "title": "FeedbackUploadResponse", + "type": "object", + "required": [ + "threadId" + ], + "properties": { + "threadId": { + "type": "string" + } + } }, "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.", - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "stderr": { "description": "Buffered stderr capture.\n\nEmpty when stderr was streamed via `command/exec/outputDelta`.", @@ -2422,135 +13455,40 @@ "description": "Buffered stdout capture.\n\nEmpty when stdout was streamed via `command/exec/outputDelta`.", "type": "string" } - }, - "required": [ - "exitCode", - "stderr", - "stdout" - ], - "title": "CommandExecResponse", - "type": "object" + } }, - "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": { + "CommandExecWriteResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "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", + "title": "CommandExecWriteResponse", + "description": "Empty success response for `command/exec/write`.", "type": "object" }, "CommandExecTerminateResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "description": "Empty success response for `command/exec/terminate`.", "title": "CommandExecTerminateResponse", + "description": "Empty success response for `command/exec/terminate`.", "type": "object" }, - "CommandExecWriteParams": { + "CommandExecResizeResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "description": "Write stdin bytes to a running `command/exec` session, close stdin, or both.", + "title": "CommandExecResizeResponse", + "description": "Empty success response for `command/exec/resize`.", + "type": "object" + }, + "AnalyticsConfig": { + "type": "object", "properties": { - "closeStdin": { - "description": "Close stdin after writing `deltaBase64`, if present.", - "type": "boolean" - }, - "deltaBase64": { - "description": "Optional base64-encoded stdin bytes to write.", + "enabled": { "type": [ - "string", + "boolean", "null" ] - }, - "processId": { - "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.", - "type": "string" } }, - "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" + "additionalProperties": true }, "Config": { - "additionalProperties": true, + "type": "object", "properties": { "analytics": { "anyOf": [ @@ -2573,6 +13511,7 @@ ] }, "approvals_reviewer": { + "description": "[UNSTABLE] Optional default for where approval requests are routed for review.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -2580,8 +13519,7 @@ { "type": "null" } - ], - "description": "[UNSTABLE] Optional default for where approval requests are routed for review." + ] }, "compact_prompt": { "type": [ @@ -2624,18 +13562,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": [ @@ -2680,11 +13618,11 @@ ] }, "profiles": { + "default": {}, + "type": "object", "additionalProperties": { "$ref": "#/definitions/ProfileV2" - }, - "default": {}, - "type": "object" + } }, "review_model": { "type": [ @@ -2743,59 +13681,15 @@ ] } }, - "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" + "additionalProperties": true }, "ConfigLayer": { + "type": "object", + "required": [ + "config", + "name", + "version" + ], "properties": { "config": true, "disabledReason": { @@ -2810,15 +13704,14 @@ "version": { "type": "string" } - }, + } + }, + "ConfigLayerMetadata": { + "type": "object", "required": [ - "config", "name", "version" ], - "type": "object" - }, - "ConfigLayerMetadata": { "properties": { "name": { "$ref": "#/definitions/ConfigLayerSource" @@ -2826,17 +13719,18 @@ "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" @@ -2845,5547 +13739,153 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mdm" ], - "title": "MdmConfigLayerSourceType", - "type": "string" + "title": "MdmConfigLayerSourceType" } }, - "required": [ - "domain", - "key", - "type" - ], - "title": "MdmConfigLayerSource", - "type": "object" + "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" } - ], - "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", - "type": "string" + "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" ], - "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", - "type": "string" + "title": "UserConfigLayerSourceType" } }, - "required": [ - "file", - "type" - ], - "title": "UserConfigLayerSource", - "type": "object" + "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", - "type": "string" + "title": "ProjectConfigLayerSourceType" } }, - "required": [ - "dotCodexFolder", - "type" - ], - "title": "ProjectConfigLayerSource", - "type": "object" + "title": "ProjectConfigLayerSource" }, { "description": "Session-layer overrides supplied via `-c`/`--config`.", - "properties": { - "type": { - "enum": [ - "sessionFlags" - ], - "title": "SessionFlagsConfigLayerSourceType", - "type": "string" - } - }, + "type": "object", "required": [ "type" ], - "title": "SessionFlagsConfigLayerSource", - "type": "object" + "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", - "type": "string" + "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType" } }, - "required": [ - "file", - "type" - ], - "title": "LegacyManagedConfigTomlFromFileConfigLayerSource", - "type": "object" + "title": "LegacyManagedConfigTomlFromFileConfigLayerSource" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "legacyManagedConfigTomlFromMdm" ], - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType", - "type": "string" + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType" } }, - "required": [ - "type" - ], - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource", - "type": "object" + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource" } ] }, - "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": { - "additionalProperties": true, + "type": "object", "properties": { "approval_policy": { "anyOf": [ @@ -8398,6 +13898,7 @@ ] }, "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" @@ -8405,8 +13906,7 @@ { "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": [ @@ -8487,1487 +13987,10 @@ ] } }, - "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" - } - ] + "additionalProperties": true }, "SandboxWorkspaceWrite": { + "type": "object", "properties": { "exclude_slash_tmp": { "default": false, @@ -9983,7057 +14006,15 @@ }, "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": [ - "skills/changed" - ], - "title": "Skills/changedNotificationMethod", - "type": "string" - }, - "params": { - "$ref": "#/definitions/SkillsChangedNotification" - } - }, - "required": [ - "method", - "params" - ], - "title": "Skills/changedNotification", - "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" - }, - "SkillDependencies": { - "properties": { - "tools": { - "items": { - "$ref": "#/definitions/SkillToolDependency" - }, - "type": "array" - } - }, - "required": [ - "tools" - ], - "type": "object" - }, - "SkillErrorInfo": { - "properties": { - "message": { - "type": "string" - }, - "path": { - "type": "string" - } - }, - "required": [ - "message", - "path" - ], - "type": "object" - }, - "SkillInterface": { - "properties": { - "brandColor": { - "type": [ - "string", - "null" - ] - }, - "defaultPrompt": { - "type": [ - "string", - "null" - ] - }, - "displayName": { - "type": [ - "string", - "null" - ] - }, - "iconLarge": { - "anyOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - }, - { - "type": "null" - } - ] - }, - "iconSmall": { - "anyOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - }, - { - "type": "null" - } - ] - }, - "shortDescription": { - "type": [ - "string", - "null" - ] - } - }, - "type": "object" - }, - "SkillMetadata": { - "properties": { - "dependencies": { - "anyOf": [ - { - "$ref": "#/definitions/SkillDependencies" - }, - { - "type": "null" - } - ] - }, - "description": { - "type": "string" - }, - "enabled": { - "type": "boolean" - }, - "interface": { - "anyOf": [ - { - "$ref": "#/definitions/SkillInterface" - }, - { - "type": "null" - } - ] - }, - "name": { - "type": "string" - }, - "path": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "scope": { - "$ref": "#/definitions/SkillScope" - }, - "shortDescription": { - "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.", - "type": [ - "string", - "null" - ] - } - }, - "required": [ - "description", - "enabled", - "name", - "path", - "scope" - ], - "type": "object" - }, - "SkillScope": { - "enum": [ - "user", - "repo", - "system", - "admin" - ], - "type": "string" - }, - "SkillToolDependency": { - "properties": { - "command": { - "type": [ - "string", - "null" - ] - }, - "description": { - "type": [ - "string", - "null" - ] - }, - "transport": { - "type": [ - "string", - "null" - ] - }, - "type": { - "type": "string" - }, - "url": { - "type": [ - "string", - "null" - ] - }, - "value": { - "type": "string" - } - }, - "required": [ - "type", - "value" - ], - "type": "object" - }, - "SkillsChangedNotification": { - "$schema": "http://json-schema.org/draft-07/schema#", - "description": "Notification emitted when watched local skill files change.\n\nTreat this as an invalidation signal and re-run `skills/list` with the client's current parameters when refreshed skill metadata is needed.", - "title": "SkillsChangedNotification", - "type": "object" - }, - "SkillsConfigWriteParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "properties": { - "enabled": { - "type": "boolean" - }, - "name": { - "description": "Name-based selector.", - "type": [ - "string", - "null" - ] - }, - "path": { - "anyOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - }, - { - "type": "null" - } - ], - "description": "Path-based selector." - } - }, - "required": [ - "enabled" - ], - "title": "SkillsConfigWriteParams", - "type": "object" - }, - "SkillsConfigWriteResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "properties": { - "effectiveEnabled": { - "type": "boolean" - } - }, - "required": [ - "effectiveEnabled" - ], - "title": "SkillsConfigWriteResponse", - "type": "object" - }, - "SkillsListEntry": { - "properties": { - "cwd": { - "type": "string" - }, - "errors": { - "items": { - "$ref": "#/definitions/SkillErrorInfo" - }, - "type": "array" - }, - "skills": { - "items": { - "$ref": "#/definitions/SkillMetadata" - }, - "type": "array" - } - }, - "required": [ - "cwd", - "errors", - "skills" - ], - "type": "object" - }, - "SkillsListExtraRootsForCwd": { - "properties": { - "cwd": { - "type": "string" - }, - "extraUserRoots": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "cwd", - "extraUserRoots" - ], - "type": "object" - }, - "SkillsListParams": { - "$schema": "http://json-schema.org/draft-07/schema#", - "properties": { - "cwds": { - "description": "When empty, defaults to the current session working directory.", - "items": { - "type": "string" - }, - "type": "array" - }, - "forceReload": { - "description": "When true, bypass the skills cache and re-scan skills from disk.", - "type": "boolean" - }, - "perCwdExtraUserRoots": { - "default": null, - "description": "Optional per-cwd extra roots to scan as user-scoped skills.", - "items": { - "$ref": "#/definitions/SkillsListExtraRootsForCwd" - }, - "type": [ - "array", - "null" - ] - } - }, - "title": "SkillsListParams", - "type": "object" - }, - "SkillsListResponse": { - "$schema": "http://json-schema.org/draft-07/schema#", - "properties": { - "data": { - "items": { - "$ref": "#/definitions/SkillsListEntry" - }, - "type": "array" - } - }, - "required": [ - "data" - ], - "title": "SkillsListResponse", - "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", - "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" - }, - "shouldPrepareCompaction": { - "type": "boolean" - }, - "verificationResultStatus": { - "$ref": "#/definitions/ThreadEpiphanyRoleResultStatus" - } - }, - "required": [ - "crrcAction", - "modelingResultStatus", - "pressureLevel", - "reorientAction", - "reorientResultStatus", - "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" - }, - "ThreadEpiphanyRetrieveIndexSummary": { - "properties": { - "dirtyPaths": { - "items": { - "type": "string" - }, - "type": "array" - }, - "indexRevision": { - "type": [ - "string", - "null" - ] - }, - "indexedChunkCount": { - "format": "uint32", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - }, - "indexedFileCount": { - "format": "uint32", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - }, - "lastIndexedAtUnixSeconds": { - "format": "int64", - "type": [ - "integer", - "null" - ] - }, - "semanticAvailable": { - "type": "boolean" - }, - "shards": { - "items": { - "$ref": "#/definitions/ThreadEpiphanyRetrieveShardSummary" - }, - "type": "array" - }, - "status": { - "$ref": "#/definitions/EpiphanyRetrievalStatus" - }, - "workspaceRoot": { - "$ref": "#/definitions/AbsolutePathBuf" - } - }, - "required": [ - "dirtyPaths", - "semanticAvailable", - "shards", - "status", - "workspaceRoot" - ], - "type": "object" - }, - "ThreadEpiphanyRetrieveResult": { - "properties": { - "excerpt": { - "type": [ - "string", - "null" - ] - }, - "kind": { - "$ref": "#/definitions/ThreadEpiphanyRetrieveResultKind" - }, - "lineEnd": { - "format": "uint32", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - }, - "lineStart": { - "format": "uint32", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - }, - "path": { - "type": "string" - }, - "score": { - "format": "float", - "type": "number" - } - }, - "required": [ - "kind", - "path", - "score" - ], - "type": "object" - }, - "ThreadEpiphanyRetrieveResultKind": { - "enum": [ - "exactFile", - "exactDirectory", - "semanticChunk" - ], - "type": "string" - }, - "ThreadEpiphanyRetrieveShardSummary": { - "properties": { - "exactAvailable": { - "type": "boolean" - }, - "indexedChunkCount": { - "format": "uint32", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - }, - "indexedFileCount": { - "format": "uint32", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - }, - "pathPrefix": { - "type": "string" - }, - "semanticAvailable": { - "type": "boolean" - }, - "shardId": { - "type": "string" - }, - "status": { - "$ref": "#/definitions/EpiphanyRetrievalStatus" - } - }, - "required": [ - "exactAvailable", - "pathPrefix", - "semanticAvailable", - "shardId", - "status" - ], - "type": "object" - }, - "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", - "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" - }, - "ThreadEpiphanyWorkerLaunchDocument": { - "oneOf": [ - { - "properties": { - "activeGraphNodeIds": { - "items": { - "type": "string" - }, - "type": "array" - }, - "activeSubgoalId": { - "type": [ - "string", - "null" - ] - }, - "activeSubgoals": { - "items": { - "$ref": "#/definitions/EpiphanySubgoal" - }, - "type": "array" - }, - "churn": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyChurnState" - }, - { - "type": "null" - } - ] - }, - "documentKind": { - "enum": [ - "role" - ], - "type": "string" - }, - "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" - }, - "investigationCheckpoint": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyInvestigationCheckpoint" - }, - { - "type": "null" - } - ] - }, - "objective": { - "type": [ - "string", - "null" - ] - }, - "planning": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyPlanningState" - }, - { - "type": "null" - } - ] - }, - "recentEvidence": { - "items": { - "$ref": "#/definitions/EpiphanyEvidenceRecord" - }, - "type": "array" - }, - "recentObservations": { - "items": { - "$ref": "#/definitions/EpiphanyObservation" - }, - "type": "array" - }, - "roleId": { - "type": "string" - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "stateRevision": { - "format": "uint64", - "minimum": 0.0, - "type": "integer" - }, - "threadId": { - "type": "string" - } - }, - "required": [ - "documentKind", - "roleId", - "stateRevision", - "threadId" - ], - "type": "object" - }, - { - "properties": { - "activeFrontierNodeIds": { - "items": { - "type": "string" - }, - "type": "array" - }, - "checkpointChangedPaths": { - "items": { - "type": "string" - }, - "type": "array" - }, - "checkpointCodeRefs": { - "items": { - "$ref": "#/definitions/EpiphanyCodeRef" - }, - "type": "array" - }, - "checkpointDirtyPaths": { - "items": { - "type": "string" - }, - "type": "array" - }, - "checkpointDisposition": { - "type": "string" - }, - "checkpointEvidenceIds": { - "items": { - "type": "string" - }, - "type": "array" - }, - "checkpointFocus": { - "type": [ - "string", - "null" - ] - }, - "checkpointId": { - "type": "string" - }, - "checkpointKind": { - "type": "string" - }, - "checkpointNextAction": { - "type": "string" - }, - "checkpointOpenQuestions": { - "items": { - "type": "string" - }, - "type": "array" - }, - "checkpointSummary": { - "type": [ - "string", - "null" - ] - }, - "decisionNote": { - "type": "string" - }, - "decisionReasons": { - "items": { - "type": "string" - }, - "type": "array" - }, - "documentKind": { - "enum": [ - "reorient" - ], - "type": "string" - }, - "graphStatus": { - "type": "string" - }, - "graphs": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyGraphs" - }, - { - "type": "null" - } - ] - }, - "linkedGraphNodeIds": { - "items": { - "type": "string" - }, - "type": "array" - }, - "linkedSubgoalIds": { - "items": { - "type": "string" - }, - "type": "array" - }, - "mode": { - "type": "string" - }, - "pressureLevel": { - "type": "string" - }, - "recentEvidence": { - "items": { - "$ref": "#/definitions/EpiphanyEvidenceRecord" - }, - "type": "array" - }, - "recentObservations": { - "items": { - "$ref": "#/definitions/EpiphanyObservation" - }, - "type": "array" - }, - "retrievalStatus": { - "type": "string" - }, - "scratch": { - "anyOf": [ - { - "$ref": "#/definitions/EpiphanyScratchPad" - }, - { - "type": "null" - } - ] - }, - "threadId": { - "type": "string" - }, - "watcherStatus": { - "type": "string" - } - }, - "required": [ - "checkpointDisposition", - "checkpointId", - "checkpointKind", - "checkpointNextAction", - "decisionNote", - "documentKind", - "graphStatus", - "mode", - "pressureLevel", - "retrievalStatus", - "threadId", - "watcherStatus" - ], - "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": [ @@ -17051,694 +14032,27 @@ } ] } - }, - "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": [ - "skill" - ], - "title": "SkillUserInputType", - "type": "string" - } - }, - "required": [ - "name", - "path", - "type" - ], - "title": "SkillUserInput", - "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": { - "additionalProperties": false, + "type": "object", "properties": { "city": { "type": [ @@ -17765,27 +14079,27 @@ ] } }, - "type": "object" + "additionalProperties": false }, "WebSearchMode": { + "type": "string", "enum": [ "disabled", "cached", "live" - ], - "type": "string" + ] }, "WebSearchToolConfig": { - "additionalProperties": false, + "type": "object", "properties": { "allowed_domains": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "context_size": { "anyOf": [ @@ -17808,108 +14122,3700 @@ ] } }, - "type": "object" + "additionalProperties": false }, - "WindowsSandboxSetupCompletedNotification": { + "ConfigReadResponse": { "$schema": "http://json-schema.org/draft-07/schema#", - "properties": { - "error": { - "type": [ - "string", - "null" - ] - }, - "mode": { - "$ref": "#/definitions/WindowsSandboxSetupMode" - }, - "success": { - "type": "boolean" - } - }, + "title": "ConfigReadResponse", + "type": "object", "required": [ - "mode", - "success" + "config", + "origins" ], - "title": "WindowsSandboxSetupCompletedNotification", - "type": "object" - }, - "WindowsSandboxSetupMode": { - "enum": [ - "elevated", - "unelevated" - ], - "type": "string" - }, - "WindowsSandboxSetupStartParams": { - "$schema": "http://json-schema.org/draft-07/schema#", "properties": { - "cwd": { - "anyOf": [ + "config": { + "$ref": "#/definitions/Config" + }, + "layers": { + "type": [ + "array", + "null" + ], + "items": { + "$ref": "#/definitions/ConfigLayer" + } + }, + "origins": { + "type": "object", + "additionalProperties": { + "$ref": "#/definitions/ConfigLayerMetadata" + } + } + } + }, + "OverriddenMetadata": { + "type": "object", + "required": [ + "effectiveValue", + "message", + "overridingLayer" + ], + "properties": { + "effectiveValue": true, + "message": { + "type": "string" + }, + "overridingLayer": { + "$ref": "#/definitions/ConfigLayerMetadata" + } + } + }, + "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" } ] }, - "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" + "status": { + "$ref": "#/definitions/WriteStatus" }, - "failedScan": { - "type": "boolean" + "version": { + "type": "string" + } + } + }, + "ConfigRequirements": { + "type": "object", + "properties": { + "allowedApprovalPolicies": { + "type": [ + "array", + "null" + ], + "items": { + "$ref": "#/definitions/AskForApproval" + } }, - "samplePaths": { + "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" - }, - "type": "array" + } + }, + "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" + } } - }, - "required": [ - "extraCount", - "failedScan", - "samplePaths" - ], - "title": "WindowsWorldWritableWarningNotification", - "type": "object" + } }, - "WriteStatus": { + "NetworkUnixSocketPermission": { + "type": "string", "enum": [ - "ok", - "okOverridden" + "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" ], - "type": "string" + "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" + } + } + } + }, + "ClientInfo": { + "type": "object", + "required": [ + "name", + "version" + ], + "properties": { + "name": { + "type": "string" + }, + "title": { + "type": [ + "string", + "null" + ] + }, + "version": { + "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" + } + } + }, + "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" + ] + }, + "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" + } + } + }, + "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": [ + "skills/list" + ], + "title": "Skills/listRequestMethod" + }, + "params": { + "$ref": "#/definitions/SkillsListParams" + } + }, + "title": "Skills/listRequest" + }, + { + "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" + } + ] } - }, - "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 6048b822..908233a8 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,49 +1,10 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "title": "InitializeParams", + "type": "object", + "required": [ + "clientInfo" + ], "properties": { "capabilities": { "anyOf": [ @@ -59,9 +20,48 @@ "$ref": "#/definitions/ClientInfo" } }, - "required": [ - "clientInfo" - ], - "title": "InitializeParams", - "type": "object" + "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" + } + } + } + } + } } \ 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 1de65f82..462c8188 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,19 +1,21 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "title": "InitializeResponse", + "type": "object", + "required": [ + "codexHome", + "platformFamily", + "platformOs", + "userAgent" + ], "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\"`.", @@ -27,12 +29,10 @@ "type": "string" } }, - "required": [ - "codexHome", - "platformFamily", - "platformOs", - "userAgent" - ], - "title": "InitializeResponse", - "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" + } + } } \ 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 128cb643..56407343 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,5 +1,10 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "AccountLoginCompletedNotification", + "type": "object", + "required": [ + "success" + ], "properties": { "error": { "type": [ @@ -16,10 +21,5 @@ "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 96fefb22..14d086e5 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,7 +1,22 @@ { "$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": [ @@ -15,14 +30,10 @@ "unlimited": { "type": "boolean" } - }, - "required": [ - "hasCredits", - "unlimited" - ], - "type": "object" + } }, "PlanType": { + "type": "string", "enum": [ "free", "go", @@ -36,20 +47,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": [ @@ -113,44 +124,33 @@ } ] } - }, - "type": "object" + } }, "RateLimitWindow": { - "properties": { - "resetsAt": { - "format": "int64", - "type": [ - "integer", - "null" - ] - }, - "usedPercent": { - "format": "int32", - "type": "integer" - }, - "windowDurationMins": { - "format": "int64", - "type": [ - "integer", - "null" - ] - } - }, + "type": "object", "required": [ "usedPercent" ], - "type": "object" + "properties": { + "resetsAt": { + "type": [ + "integer", + "null" + ], + "format": "int64" + }, + "usedPercent": { + "type": "integer", + "format": "int32" + }, + "windowDurationMins": { + "type": [ + "integer", + "null" + ], + "format": "int64" + } + } } - }, - "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 e7546f55..b5e7ac71 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,57 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "title": "AccountUpdatedNotification", + "type": "object", "properties": { "authMode": { "anyOf": [ @@ -74,6 +24,56 @@ ] } }, - "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.", + "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" + ] + } + } } \ 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 09510d95..b2868771 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,5 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "AgentMessageDeltaNotification", + "type": "object", + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], "properties": { "delta": { "type": "string" @@ -13,13 +21,5 @@ "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 22c9a2ac..c7a5d107 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 23df186d..939ab6ef 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#", - "definitions": { - "CancelLoginAccountStatus": { - "enum": [ - "canceled", - "notFound" - ], - "type": "string" - } - }, + "title": "CancelLoginAccountResponse", + "type": "object", + "required": [ + "status" + ], "properties": { "status": { "$ref": "#/definitions/CancelLoginAccountStatus" } }, - "required": [ - "status" - ], - "title": "CancelLoginAccountResponse", - "type": "object" + "definitions": { + "CancelLoginAccountStatus": { + "type": "string", + "enum": [ + "canceled", + "notFound" + ] + } + } } \ 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 fff7e57d..a1a3876f 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,27 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - ] - } - }, + "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.", @@ -36,20 +23,33 @@ "type": "string" }, "stream": { + "description": "Output stream for this chunk.", "allOf": [ { "$ref": "#/definitions/CommandExecOutputStream" } - ], - "description": "Output stream for this chunk." + ] } }, - "required": [ - "capReached", - "deltaBase64", - "processId", - "stream" - ], - "title": "CommandExecOutputDeltaNotification", - "type": "object" + "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" + ] + } + ] + } + } } \ 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 986ec4cc..85b45f01 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,214 +1,18 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - ] - } - }, + "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" - }, - "type": "array" + } }, "cwd": { "description": "Optional working directory. Defaults to the server cwd.", @@ -226,26 +30,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.", @@ -255,6 +59,7 @@ ] }, "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" @@ -262,10 +67,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" @@ -273,8 +78,7 @@ { "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`.", @@ -286,20 +90,216 @@ }, "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" - ], - "title": "CommandExecParams", - "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" + }, + "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" + } + ] + } + } } \ 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 57d3b6a3..cd716a26 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#", - "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" - } - }, + "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" } - ], - "description": "New PTY size in character cells." + ] } }, - "required": [ - "processId", - "size" - ], - "title": "CommandExecResizeParams", - "type": "object" + "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 + } + } + } + } } \ 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 def86b66..ddabfa5b 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#", - "description": "Empty success response for `command/exec/resize`.", "title": "CommandExecResizeResponse", + "description": "Empty success response for `command/exec/resize`.", "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 1bbc5192..d10361a6 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,11 +1,18 @@ { "$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.", - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "stderr": { "description": "Buffered stderr capture.\n\nEmpty when stderr was streamed via `command/exec/outputDelta`.", @@ -15,12 +22,5 @@ "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 1f848770..77ddbe14 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 59bdb0cb..244df8a8 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#", - "description": "Empty success response for `command/exec/terminate`.", "title": "CommandExecTerminateResponse", + "description": "Empty success response for `command/exec/terminate`.", "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 440f2410..493b3f4a 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,6 +1,11 @@ { "$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.", @@ -17,10 +22,5 @@ "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 dff8301e..cd5fe632 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#", - "description": "Empty success response for `command/exec/write`.", "title": "CommandExecWriteResponse", + "description": "Empty success response for `command/exec/write`.", "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 e4cb64a9..5aa90958 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,5 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "CommandExecutionOutputDeltaNotification", + "type": "object", + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], "properties": { "delta": { "type": "string" @@ -13,13 +21,5 @@ "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 03cf2edb..c93499bb 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,37 +1,16 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "ConfigEdit": { - "properties": { - "keyPath": { - "type": "string" - }, - "mergeStrategy": { - "$ref": "#/definitions/MergeStrategy" - }, - "value": true - }, - "required": [ - "keyPath", - "mergeStrategy", - "value" - ], - "type": "object" - }, - "MergeStrategy": { - "enum": [ - "replace", - "upsert" - ], - "type": "string" - } - }, + "title": "ConfigBatchWriteParams", + "type": "object", + "required": [ + "edits" + ], "properties": { "edits": { + "type": "array", "items": { "$ref": "#/definitions/ConfigEdit" - }, - "type": "array" + } }, "expectedVersion": { "type": [ @@ -51,9 +30,30 @@ "type": "boolean" } }, - "required": [ - "edits" - ], - "title": "ConfigBatchWriteParams", - "type": "object" + "definitions": { + "ConfigEdit": { + "type": "object", + "required": [ + "keyPath", + "mergeStrategy", + "value" + ], + "properties": { + "keyPath": { + "type": "string" + }, + "mergeStrategy": { + "$ref": "#/definitions/MergeStrategy" + }, + "value": true + } + }, + "MergeStrategy": { + "type": "string", + "enum": [ + "replace", + "upsert" + ] + } + } } \ 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 b173d2ba..364cfd08 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,5 +1,7 @@ { "$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).", @@ -12,7 +14,5 @@ "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 c0409c47..7faf3114 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,12 +1,38 @@ { "$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": { - "additionalProperties": true, + "type": "object", "properties": { "enabled": { "type": [ @@ -15,32 +41,41 @@ ] } }, - "type": "object" + "additionalProperties": true }, "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" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "granular" + ], "properties": { "granular": { + "type": "object", + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -59,25 +94,16 @@ "default": false, "type": "boolean" } - }, - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "type": "object" + } } }, - "required": [ - "granular" - ], - "title": "GranularAskForApproval", - "type": "object" + "additionalProperties": false, + "title": "GranularAskForApproval" } ] }, "Config": { - "additionalProperties": true, + "type": "object", "properties": { "analytics": { "anyOf": [ @@ -100,6 +126,7 @@ ] }, "approvals_reviewer": { + "description": "[UNSTABLE] Optional default for where approval requests are routed for review.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -107,8 +134,7 @@ { "type": "null" } - ], - "description": "[UNSTABLE] Optional default for where approval requests are routed for review." + ] }, "compact_prompt": { "type": [ @@ -151,18 +177,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": [ @@ -207,11 +233,11 @@ ] }, "profiles": { + "default": {}, + "type": "object", "additionalProperties": { "$ref": "#/definitions/ProfileV2" - }, - "default": {}, - "type": "object" + } }, "review_model": { "type": [ @@ -270,9 +296,15 @@ ] } }, - "type": "object" + "additionalProperties": true }, "ConfigLayer": { + "type": "object", + "required": [ + "config", + "name", + "version" + ], "properties": { "config": true, "disabledReason": { @@ -287,15 +319,14 @@ "version": { "type": "string" } - }, + } + }, + "ConfigLayerMetadata": { + "type": "object", "required": [ - "config", "name", "version" ], - "type": "object" - }, - "ConfigLayerMetadata": { "properties": { "name": { "$ref": "#/definitions/ConfigLayerSource" @@ -303,17 +334,18 @@ "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" @@ -322,159 +354,153 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mdm" ], - "title": "MdmConfigLayerSourceType", - "type": "string" + "title": "MdmConfigLayerSourceType" } }, - "required": [ - "domain", - "key", - "type" - ], - "title": "MdmConfigLayerSource", - "type": "object" + "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" } - ], - "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", - "type": "string" + "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" ], - "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", - "type": "string" + "title": "UserConfigLayerSourceType" } }, - "required": [ - "file", - "type" - ], - "title": "UserConfigLayerSource", - "type": "object" + "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", - "type": "string" + "title": "ProjectConfigLayerSourceType" } }, - "required": [ - "dotCodexFolder", - "type" - ], - "title": "ProjectConfigLayerSource", - "type": "object" + "title": "ProjectConfigLayerSource" }, { "description": "Session-layer overrides supplied via `-c`/`--config`.", - "properties": { - "type": { - "enum": [ - "sessionFlags" - ], - "title": "SessionFlagsConfigLayerSourceType", - "type": "string" - } - }, + "type": "object", "required": [ "type" ], - "title": "SessionFlagsConfigLayerSource", - "type": "object" + "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", - "type": "string" + "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType" } }, - "required": [ - "file", - "type" - ], - "title": "LegacyManagedConfigTomlFromFileConfigLayerSource", - "type": "object" + "title": "LegacyManagedConfigTomlFromFileConfigLayerSource" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "legacyManagedConfigTomlFromMdm" ], - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType", - "type": "string" + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType" } }, - "required": [ - "type" - ], - "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource", - "type": "object" + "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource" } ] }, "ForcedLoginMethod": { + "type": "string", "enum": [ "chatgpt", "api" - ], - "type": "string" + ] }, "ProfileV2": { - "additionalProperties": true, + "type": "object", "properties": { "approval_policy": { "anyOf": [ @@ -487,6 +513,7 @@ ] }, "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" @@ -494,8 +521,7 @@ { "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": [ @@ -576,10 +602,11 @@ ] } }, - "type": "object" + "additionalProperties": true }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -587,38 +614,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, @@ -634,22 +661,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": [ @@ -667,28 +694,27 @@ } ] } - }, - "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": { - "additionalProperties": false, + "type": "object", "properties": { "city": { "type": [ @@ -715,27 +741,27 @@ ] } }, - "type": "object" + "additionalProperties": false }, "WebSearchMode": { + "type": "string", "enum": [ "disabled", "cached", "live" - ], - "type": "string" + ] }, "WebSearchToolConfig": { - "additionalProperties": false, + "type": "object", "properties": { "allowed_domains": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "context_size": { "anyOf": [ @@ -758,33 +784,7 @@ ] } }, - "type": "object" + "additionalProperties": false } - }, - "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 f75833af..0831db14 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,30 +1,54 @@ { "$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" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "granular" + ], "properties": { "granular": { + "type": "object", + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -43,51 +67,52 @@ "default": false, "type": "boolean" } - }, - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "type": "object" + } } }, - "required": [ - "granular" - ], - "title": "GranularAskForApproval", - "type": "object" + "additionalProperties": false, + "title": "GranularAskForApproval" } ] }, "ConfigRequirements": { + "type": "object", "properties": { "allowedApprovalPolicies": { + "type": [ + "array", + "null" + ], "items": { "$ref": "#/definitions/AskForApproval" - }, + } + }, + "featureRequirements": { "type": [ - "array", + "object", "null" - ] + ], + "additionalProperties": { + "type": "boolean" + } }, "allowedSandboxModes": { + "type": [ + "array", + "null" + ], "items": { "$ref": "#/definitions/SandboxMode" - }, - "type": [ - "array", - "null" - ] + } }, "allowedWebSearchModes": { - "items": { - "$ref": "#/definitions/WebSearchMode" - }, "type": [ "array", "null" - ] + ], + "items": { + "$ref": "#/definitions/WebSearchMode" + } }, "enforceResidency": { "anyOf": [ @@ -98,27 +123,18 @@ "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": [ @@ -128,13 +144,13 @@ }, "allowUnixSockets": { "description": "Legacy compatibility view derived from `unix_sockets`.", - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "allowUpstreamProxy": { "type": [ @@ -144,13 +160,13 @@ }, "allowedDomains": { "description": "Legacy compatibility view derived from `domains`.", - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "dangerouslyAllowAllUnixSockets": { "type": [ @@ -166,23 +182,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": [ @@ -191,12 +207,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.", @@ -206,69 +222,53 @@ ] }, "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 000c55a8..46d6625f 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,14 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "MergeStrategy": { - "enum": [ - "replace", - "upsert" - ], - "type": "string" - } - }, + "title": "ConfigValueWriteParams", + "type": "object", + "required": [ + "keyPath", + "mergeStrategy", + "value" + ], "properties": { "expectedVersion": { "type": [ @@ -31,11 +29,13 @@ }, "value": true }, - "required": [ - "keyPath", - "mergeStrategy", - "value" - ], - "title": "ConfigValueWriteParams", - "type": "object" + "definitions": { + "MergeStrategy": { + "type": "string", + "enum": [ + "replace", + "upsert" + ] + } + } } \ 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 c89e42a2..131d55ee 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,43 +1,10 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "title": "ConfigWarningNotification", + "type": "object", + "required": [ + "summary" + ], "properties": { "details": { "description": "Optional extra guidance or error details.", @@ -54,6 +21,7 @@ ] }, "range": { + "description": "Optional range for the error location inside the config file.", "anyOf": [ { "$ref": "#/definitions/TextRange" @@ -61,17 +29,49 @@ { "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" + "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" + } + } + } + } } \ 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 631318a8..50c35a2f 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,214 +1,20 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "title": "ConfigWriteResponse", + "type": "object", + "required": [ + "filePath", + "status", + "version" + ], "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": [ @@ -227,11 +33,205 @@ "type": "string" } }, - "required": [ - "filePath", - "status", - "version" - ], - "title": "ConfigWriteResponse", - "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" + }, + "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" + ] + } + } } \ 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 8d2d4b12..4ca69d25 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,6 +1,12 @@ { "$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" @@ -8,11 +14,5 @@ "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 7e6c73b9..6781b4e7 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,5 +1,10 @@ { "$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.", @@ -12,10 +17,5 @@ "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 fe2c0f08..ca422f8c 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,16 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "DeviceKeyProtectionPolicy": { - "description": "Protection policy for creating or loading a controller-local device key.", - "enum": [ - "hardware_only", - "allow_os_protected_nonextractable" - ], - "type": "string" - } - }, + "title": "DeviceKeyCreateParams", "description": "Create a controller-local device key with a random key id.", + "type": "object", + "required": [ + "accountUserId", + "clientId" + ], "properties": { "accountUserId": { "type": "string" @@ -19,6 +15,7 @@ "type": "string" }, "protectionPolicy": { + "description": "Defaults to `hardware_only` when omitted.", "anyOf": [ { "$ref": "#/definitions/DeviceKeyProtectionPolicy" @@ -26,14 +23,17 @@ { "type": "null" } - ], - "description": "Defaults to `hardware_only` when omitted." + ] } }, - "required": [ - "accountUserId", - "clientId" - ], - "title": "DeviceKeyCreateParams", - "type": "object" + "definitions": { + "DeviceKeyProtectionPolicy": { + "description": "Protection policy for creating or loading a controller-local device key.", + "type": "string", + "enum": [ + "hardware_only", + "allow_os_protected_nonextractable" + ] + } + } } \ 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 12072588..62b6498e 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,24 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "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" @@ -34,12 +24,22 @@ "type": "string" } }, - "required": [ - "algorithm", - "keyId", - "protectionClass", - "publicKeySpkiDerBase64" - ], - "title": "DeviceKeyCreateResponse", - "type": "object" + "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" + ] + } + } } \ 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 37cc5fbe..ea0d4a6f 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 39f98b76..bdbe4622 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,24 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "title": "DeviceKeyPublicResponse", "description": "Device-key public metadata returned by `device/key/public`.", + "type": "object", + "required": [ + "algorithm", + "keyId", + "protectionClass", + "publicKeySpkiDerBase64" + ], "properties": { "algorithm": { "$ref": "#/definitions/DeviceKeyAlgorithm" @@ -34,12 +24,22 @@ "type": "string" } }, - "required": [ - "algorithm", - "keyId", - "protectionClass", - "publicKeySpkiDerBase64" - ], - "title": "DeviceKeyPublicResponse", - "type": "object" + "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" + ] + } + } } \ 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 054765b2..6234fcc4 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,11 +1,40 @@ { "$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" @@ -21,10 +50,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.", @@ -40,39 +69,38 @@ }, "tokenExpiresAt": { "description": "Remote-control token expiration as Unix seconds.", - "format": "int64", - "type": "integer" + "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", - "type": "string" + "title": "RemoteControlClientConnectionDeviceKeySignPayloadType" } }, - "required": [ - "accountUserId", - "audience", - "clientId", - "nonce", - "scopes", - "sessionId", - "targetOrigin", - "targetPath", - "tokenExpiresAt", - "tokenSha256Base64url", - "type" - ], - "title": "RemoteControlClientConnectionDeviceKeySignPayload", - "type": "object" + "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" @@ -82,8 +110,8 @@ }, "challengeExpiresAt": { "description": "Enrollment challenge expiration as Unix seconds.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "challengeId": { "description": "Backend-issued enrollment challenge id that this proof authorizes.", @@ -108,58 +136,30 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "remoteControlClientEnrollment" ], - "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType", - "type": "string" + "title": "RemoteControlClientEnrollmentDeviceKeySignPayloadType" } }, - "required": [ - "accountUserId", - "audience", - "challengeExpiresAt", - "challengeId", - "clientId", - "deviceIdentitySha256Base64url", - "nonce", - "targetOrigin", - "targetPath", - "type" - ], - "title": "RemoteControlClientEnrollmentDeviceKeySignPayload", - "type": "object" + "title": "RemoteControlClientEnrollmentDeviceKeySignPayload" } ] }, "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 83fec903..777c90a3 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,15 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "DeviceKeyAlgorithm": { - "description": "Device-key algorithm reported at enrollment and signing boundaries.", - "enum": [ - "ecdsa_p256_sha256" - ], - "type": "string" - } - }, + "title": "DeviceKeySignResponse", "description": "ASN.1 DER signature returned by `device/key/sign`.", + "type": "object", + "required": [ + "algorithm", + "signatureDerBase64", + "signedPayloadBase64" + ], "properties": { "algorithm": { "$ref": "#/definitions/DeviceKeyAlgorithm" @@ -23,11 +21,13 @@ "type": "string" } }, - "required": [ - "algorithm", - "signatureDerBase64", - "signedPayloadBase64" - ], - "title": "DeviceKeySignResponse", - "type": "object" + "definitions": { + "DeviceKeyAlgorithm": { + "description": "Device-key algorithm reported at enrollment and signing boundaries.", + "type": "string", + "enum": [ + "ecdsa_p256_sha256" + ] + } + } } \ 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 032743d5..244f4d54 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,10 +1,33 @@ { "$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", @@ -15,136 +38,139 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "NonSteerableTurnKind": { + "type": "string", "enum": [ "review", "compact" - ], - "type": "string" + ] }, "TurnError": { + "type": "object", + "required": [ + "message" + ], "properties": { "additionalDetails": { "default": null, @@ -166,33 +192,7 @@ "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 9d6bcec9..c21ae87a 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#", - "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" - } - }, + "title": "ExperimentalFeatureEnablementSetParams", + "type": "object", "required": [ "enablement" ], - "title": "ExperimentalFeatureEnablementSetParams", - "type": "object" + "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" + } + } + } } \ 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 9cdbf069..d53de60c 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#", - "properties": { - "enablement": { - "additionalProperties": { - "type": "boolean" - }, - "description": "Feature enablement entries updated by this request.", - "type": "object" - } - }, + "title": "ExperimentalFeatureEnablementSetResponse", + "type": "object", "required": [ "enablement" ], - "title": "ExperimentalFeatureEnablementSetResponse", - "type": "object" + "properties": { + "enablement": { + "description": "Feature enablement entries updated by this request.", + "type": "object", + "additionalProperties": { + "type": "boolean" + } + } + } } \ 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 ab562edb..69d935bb 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,5 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ExperimentalFeatureListParams", + "type": "object", "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -10,14 +12,12 @@ }, "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 25398fc0..f9d5efa8 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,7 +1,34 @@ { "$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.", @@ -37,80 +64,53 @@ "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 07c20986..3bb6ddb4 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,17 +1,23 @@ { "$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" @@ -23,13 +29,13 @@ ] }, "tags": { - "additionalProperties": { - "type": "string" - }, "type": [ "object", "null" - ] + ], + "additionalProperties": { + "type": "string" + } }, "threadId": { "type": [ @@ -37,11 +43,5 @@ "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 647b613f..73bde860 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 2b3abd67..989f4458 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,5 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "FileChangeOutputDeltaNotification", + "type": "object", + "required": [ + "delta", + "itemId", + "threadId", + "turnId" + ], "properties": { "delta": { "type": "string" @@ -13,13 +21,5 @@ "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 0ae44aa9..b1699f04 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,90 +1,19 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - ] - } - }, + "title": "FileChangePatchUpdatedNotification", + "type": "object", + "required": [ + "changes", + "itemId", + "threadId", + "turnId" + ], "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "itemId": { "type": "string" @@ -96,12 +25,83 @@ "type": "string" } }, - "required": [ - "changes", - "itemId", - "threadId", - "turnId" - ], - "title": "FileChangePatchUpdatedNotification", - "type": "object" + "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" + } + ] + } + } } \ 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 cfb9f4e5..508b911f 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#", - "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" - } - }, + "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" - }, - "type": "array" + } }, "watchId": { "description": "Watch identifier previously provided to `fs/watch`.", "type": "string" } }, - "required": [ - "changedPaths", - "watchId" - ], - "title": "FsChangedNotification", - "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" + } + } } \ 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 2994fcac..a6cd7066 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#", - "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" - } - }, + "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" } - ], - "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" - ], - "title": "FsCopyParams", - "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" + } + } } \ 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 b1088b3a..f36e78ab 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#", - "description": "Successful response for `fs/copy`.", "title": "FsCopyResponse", + "description": "Successful response for `fs/copy`.", "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 a1ac4a8d..9d3afb52 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,20 +1,19 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "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" } - ], - "description": "Absolute directory path to create." + ] }, "recursive": { "description": "Whether parent directories should also be created. Defaults to `true`.", @@ -24,9 +23,10 @@ ] } }, - "required": [ - "path" - ], - "title": "FsCreateDirectoryParams", - "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" + } + } } \ 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 d07e1189..b822f1a3 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#", - "description": "Successful response for `fs/createDirectory`.", "title": "FsCreateDirectoryResponse", + "description": "Successful response for `fs/createDirectory`.", "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 c7028749..f8c8ce0b 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 82481f57..386d248c 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,11 +1,20 @@ { "$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`.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "isDirectory": { "description": "Whether the path resolves to a directory.", @@ -21,17 +30,8 @@ }, "modifiedAtMs": { "description": "File modification time in Unix milliseconds when available, otherwise `0`.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } - }, - "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 e531fe9f..e454f26a 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 61f7a3e6..9e98fbee 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,8 +1,29 @@ { "$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.", @@ -16,28 +37,7 @@ "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 e1df6018..64074e28 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 c746cf93..1e7a6a33 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 d6289d46..bc407263 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,12 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "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`.", @@ -16,12 +15,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`.", @@ -31,9 +30,10 @@ ] } }, - "required": [ - "path" - ], - "title": "FsRemoveParams", - "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" + } + } } \ 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 d1ec5d11..b52829fb 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#", - "description": "Successful response for `fs/remove`.", "title": "FsRemoveResponse", + "description": "Successful response for `fs/remove`.", "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 f46800e9..137d86da 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 daa80ad6..1cf264c3 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#", - "description": "Successful response for `fs/unwatch`.", "title": "FsUnwatchResponse", + "description": "Successful response for `fs/unwatch`.", "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 29a1ceea..4ee07ba1 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#", - "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" - } - }, + "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" } - ], - "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" + "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" + } + } } \ 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 abc7d466..b3cce432 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 e1b5eabd..774c190b 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#", - "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" - } - }, + "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" } - ], - "description": "Absolute path to write." + ] } }, - "required": [ - "dataBase64", - "path" - ], - "title": "FsWriteFileParams", - "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" + } + } } \ 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 07ba35cd..ba9a84fe 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#", - "description": "Successful response for `fs/writeFile`.", "title": "FsWriteFileResponse", + "description": "Successful response for `fs/writeFile`.", "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 ca18a451..f5ea18de 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": { - "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`.", + "default": false, "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 8f7db24e..0f0a327f 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,7 +1,37 @@ { "$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": [ @@ -15,14 +45,10 @@ "unlimited": { "type": "boolean" } - }, - "required": [ - "hasCredits", - "unlimited" - ], - "type": "object" + } }, "PlanType": { + "type": "string", "enum": [ "free", "go", @@ -36,20 +62,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": [ @@ -113,59 +139,33 @@ } ] } - }, - "type": "object" + } }, "RateLimitWindow": { - "properties": { - "resetsAt": { - "format": "int64", - "type": [ - "integer", - "null" - ] - }, - "usedPercent": { - "format": "int32", - "type": "integer" - }, - "windowDurationMins": { - "format": "int64", - "type": [ - "integer", - "null" - ] - } - }, + "type": "object", "required": [ "usedPercent" ], - "type": "object" - } - }, - "properties": { - "rateLimits": { - "allOf": [ - { - "$ref": "#/definitions/RateLimitSnapshot" + "properties": { + "resetsAt": { + "type": [ + "integer", + "null" + ], + "format": "int64" + }, + "usedPercent": { + "type": "integer", + "format": "int32" + }, + "windowDurationMins": { + "type": [ + "integer", + "null" + ], + "format": "int64" } - ], - "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 85349271..6b4ed1da 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,68 +1,10 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "title": "GetAccountResponse", + "type": "object", + "required": [ + "requiresOpenaiAuth" + ], "properties": { "account": { "anyOf": [ @@ -78,9 +20,67 @@ "type": "boolean" } }, - "required": [ - "requiresOpenaiAuth" - ], - "title": "GetAccountResponse", - "type": "object" + "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" + ] + } + } } \ 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 5a4ef82f..14608eb6 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,5 +1,11 @@ { "$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.", @@ -9,11 +15,5 @@ "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 a4d37864..3233134d 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,11 +1,32 @@ { "$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", @@ -13,25 +34,29 @@ "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" @@ -39,58 +64,66 @@ "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": { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "durationMs": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "entries": { + "type": "array", "items": { "$ref": "#/definitions/HookOutputEntry" - }, - "type": "array" + } }, "eventName": { "$ref": "#/definitions/HookEventName" @@ -108,19 +141,19 @@ "$ref": "#/definitions/HookScope" }, "source": { + "default": "unknown", "allOf": [ { "$ref": "#/definitions/HookSource" } - ], - "default": "unknown" + ] }, "sourcePath": { "$ref": "#/definitions/AbsolutePathBuf" }, "startedAt": { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "status": { "$ref": "#/definitions/HookRunStatus" @@ -131,29 +164,17 @@ "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", @@ -163,28 +184,7 @@ "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 ac77d616..12e7cc9e 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,11 +1,32 @@ { "$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", @@ -13,25 +34,29 @@ "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" @@ -39,58 +64,66 @@ "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": { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "durationMs": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "entries": { + "type": "array", "items": { "$ref": "#/definitions/HookOutputEntry" - }, - "type": "array" + } }, "eventName": { "$ref": "#/definitions/HookEventName" @@ -108,19 +141,19 @@ "$ref": "#/definitions/HookScope" }, "source": { + "default": "unknown", "allOf": [ { "$ref": "#/definitions/HookSource" } - ], - "default": "unknown" + ] }, "sourcePath": { "$ref": "#/definitions/AbsolutePathBuf" }, "startedAt": { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "status": { "$ref": "#/definitions/HookRunStatus" @@ -131,29 +164,17 @@ "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", @@ -163,28 +184,7 @@ "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 0831483a..f979879f 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,30 +1,52 @@ { "$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": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -35,13 +57,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -50,30 +69,36 @@ "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" @@ -85,23 +110,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -113,21 +136,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -145,113 +168,114 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "DynamicToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -262,15 +286,14 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -278,78 +301,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -357,78 +382,75 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -437,23 +459,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -461,18 +480,21 @@ "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.", @@ -481,74 +503,77 @@ "null" ] } - }, - "required": [ - "byteRange" - ], - "type": "object" + } }, "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -556,10 +581,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -567,30 +592,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -599,56 +623,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -663,34 +690,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" @@ -703,42 +730,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -747,32 +772,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -813,43 +840,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -873,31 +899,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -918,6 +946,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -925,57 +954,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -994,22 +1018,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -1018,22 +1042,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -1061,23 +1086,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -1086,22 +1110,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -1110,114 +1134,114 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "UserInput": { "oneOf": [ { + "type": "object", + "required": [ + "text", + "type" + ], "properties": { "text": { "type": "string" }, "text_elements": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1226,22 +1250,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1250,35 +1274,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -1287,27 +1309,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -1316,13 +1338,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -1331,11 +1353,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -1344,47 +1366,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 27716e59..90eafb6a 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,51 +1,91 @@ { "$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": [ @@ -53,89 +93,93 @@ "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", - "type": "string" + "title": "PathFileSystemPathType" } }, - "required": [ - "path", - "type" - ], - "title": "PathFileSystemPath", - "type": "object" + "title": "PathFileSystemPath" }, { + "type": "object", + "required": [ + "pattern", + "type" + ], "properties": { "pattern": { "type": "string" }, "type": { + "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType", - "type": "string" + "title": "GlobPatternFileSystemPathType" } }, - "required": [ - "pattern", - "type" - ], - "title": "GlobPatternFileSystemPath", - "type": "object" + "title": "GlobPatternFileSystemPath" }, { + "type": "object", + "required": [ + "type", + "value" + ], "properties": { "type": { + "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType", - "type": "string" + "title": "SpecialFileSystemPathType" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "required": [ - "type", - "value" - ], - "title": "SpecialFileSystemPath", - "type": "object" + "title": "SpecialFileSystemPath" } ] }, "FileSystemSandboxEntry": { + "type": "object", + "required": [ + "access", + "path" + ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -143,67 +187,66 @@ "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": [ @@ -212,49 +255,50 @@ ] } }, + "title": "KindFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "KindFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "tmpdir" - ], - "type": "string" + ] } }, + "title": "TmpdirFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "TmpdirFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "slash_tmp" - ], - "type": "string" + ] } }, - "required": [ - "kind" - ], - "title": "SlashTmpFileSystemSpecialPath", - "type": "object" + "title": "SlashTmpFileSystemSpecialPath" }, { + "type": "object", + "required": [ + "kind", + "path" + ], "properties": { "kind": { + "type": "string", "enum": [ "unknown" - ], - "type": "string" + ] }, "path": { "type": "string" @@ -265,17 +309,16 @@ "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": [ @@ -306,15 +349,18 @@ } ] } - }, - "required": [ - "status" - ], - "type": "object" + } }, "GuardianApprovalReviewAction": { "oneOf": [ { + "type": "object", + "required": [ + "command", + "cwd", + "source", + "type" + ], "properties": { "command": { "type": "string" @@ -326,29 +372,30 @@ "$ref": "#/definitions/GuardianCommandSource" }, "type": { + "type": "string", "enum": [ "command" ], - "title": "CommandGuardianApprovalReviewActionType", - "type": "string" + "title": "CommandGuardianApprovalReviewActionType" } }, + "title": "CommandGuardianApprovalReviewAction" + }, + { + "type": "object", "required": [ - "command", + "argv", "cwd", + "program", "source", "type" ], - "title": "CommandGuardianApprovalReviewAction", - "type": "object" - }, - { "properties": { "argv": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "cwd": { "$ref": "#/definitions/AbsolutePathBuf" @@ -360,59 +407,59 @@ "$ref": "#/definitions/GuardianCommandSource" }, "type": { + "type": "string", "enum": [ "execve" ], - "title": "ExecveGuardianApprovalReviewActionType", - "type": "string" + "title": "ExecveGuardianApprovalReviewActionType" } }, - "required": [ - "argv", - "cwd", - "program", - "source", - "type" - ], - "title": "ExecveGuardianApprovalReviewAction", - "type": "object" + "title": "ExecveGuardianApprovalReviewAction" }, { - "properties": { - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "files": { - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" - }, - "type": { - "enum": [ - "applyPatch" - ], - "title": "ApplyPatchGuardianApprovalReviewActionType", - "type": "string" - } - }, + "type": "object", "required": [ "cwd", "files", "type" ], - "title": "ApplyPatchGuardianApprovalReviewAction", - "type": "object" + "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": { "type": "string" }, "port": { + "type": "integer", "format": "uint16", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "protocol": { "$ref": "#/definitions/NetworkApprovalProtocol" @@ -421,24 +468,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "networkAccess" ], - "title": "NetworkAccessGuardianApprovalReviewActionType", - "type": "string" + "title": "NetworkAccessGuardianApprovalReviewActionType" } }, - "required": [ - "host", - "port", - "protocol", - "target", - "type" - ], - "title": "NetworkAccessGuardianApprovalReviewAction", - "type": "object" + "title": "NetworkAccessGuardianApprovalReviewAction" }, { + "type": "object", + "required": [ + "server", + "toolName", + "type" + ], "properties": { "connectorId": { "type": [ @@ -465,22 +510,21 @@ ] }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallGuardianApprovalReviewActionType", - "type": "string" + "title": "McpToolCallGuardianApprovalReviewActionType" } }, - "required": [ - "server", - "toolName", - "type" - ], - "title": "McpToolCallGuardianApprovalReviewAction", - "type": "object" + "title": "McpToolCallGuardianApprovalReviewAction" }, { + "type": "object", + "required": [ + "permissions", + "type" + ], "properties": { "permissions": { "$ref": "#/definitions/RequestPermissionProfile" @@ -492,71 +536,66 @@ ] }, "type": { + "type": "string", "enum": [ "requestPermissions" ], - "title": "RequestPermissionsGuardianApprovalReviewActionType", - "type": "string" + "title": "RequestPermissionsGuardianApprovalReviewActionType" } }, - "required": [ - "permissions", - "type" - ], - "title": "RequestPermissionsGuardianApprovalReviewAction", - "type": "object" + "title": "RequestPermissionsGuardianApprovalReviewAction" } ] }, "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": { - "additionalProperties": false, + "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -579,46 +618,7 @@ ] } }, - "type": "object" + "additionalProperties": false } - }, - "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 c039f219..216afce5 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,51 +1,87 @@ { "$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": [ @@ -53,82 +89,86 @@ "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", - "type": "string" + "title": "PathFileSystemPathType" } }, - "required": [ - "path", - "type" - ], - "title": "PathFileSystemPath", - "type": "object" + "title": "PathFileSystemPath" }, { + "type": "object", + "required": [ + "pattern", + "type" + ], "properties": { "pattern": { "type": "string" }, "type": { + "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType", - "type": "string" + "title": "GlobPatternFileSystemPathType" } }, - "required": [ - "pattern", - "type" - ], - "title": "GlobPatternFileSystemPath", - "type": "object" + "title": "GlobPatternFileSystemPath" }, { + "type": "object", + "required": [ + "type", + "value" + ], "properties": { "type": { + "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType", - "type": "string" + "title": "SpecialFileSystemPathType" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "required": [ - "type", - "value" - ], - "title": "SpecialFileSystemPath", - "type": "object" + "title": "SpecialFileSystemPath" } ] }, "FileSystemSandboxEntry": { + "type": "object", + "required": [ + "access", + "path" + ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -136,67 +176,66 @@ "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": [ @@ -205,49 +244,50 @@ ] } }, + "title": "KindFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "KindFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "tmpdir" - ], - "type": "string" + ] } }, + "title": "TmpdirFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "TmpdirFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "slash_tmp" - ], - "type": "string" + ] } }, - "required": [ - "kind" - ], - "title": "SlashTmpFileSystemSpecialPath", - "type": "object" + "title": "SlashTmpFileSystemSpecialPath" }, { + "type": "object", + "required": [ + "kind", + "path" + ], "properties": { "kind": { + "type": "string", "enum": [ "unknown" - ], - "type": "string" + ] }, "path": { "type": "string" @@ -258,17 +298,16 @@ "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": [ @@ -299,15 +338,18 @@ } ] } - }, - "required": [ - "status" - ], - "type": "object" + } }, "GuardianApprovalReviewAction": { "oneOf": [ { + "type": "object", + "required": [ + "command", + "cwd", + "source", + "type" + ], "properties": { "command": { "type": "string" @@ -319,29 +361,30 @@ "$ref": "#/definitions/GuardianCommandSource" }, "type": { + "type": "string", "enum": [ "command" ], - "title": "CommandGuardianApprovalReviewActionType", - "type": "string" + "title": "CommandGuardianApprovalReviewActionType" } }, + "title": "CommandGuardianApprovalReviewAction" + }, + { + "type": "object", "required": [ - "command", + "argv", "cwd", + "program", "source", "type" ], - "title": "CommandGuardianApprovalReviewAction", - "type": "object" - }, - { "properties": { "argv": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "cwd": { "$ref": "#/definitions/AbsolutePathBuf" @@ -353,59 +396,59 @@ "$ref": "#/definitions/GuardianCommandSource" }, "type": { + "type": "string", "enum": [ "execve" ], - "title": "ExecveGuardianApprovalReviewActionType", - "type": "string" + "title": "ExecveGuardianApprovalReviewActionType" } }, - "required": [ - "argv", - "cwd", - "program", - "source", - "type" - ], - "title": "ExecveGuardianApprovalReviewAction", - "type": "object" + "title": "ExecveGuardianApprovalReviewAction" }, { - "properties": { - "cwd": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "files": { - "items": { - "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" - }, - "type": { - "enum": [ - "applyPatch" - ], - "title": "ApplyPatchGuardianApprovalReviewActionType", - "type": "string" - } - }, + "type": "object", "required": [ "cwd", "files", "type" ], - "title": "ApplyPatchGuardianApprovalReviewAction", - "type": "object" + "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": { "type": "string" }, "port": { + "type": "integer", "format": "uint16", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "protocol": { "$ref": "#/definitions/NetworkApprovalProtocol" @@ -414,24 +457,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "networkAccess" ], - "title": "NetworkAccessGuardianApprovalReviewActionType", - "type": "string" + "title": "NetworkAccessGuardianApprovalReviewActionType" } }, - "required": [ - "host", - "port", - "protocol", - "target", - "type" - ], - "title": "NetworkAccessGuardianApprovalReviewAction", - "type": "object" + "title": "NetworkAccessGuardianApprovalReviewAction" }, { + "type": "object", + "required": [ + "server", + "toolName", + "type" + ], "properties": { "connectorId": { "type": [ @@ -458,22 +499,21 @@ ] }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallGuardianApprovalReviewActionType", - "type": "string" + "title": "McpToolCallGuardianApprovalReviewActionType" } }, - "required": [ - "server", - "toolName", - "type" - ], - "title": "McpToolCallGuardianApprovalReviewAction", - "type": "object" + "title": "McpToolCallGuardianApprovalReviewAction" }, { + "type": "object", + "required": [ + "permissions", + "type" + ], "properties": { "permissions": { "$ref": "#/definitions/RequestPermissionProfile" @@ -485,71 +525,66 @@ ] }, "type": { + "type": "string", "enum": [ "requestPermissions" ], - "title": "RequestPermissionsGuardianApprovalReviewActionType", - "type": "string" + "title": "RequestPermissionsGuardianApprovalReviewActionType" } }, - "required": [ - "permissions", - "type" - ], - "title": "RequestPermissionsGuardianApprovalReviewAction", - "type": "object" + "title": "RequestPermissionsGuardianApprovalReviewAction" } ] }, "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": { - "additionalProperties": false, + "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -572,42 +607,7 @@ ] } }, - "type": "object" + "additionalProperties": false } - }, - "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 16bfeece..0491db4c 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,30 +1,52 @@ { "$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": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -35,13 +57,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -50,30 +69,36 @@ "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" @@ -85,23 +110,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -113,21 +136,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -145,113 +168,114 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "DynamicToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -262,15 +286,14 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -278,78 +301,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -357,78 +382,75 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -437,23 +459,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -461,18 +480,21 @@ "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.", @@ -481,74 +503,77 @@ "null" ] } - }, - "required": [ - "byteRange" - ], - "type": "object" + } }, "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -556,10 +581,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -567,30 +592,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -599,56 +623,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -663,34 +690,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" @@ -703,42 +730,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -747,32 +772,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -813,43 +840,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -873,31 +899,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -918,6 +946,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -925,57 +954,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -994,22 +1018,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -1018,22 +1042,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -1061,23 +1086,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -1086,22 +1110,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -1110,114 +1134,114 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "UserInput": { "oneOf": [ { + "type": "object", + "required": [ + "text", + "type" + ], "properties": { "text": { "type": "string" }, "text_elements": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1226,22 +1250,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1250,35 +1274,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -1287,27 +1309,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -1316,13 +1338,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -1331,11 +1353,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -1344,47 +1366,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 52149d9f..ca6c7490 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,14 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "McpServerStatusDetail": { - "enum": [ - "full", - "toolsAndAuthOnly" - ], - "type": "string" - } - }, + "title": "ListMcpServerStatusParams", + "type": "object", "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -18,6 +11,7 @@ ] }, "detail": { + "description": "Controls how much MCP inventory data to fetch for each server. Defaults to `Full` when omitted.", "anyOf": [ { "$ref": "#/definitions/McpServerStatusDetail" @@ -25,19 +19,25 @@ { "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 } }, - "title": "ListMcpServerStatusParams", - "type": "object" + "definitions": { + "McpServerStatusDetail": { + "type": "string", + "enum": [ + "full", + "toolsAndAuthOnly" + ] + } + } } \ 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 fc181c27..5f129f84 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,16 +1,44 @@ { "$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" @@ -19,35 +47,32 @@ "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, @@ -58,11 +83,11 @@ ] }, "icons": { - "items": true, "type": [ "array", "null" - ] + ], + "items": true }, "mimeType": { "type": [ @@ -74,11 +99,11 @@ "type": "string" }, "size": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "title": { "type": [ @@ -89,15 +114,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": { @@ -124,15 +149,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, @@ -143,11 +168,11 @@ ] }, "icons": { - "items": true, "type": [ "array", "null" - ] + ], + "items": true }, "inputSchema": true, "name": { @@ -160,32 +185,7 @@ "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 a933b71a..9f3be7ff 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,60 +1,67 @@ { "$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", - "type": "string" + "title": "ApiKeyv2::LoginAccountParamsType" } }, - "required": [ - "apiKey", - "type" - ], - "title": "ApiKeyv2::LoginAccountParams", - "type": "object" + "title": "ApiKeyv2::LoginAccountParams" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "chatgpt" ], - "title": "Chatgptv2::LoginAccountParamsType", - "type": "string" + "title": "Chatgptv2::LoginAccountParamsType" } }, + "title": "Chatgptv2::LoginAccountParams" + }, + { + "type": "object", "required": [ "type" ], - "title": "Chatgptv2::LoginAccountParams", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "chatgptDeviceCode" ], - "title": "ChatgptDeviceCodev2::LoginAccountParamsType", - "type": "string" + "title": "ChatgptDeviceCodev2::LoginAccountParamsType" } }, - "required": [ - "type" - ], - "title": "ChatgptDeviceCodev2::LoginAccountParams", - "type": "object" + "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.", @@ -72,21 +79,14 @@ ] }, "type": { + "type": "string", "enum": [ "chatgptAuthTokens" ], - "title": "ChatgptAuthTokensv2::LoginAccountParamsType", - "type": "string" + "title": "ChatgptAuthTokensv2::LoginAccountParamsType" } }, - "required": [ - "accessToken", - "chatgptAccountId", - "type" - ], - "title": "ChatgptAuthTokensv2::LoginAccountParams", - "type": "object" + "title": "ChatgptAuthTokensv2::LoginAccountParams" } - ], - "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 a800bffc..b98fb05c 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,23 +1,30 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "LoginAccountResponse", "oneOf": [ { - "properties": { - "type": { - "enum": [ - "apiKey" - ], - "title": "ApiKeyv2::LoginAccountResponseType", - "type": "string" - } - }, + "type": "object", "required": [ "type" ], - "title": "ApiKeyv2::LoginAccountResponse", - "type": "object" + "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.", @@ -27,32 +34,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "chatgpt" ], - "title": "Chatgptv2::LoginAccountResponseType", - "type": "string" + "title": "Chatgptv2::LoginAccountResponseType" } }, - "required": [ - "authUrl", - "loginId", - "type" - ], - "title": "Chatgptv2::LoginAccountResponse", - "type": "object" + "title": "Chatgptv2::LoginAccountResponse" }, { + "type": "object", + "required": [ + "loginId", + "type", + "userCode", + "verificationUrl" + ], "properties": { "loginId": { "type": "string" }, "type": { + "type": "string", "enum": [ "chatgptDeviceCode" ], - "title": "ChatgptDeviceCodev2::LoginAccountResponseType", - "type": "string" + "title": "ChatgptDeviceCodev2::LoginAccountResponseType" }, "userCode": { "description": "One-time code the user must enter after signing in.", @@ -63,31 +71,23 @@ "type": "string" } }, - "required": [ - "loginId", - "type", - "userCode", - "verificationUrl" - ], - "title": "ChatgptDeviceCodev2::LoginAccountResponse", - "type": "object" + "title": "ChatgptDeviceCodev2::LoginAccountResponse" }, { - "properties": { - "type": { - "enum": [ - "chatgptAuthTokens" - ], - "title": "ChatgptAuthTokensv2::LoginAccountResponseType", - "type": "string" - } - }, + "type": "object", "required": [ "type" ], - "title": "ChatgptAuthTokensv2::LoginAccountResponse", - "type": "object" + "properties": { + "type": { + "type": "string", + "enum": [ + "chatgptAuthTokens" + ], + "title": "ChatgptAuthTokensv2::LoginAccountResponseType" + } + }, + "title": "ChatgptAuthTokensv2::LoginAccountResponse" } - ], - "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 2fe58155..9fc87fd1 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,5 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "McpResourceReadParams", + "type": "object", + "required": [ + "server", + "uri" + ], "properties": { "server": { "type": "string" @@ -13,11 +19,5 @@ "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 b1a40123..4bd9d22b 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,9 +1,28 @@ { "$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": { @@ -19,14 +38,14 @@ "description": "The URI of this resource.", "type": "string" } - }, - "required": [ - "text", - "uri" - ], - "type": "object" + } }, { + "type": "object", + "required": [ + "blob", + "uri" + ], "properties": { "_meta": true, "blob": { @@ -42,28 +61,9 @@ "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 35efd2ba..3a89236c 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,5 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "McpServerOauthLoginCompletedNotification", + "type": "object", + "required": [ + "name", + "success" + ], "properties": { "error": { "type": [ @@ -13,11 +19,5 @@ "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 4370f444..0c7343c9 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 efeb612d..d65af19b 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 b0e2cd5a..9e2708c0 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,16 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "McpServerStartupState": { - "enum": [ - "starting", - "ready", - "failed", - "cancelled" - ], - "type": "string" - } - }, + "title": "McpServerStatusUpdatedNotification", + "type": "object", + "required": [ + "name", + "status" + ], "properties": { "error": { "type": [ @@ -25,10 +20,15 @@ "$ref": "#/definitions/McpServerStartupState" } }, - "required": [ - "name", - "status" - ], - "title": "McpServerStatusUpdatedNotification", - "type": "object" + "definitions": { + "McpServerStartupState": { + "type": "string", + "enum": [ + "starting", + "ready", + "failed", + "cancelled" + ] + } + } } \ 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 3465e60c..bc1de9c0 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,5 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "McpServerToolCallParams", + "type": "object", + "required": [ + "server", + "threadId", + "tool" + ], "properties": { "_meta": true, "arguments": true, @@ -12,12 +19,5 @@ "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 0e5ecdf7..2fedb1ee 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,10 +1,15 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "McpServerToolCallResponse", + "type": "object", + "required": [ + "content" + ], "properties": { "_meta": true, "content": { - "items": true, - "type": "array" + "type": "array", + "items": true }, "isError": { "type": [ @@ -13,10 +18,5 @@ ] }, "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 419cab74..ce627dc7 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,5 +1,13 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "McpToolCallProgressNotification", + "type": "object", + "required": [ + "itemId", + "message", + "threadId", + "turnId" + ], "properties": { "itemId": { "type": "string" @@ -13,13 +21,5 @@ "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 11a34762..cd7bb256 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,5 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ModelListParams", + "type": "object", "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -17,14 +19,12 @@ }, "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 dc60c5b7..e29eb31c 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,33 +1,64 @@ { "$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": [ @@ -59,10 +90,10 @@ "text", "image" ], + "type": "array", "items": { "$ref": "#/definitions/InputModality" - }, - "type": "array" + } }, "isDefault": { "type": "boolean" @@ -71,10 +102,10 @@ "type": "string" }, "supportedReasoningEfforts": { + "type": "array", "items": { "$ref": "#/definitions/ReasoningEffortOption" - }, - "type": "array" + } }, "supportsPersonality": { "default": false, @@ -96,31 +127,24 @@ } ] } - }, - "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": [ @@ -143,14 +167,11 @@ "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", @@ -158,10 +179,14 @@ "medium", "high", "xhigh" - ], - "type": "string" + ] }, "ReasoningEffortOption": { + "type": "object", + "required": [ + "description", + "reasoningEffort" + ], "properties": { "description": { "type": "string" @@ -169,32 +194,7 @@ "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 b9bcc491..1de3b92e 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,13 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "ModelRerouteReason": { - "enum": [ - "highRiskCyberActivity" - ], - "type": "string" - } - }, + "title": "ModelReroutedNotification", + "type": "object", + "required": [ + "fromModel", + "reason", + "threadId", + "toModel", + "turnId" + ], "properties": { "fromModel": { "type": "string" @@ -25,13 +26,12 @@ "type": "string" } }, - "required": [ - "fromModel", - "reason", - "threadId", - "toModel", - "turnId" - ], - "title": "ModelReroutedNotification", - "type": "object" + "definitions": { + "ModelRerouteReason": { + "type": "string", + "enum": [ + "highRiskCyberActivity" + ] + } + } } \ 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 64463926..baf0c8eb 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,6 +1,14 @@ { "$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" @@ -14,13 +22,5 @@ "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 956e3b25..0a982ef5 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,29 +1,52 @@ { "$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", - "type": "string" + "title": "InputTextContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextContentItem", - "type": "object" + "title": "InputTextContentItem" }, { + "type": "object", + "required": [ + "image_url", + "type" + ], "properties": { "detail": { "anyOf": [ @@ -39,39 +62,34 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "input_image" ], - "title": "InputImageContentItemType", - "type": "string" + "title": "InputImageContentItemType" } }, - "required": [ - "image_url", - "type" - ], - "title": "InputImageContentItem", - "type": "object" + "title": "InputImageContentItem" }, { + "type": "object", + "required": [ + "text", + "type" + ], "properties": { "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "output_text" ], - "title": "OutputTextContentItemType", - "type": "string" + "title": "OutputTextContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "OutputTextContentItem", - "type": "object" + "title": "OutputTextContentItem" } ] }, @@ -81,10 +99,10 @@ "type": "string" }, { + "type": "array", "items": { "$ref": "#/definitions/FunctionCallOutputContentItem" - }, - "type": "array" + } } ] }, @@ -92,26 +110,31 @@ "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", - "type": "string" + "title": "InputTextFunctionCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextFunctionCallOutputContentItem", - "type": "object" + "title": "InputTextFunctionCallOutputContentItem" }, { + "type": "object", + "required": [ + "image_url", + "type" + ], "properties": { "detail": { "anyOf": [ @@ -127,24 +150,25 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "input_image" ], - "title": "InputImageFunctionCallOutputContentItemType", - "type": "string" + "title": "InputImageFunctionCallOutputContentItemType" } }, - "required": [ - "image_url", - "type" - ], - "title": "InputImageFunctionCallOutputContentItem", - "type": "object" + "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" @@ -156,67 +180,66 @@ ] }, "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", - "type": "string" + "title": "ExecLocalShellActionType" }, "user": { "type": [ @@ -231,119 +254,120 @@ ] } }, - "required": [ - "command", - "type" - ], - "title": "ExecLocalShellAction", - "type": "object" + "title": "ExecLocalShellAction" } ] }, "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", - "type": "string" + "title": "ReasoningTextReasoningItemContentType" } }, + "title": "ReasoningTextReasoningItemContent" + }, + { + "type": "object", "required": [ "text", "type" ], - "title": "ReasoningTextReasoningItemContent", - "type": "object" - }, - { "properties": { "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextReasoningItemContentType", - "type": "string" + "title": "TextReasoningItemContentType" } }, - "required": [ - "text", - "type" - ], - "title": "TextReasoningItemContent", - "type": "object" + "title": "TextReasoningItemContent" } ] }, "ReasoningItemReasoningSummary": { "oneOf": [ { + "type": "object", + "required": [ + "text", + "type" + ], "properties": { "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "summary_text" ], - "title": "SummaryTextReasoningItemReasoningSummaryType", - "type": "string" + "title": "SummaryTextReasoningItemReasoningSummaryType" } }, - "required": [ - "text", - "type" - ], - "title": "SummaryTextReasoningItemReasoningSummary", - "type": "object" + "title": "SummaryTextReasoningItemReasoningSummary" } ] }, "ResponseItem": { "oneOf": [ { + "type": "object", + "required": [ + "content", + "role", + "type" + ], "properties": { "content": { + "type": "array", "items": { "$ref": "#/definitions/ContentItem" - }, - "type": "array" + } }, "end_turn": { "type": [ @@ -352,11 +376,11 @@ ] }, "id": { + "writeOnly": true, "type": [ "string", "null" - ], - "writeOnly": true + ] }, "phase": { "anyOf": [ @@ -372,32 +396,31 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "message" ], - "title": "MessageResponseItemType", - "type": "string" + "title": "MessageResponseItemType" } }, - "required": [ - "content", - "role", - "type" - ], - "title": "MessageResponseItem", - "type": "object" + "title": "MessageResponseItem" }, { + "type": "object", + "required": [ + "summary", + "type" + ], "properties": { "content": { "default": null, - "items": { - "$ref": "#/definitions/ReasoningItemContent" - }, "type": [ "array", "null" - ] + ], + "items": { + "$ref": "#/definitions/ReasoningItemContent" + } }, "encrypted_content": { "type": [ @@ -406,27 +429,28 @@ ] }, "summary": { + "type": "array", "items": { "$ref": "#/definitions/ReasoningItemReasoningSummary" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "reasoning" ], - "title": "ReasoningResponseItemType", - "type": "string" + "title": "ReasoningResponseItemType" } }, - "required": [ - "summary", - "type" - ], - "title": "ReasoningResponseItem", - "type": "object" + "title": "ReasoningResponseItem" }, { + "type": "object", + "required": [ + "action", + "status", + "type" + ], "properties": { "action": { "$ref": "#/definitions/LocalShellAction" @@ -440,32 +464,33 @@ }, "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", - "type": "string" + "title": "LocalShellCallResponseItemType" } }, - "required": [ - "action", - "status", - "type" - ], - "title": "LocalShellCallResponseItem", - "type": "object" + "title": "LocalShellCallResponseItem" }, { + "type": "object", + "required": [ + "arguments", + "call_id", + "name", + "type" + ], "properties": { "arguments": { "type": "string" @@ -474,11 +499,11 @@ "type": "string" }, "id": { + "writeOnly": true, "type": [ "string", "null" - ], - "writeOnly": true + ] }, "name": { "type": "string" @@ -490,23 +515,22 @@ ] }, "type": { + "type": "string", "enum": [ "function_call" ], - "title": "FunctionCallResponseItemType", - "type": "string" + "title": "FunctionCallResponseItemType" } }, - "required": [ - "arguments", - "call_id", - "name", - "type" - ], - "title": "FunctionCallResponseItem", - "type": "object" + "title": "FunctionCallResponseItem" }, { + "type": "object", + "required": [ + "arguments", + "execution", + "type" + ], "properties": { "arguments": true, "call_id": { @@ -519,11 +543,11 @@ "type": "string" }, "id": { + "writeOnly": true, "type": [ "string", "null" - ], - "writeOnly": true + ] }, "status": { "type": [ @@ -532,22 +556,22 @@ ] }, "type": { + "type": "string", "enum": [ "tool_search_call" ], - "title": "ToolSearchCallResponseItemType", - "type": "string" + "title": "ToolSearchCallResponseItemType" } }, - "required": [ - "arguments", - "execution", - "type" - ], - "title": "ToolSearchCallResponseItem", - "type": "object" + "title": "ToolSearchCallResponseItem" }, { + "type": "object", + "required": [ + "call_id", + "output", + "type" + ], "properties": { "call_id": { "type": "string" @@ -556,32 +580,33 @@ "$ref": "#/definitions/FunctionCallOutputBody" }, "type": { + "type": "string", "enum": [ "function_call_output" ], - "title": "FunctionCallOutputResponseItemType", - "type": "string" + "title": "FunctionCallOutputResponseItemType" } }, - "required": [ - "call_id", - "output", - "type" - ], - "title": "FunctionCallOutputResponseItem", - "type": "object" + "title": "FunctionCallOutputResponseItem" }, { + "type": "object", + "required": [ + "call_id", + "input", + "name", + "type" + ], "properties": { "call_id": { "type": "string" }, "id": { + "writeOnly": true, "type": [ "string", "null" - ], - "writeOnly": true + ] }, "input": { "type": "string" @@ -596,23 +621,22 @@ ] }, "type": { + "type": "string", "enum": [ "custom_tool_call" ], - "title": "CustomToolCallResponseItemType", - "type": "string" + "title": "CustomToolCallResponseItemType" } }, - "required": [ - "call_id", - "input", - "name", - "type" - ], - "title": "CustomToolCallResponseItem", - "type": "object" + "title": "CustomToolCallResponseItem" }, { + "type": "object", + "required": [ + "call_id", + "output", + "type" + ], "properties": { "call_id": { "type": "string" @@ -627,22 +651,23 @@ "$ref": "#/definitions/FunctionCallOutputBody" }, "type": { + "type": "string", "enum": [ "custom_tool_call_output" ], - "title": "CustomToolCallOutputResponseItemType", - "type": "string" + "title": "CustomToolCallOutputResponseItemType" } }, - "required": [ - "call_id", - "output", - "type" - ], - "title": "CustomToolCallOutputResponseItem", - "type": "object" + "title": "CustomToolCallOutputResponseItem" }, { + "type": "object", + "required": [ + "execution", + "status", + "tools", + "type" + ], "properties": { "call_id": { "type": [ @@ -657,27 +682,24 @@ "type": "string" }, "tools": { - "items": true, - "type": "array" + "type": "array", + "items": true }, "type": { + "type": "string", "enum": [ "tool_search_output" ], - "title": "ToolSearchOutputResponseItemType", - "type": "string" + "title": "ToolSearchOutputResponseItemType" } }, - "required": [ - "execution", - "status", - "tools", - "type" - ], - "title": "ToolSearchOutputResponseItem", - "type": "object" + "title": "ToolSearchOutputResponseItem" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "action": { "anyOf": [ @@ -690,11 +712,11 @@ ] }, "id": { + "writeOnly": true, "type": [ "string", "null" - ], - "writeOnly": true + ] }, "status": { "type": [ @@ -703,20 +725,23 @@ ] }, "type": { + "type": "string", "enum": [ "web_search_call" ], - "title": "WebSearchCallResponseItemType", - "type": "string" + "title": "WebSearchCallResponseItemType" } }, - "required": [ - "type" - ], - "title": "WebSearchCallResponseItem", - "type": "object" + "title": "WebSearchCallResponseItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -734,92 +759,89 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "image_generation_call" ], - "title": "ImageGenerationCallResponseItemType", - "type": "string" + "title": "ImageGenerationCallResponseItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationCallResponseItem", - "type": "object" + "title": "ImageGenerationCallResponseItem" }, { + "type": "object", + "required": [ + "ghost_commit", + "type" + ], "properties": { "ghost_commit": { "$ref": "#/definitions/GhostCommit" }, "type": { + "type": "string", "enum": [ "ghost_snapshot" ], - "title": "GhostSnapshotResponseItemType", - "type": "string" + "title": "GhostSnapshotResponseItemType" } }, - "required": [ - "ghost_commit", - "type" - ], - "title": "GhostSnapshotResponseItem", - "type": "object" + "title": "GhostSnapshotResponseItem" }, { + "type": "object", + "required": [ + "encrypted_content", + "type" + ], "properties": { "encrypted_content": { "type": "string" }, "type": { + "type": "string", "enum": [ "compaction" ], - "title": "CompactionResponseItemType", - "type": "string" + "title": "CompactionResponseItemType" } }, - "required": [ - "encrypted_content", - "type" - ], - "title": "CompactionResponseItem", - "type": "object" + "title": "CompactionResponseItem" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherResponseItemType", - "type": "string" + "title": "OtherResponseItemType" } }, - "required": [ - "type" - ], - "title": "OtherResponseItem", - "type": "object" + "title": "OtherResponseItem" } ] }, "ResponsesApiWebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -828,27 +850,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchResponsesApiWebSearchActionType", - "type": "string" + "title": "SearchResponsesApiWebSearchActionType" } }, + "title": "SearchResponsesApiWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchResponsesApiWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "open_page" ], - "title": "OpenPageResponsesApiWebSearchActionType", - "type": "string" + "title": "OpenPageResponsesApiWebSearchActionType" }, "url": { "type": [ @@ -857,13 +879,13 @@ ] } }, + "title": "OpenPageResponsesApiWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageResponsesApiWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -872,11 +894,11 @@ ] }, "type": { + "type": "string", "enum": [ "find_in_page" ], - "title": "FindInPageResponsesApiWebSearchActionType", - "type": "string" + "title": "FindInPageResponsesApiWebSearchActionType" }, "url": { "type": [ @@ -885,47 +907,25 @@ ] } }, + "title": "FindInPageResponsesApiWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageResponsesApiWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherResponsesApiWebSearchActionType", - "type": "string" + "title": "OtherResponsesApiWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherResponsesApiWebSearchAction", - "type": "object" + "title": "OtherResponsesApiWebSearchAction" } ] } - }, - "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 33debf2a..b9e449ef 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,12 +1,20 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ReasoningSummaryPartAddedNotification", + "type": "object", + "required": [ + "itemId", + "summaryIndex", + "threadId", + "turnId" + ], "properties": { "itemId": { "type": "string" }, "summaryIndex": { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "threadId": { "type": "string" @@ -14,13 +22,5 @@ "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 6f50a840..419c3a4d 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,5 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ReasoningSummaryTextDeltaNotification", + "type": "object", + "required": [ + "delta", + "itemId", + "summaryIndex", + "threadId", + "turnId" + ], "properties": { "delta": { "type": "string" @@ -8,8 +17,8 @@ "type": "string" }, "summaryIndex": { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "threadId": { "type": "string" @@ -17,14 +26,5 @@ "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 ebfd5dc8..d68ad40a 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,9 +1,18 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ReasoningTextDeltaNotification", + "type": "object", + "required": [ + "contentIndex", + "delta", + "itemId", + "threadId", + "turnId" + ], "properties": { "contentIndex": { - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "delta": { "type": "string" @@ -17,14 +26,5 @@ "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 0089d464..9b799790 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,55 +1,86 @@ { "$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.", - "properties": { - "type": { - "enum": [ - "uncommittedChanges" - ], - "title": "UncommittedChangesReviewTargetType", - "type": "string" - } - }, + "type": "object", "required": [ "type" ], - "title": "UncommittedChangesReviewTarget", - "type": "object" + "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", - "type": "string" + "title": "BaseBranchReviewTargetType" } }, - "required": [ - "branch", - "type" - ], - "title": "BaseBranchReviewTarget", - "type": "object" + "title": "BaseBranchReviewTarget" }, { "description": "Review the changes introduced by a specific commit.", + "type": "object", + "required": [ + "sha", + "type" + ], "properties": { "sha": { "type": "string" @@ -62,68 +93,37 @@ ] }, "type": { + "type": "string", "enum": [ "commit" ], - "title": "CommitReviewTargetType", - "type": "string" + "title": "CommitReviewTargetType" } }, - "required": [ - "sha", - "type" - ], - "title": "CommitReviewTarget", - "type": "object" + "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", - "type": "string" + "title": "CustomReviewTargetType" } }, - "required": [ - "instructions", - "type" - ], - "title": "CustomReviewTarget", - "type": "object" + "title": "CustomReviewTarget" } ] } - }, - "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 e8500d7a..6fe01a9e 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,33 +1,49 @@ { "$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": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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,129 +54,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -171,13 +190,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -186,30 +202,36 @@ "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" @@ -221,23 +243,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -249,21 +269,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -281,113 +301,114 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "DynamicToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -398,15 +419,14 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -414,78 +434,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -493,85 +515,82 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -580,23 +599,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -604,18 +620,21 @@ "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.", @@ -624,74 +643,77 @@ "null" ] } - }, - "required": [ - "byteRange" - ], - "type": "object" + } }, "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -699,10 +721,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -710,30 +732,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -742,56 +763,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -806,34 +830,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" @@ -846,42 +870,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -890,32 +912,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -956,43 +980,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -1016,31 +1039,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -1061,6 +1086,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -1068,57 +1094,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -1137,22 +1158,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -1161,22 +1182,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -1204,23 +1226,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -1229,22 +1250,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -1253,62 +1274,63 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "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" @@ -1316,39 +1338,36 @@ { "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, @@ -1370,92 +1389,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1464,22 +1485,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1488,35 +1509,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -1525,27 +1544,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -1554,13 +1573,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -1569,11 +1588,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -1582,44 +1601,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 c3c63ede..43f566f1 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#", - "definitions": { - "AddCreditsNudgeCreditType": { - "enum": [ - "credits", - "usage_limit" - ], - "type": "string" - } - }, + "title": "SendAddCreditsNudgeEmailParams", + "type": "object", + "required": [ + "creditType" + ], "properties": { "creditType": { "$ref": "#/definitions/AddCreditsNudgeCreditType" } }, - "required": [ - "creditType" - ], - "title": "SendAddCreditsNudgeEmailParams", - "type": "object" + "definitions": { + "AddCreditsNudgeCreditType": { + "type": "string", + "enum": [ + "credits", + "usage_limit" + ] + } + } } \ 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 bfeba322..57487b09 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#", - "definitions": { - "AddCreditsNudgeEmailStatus": { - "enum": [ - "sent", - "cooldown_active" - ], - "type": "string" - } - }, + "title": "SendAddCreditsNudgeEmailResponse", + "type": "object", + "required": [ + "status" + ], "properties": { "status": { "$ref": "#/definitions/AddCreditsNudgeEmailStatus" } }, - "required": [ - "status" - ], - "title": "SendAddCreditsNudgeEmailResponse", - "type": "object" + "definitions": { + "AddCreditsNudgeEmailStatus": { + "type": "string", + "enum": [ + "sent", + "cooldown_active" + ] + } + } } \ 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 18a5e760..f0f21d75 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,18 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "RequestId": { - "anyOf": [ - { - "type": "string" - }, - { - "format": "int64", - "type": "integer" - } - ] - } - }, + "title": "ServerRequestResolvedNotification", + "type": "object", + "required": [ + "requestId", + "threadId" + ], "properties": { "requestId": { "$ref": "#/definitions/RequestId" @@ -21,10 +14,17 @@ "type": "string" } }, - "required": [ - "requestId", - "threadId" - ], - "title": "ServerRequestResolvedNotification", - "type": "object" + "definitions": { + "RequestId": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "integer", + "format": "int64" + } + ] + } + } } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsChangedNotification.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsChangedNotification.json deleted file mode 100644 index cb67d816..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsChangedNotification.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "$schema": "http://json-schema.org/draft-07/schema#", - "description": "Notification emitted when watched local skill files change.\n\nTreat this as an invalidation signal and re-run `skills/list` with the client's current parameters when refreshed skill metadata is needed.", - "title": "SkillsChangedNotification", - "type": "object" -} \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteParams.json deleted file mode 100644 index 696226a5..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteParams.json +++ /dev/null @@ -1,37 +0,0 @@ -{ - "$schema": "http://json-schema.org/draft-07/schema#", - "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": { - "enabled": { - "type": "boolean" - }, - "name": { - "description": "Name-based selector.", - "type": [ - "string", - "null" - ] - }, - "path": { - "anyOf": [ - { - "$ref": "#/definitions/AbsolutePathBuf" - }, - { - "type": "null" - } - ], - "description": "Path-based selector." - } - }, - "required": [ - "enabled" - ], - "title": "SkillsConfigWriteParams", - "type": "object" -} \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteResponse.json deleted file mode 100644 index 09d73b44..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteResponse.json +++ /dev/null @@ -1,13 +0,0 @@ -{ - "$schema": "http://json-schema.org/draft-07/schema#", - "properties": { - "effectiveEnabled": { - "type": "boolean" - } - }, - "required": [ - "effectiveEnabled" - ], - "title": "SkillsConfigWriteResponse", - "type": "object" -} \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsListParams.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsListParams.json index 77d12e91..8d6cd2cf 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsListParams.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsListParams.json @@ -1,49 +1,49 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "SkillsListExtraRootsForCwd": { - "properties": { - "cwd": { - "type": "string" - }, - "extraUserRoots": { - "items": { - "type": "string" - }, - "type": "array" - } - }, - "required": [ - "cwd", - "extraUserRoots" - ], - "type": "object" - } - }, + "title": "SkillsListParams", + "type": "object", "properties": { "cwds": { "description": "When empty, defaults to the current session working directory.", + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "forceReload": { "description": "When true, bypass the skills cache and re-scan skills from disk.", "type": "boolean" }, "perCwdExtraUserRoots": { - "default": null, "description": "Optional per-cwd extra roots to scan as user-scoped skills.", - "items": { - "$ref": "#/definitions/SkillsListExtraRootsForCwd" - }, + "default": null, "type": [ "array", "null" - ] + ], + "items": { + "$ref": "#/definitions/SkillsListExtraRootsForCwd" + } } }, - "title": "SkillsListParams", - "type": "object" + "definitions": { + "SkillsListExtraRootsForCwd": { + "type": "object", + "required": [ + "cwd", + "extraUserRoots" + ], + "properties": { + "cwd": { + "type": "string" + }, + "extraUserRoots": { + "type": "array", + "items": { + "type": "string" + } + } + } + } + } } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsListResponse.json b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsListResponse.json index 6c72bfbb..57f81a76 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsListResponse.json +++ b/vendor/codex/codex-rs/app-server-protocol/schema/json/v2/SkillsListResponse.json @@ -1,25 +1,43 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "SkillsListResponse", + "type": "object", + "required": [ + "data" + ], + "properties": { + "data": { + "type": "array", + "items": { + "$ref": "#/definitions/SkillsListEntry" + } + } + }, "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" }, "SkillDependencies": { - "properties": { - "tools": { - "items": { - "$ref": "#/definitions/SkillToolDependency" - }, - "type": "array" - } - }, + "type": "object", "required": [ "tools" ], - "type": "object" + "properties": { + "tools": { + "type": "array", + "items": { + "$ref": "#/definitions/SkillToolDependency" + } + } + } }, "SkillErrorInfo": { + "type": "object", + "required": [ + "message", + "path" + ], "properties": { "message": { "type": "string" @@ -27,14 +45,10 @@ "path": { "type": "string" } - }, - "required": [ - "message", - "path" - ], - "type": "object" + } }, "SkillInterface": { + "type": "object", "properties": { "brandColor": { "type": [ @@ -80,10 +94,17 @@ "null" ] } - }, - "type": "object" + } }, "SkillMetadata": { + "type": "object", + "required": [ + "description", + "enabled", + "name", + "path", + "scope" + ], "properties": { "dependencies": { "anyOf": [ @@ -127,26 +148,23 @@ "null" ] } - }, - "required": [ - "description", - "enabled", - "name", - "path", - "scope" - ], - "type": "object" + } }, "SkillScope": { + "type": "string", "enum": [ "user", "repo", "system", "admin" - ], - "type": "string" + ] }, "SkillToolDependency": { + "type": "object", + "required": [ + "type", + "value" + ], "properties": { "command": { "type": [ @@ -178,50 +196,32 @@ "value": { "type": "string" } - }, - "required": [ - "type", - "value" - ], - "type": "object" + } }, "SkillsListEntry": { - "properties": { - "cwd": { - "type": "string" - }, - "errors": { - "items": { - "$ref": "#/definitions/SkillErrorInfo" - }, - "type": "array" - }, - "skills": { - "items": { - "$ref": "#/definitions/SkillMetadata" - }, - "type": "array" - } - }, + "type": "object", "required": [ "cwd", "errors", "skills" ], - "type": "object" + "properties": { + "cwd": { + "type": "string" + }, + "errors": { + "type": "array", + "items": { + "$ref": "#/definitions/SkillErrorInfo" + } + }, + "skills": { + "type": "array", + "items": { + "$ref": "#/definitions/SkillMetadata" + } + } + } } - }, - "properties": { - "data": { - "items": { - "$ref": "#/definitions/SkillsListEntry" - }, - "type": "array" - } - }, - "required": [ - "data" - ], - "title": "SkillsListResponse", - "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 ca2648a3..823daeeb 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,5 +1,14 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "TerminalInteractionNotification", + "type": "object", + "required": [ + "itemId", + "processId", + "stdin", + "threadId", + "turnId" + ], "properties": { "itemId": { "type": "string" @@ -16,14 +25,5 @@ "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 3938815e..c9d4bfe2 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,5 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadApproveGuardianDeniedActionParams", + "type": "object", + "required": [ + "event", + "threadId" + ], "properties": { "event": { "description": "Serialized `codex_protocol::protocol::GuardianAssessmentEvent`." @@ -7,11 +13,5 @@ "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 49322b60..3784f876 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 cd24f957..83126d36 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 13e7f577..0d2cf8ad 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 a174ff95..0662c96b 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 90049743..b0a82ab1 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,13 +1,49 @@ { "$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": [ @@ -31,30 +67,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": [ @@ -63,16 +99,16 @@ ] }, "linkedGraphNodeIds": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "linkedSubgoalIds": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "ownerRole": { "type": "string" @@ -89,26 +125,19 @@ "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", @@ -119,42 +148,13 @@ "cancelled", "blocked", "unavailable" - ], - "type": "string" - }, - "ThreadEpiphanyJobsUpdatedSource": { - "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" + "ThreadEpiphanyJobsUpdatedSource": { + "type": "string", + "enum": [ + "runtimeProgress" + ] } - }, - "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 548fca40..739318d3 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,7 +1,49 @@ { "$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" @@ -45,41 +87,42 @@ "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": [ @@ -88,10 +131,10 @@ ] }, "evidence_refs": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "horizon": { "type": "string" @@ -103,10 +146,10 @@ "type": "string" }, "lane_hints": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -115,10 +158,10 @@ "type": "string" }, "source_refs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "type": "array" + } }, "status": { "type": "string" @@ -135,21 +178,14 @@ "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" @@ -164,12 +200,12 @@ "type": "string" }, "unexplained_writes": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "warning": { "type": [ @@ -177,22 +213,21 @@ "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": [ @@ -204,12 +239,12 @@ "type": "string" }, "start_line": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "symbol": { "type": [ @@ -217,19 +252,22 @@ "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" @@ -243,59 +281,57 @@ "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, - "type": "integer" + "minimum": 0.0 }, "open_gap_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "open_question_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -303,20 +339,21 @@ "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": [ @@ -345,59 +382,58 @@ "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" @@ -408,20 +444,21 @@ "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" @@ -450,15 +487,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "purpose", - "title" - ], - "type": "object" + } }, "EpiphanyGraphs": { + "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -467,15 +499,20 @@ "$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" @@ -492,15 +529,16 @@ "status": { "type": "string" } - }, - "required": [ - "description", - "id", - "status" - ], - "type": "object" + } }, "EpiphanyInvestigationCheckpoint": { + "type": "object", + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], "properties": { "captured_at_turn_id": { "type": [ @@ -512,19 +550,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" @@ -539,10 +577,10 @@ ] }, "open_questions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -550,23 +588,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": [ @@ -587,16 +625,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" @@ -604,32 +642,29 @@ "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": [ @@ -644,31 +679,36 @@ "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" @@ -677,25 +717,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" @@ -706,18 +746,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "type": "object" + } }, "EpiphanyObjectiveDraftLanePlan": { + "type": "object", "properties": { "body": { "type": [ @@ -755,39 +787,45 @@ "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" @@ -801,16 +839,17 @@ "summary": { "type": "string" } - }, - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "type": "object" + } }, "EpiphanyPlanningCapture": { + "type": "object", + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], "properties": { "body": { "type": [ @@ -843,10 +882,10 @@ "type": "string" }, "tags": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": "string" @@ -857,23 +896,20 @@ "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": [ @@ -903,10 +939,10 @@ ] }, "unblocks": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "urgency": { "type": [ @@ -917,20 +953,19 @@ "value": { "type": "string" } - }, - "required": [ - "rationale", - "value" - ], - "type": "object" + } }, "EpiphanyPlanningSourceRef": { + "type": "object", + "required": [ + "kind" + ], "properties": { "assignees": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "author": { "type": [ @@ -951,11 +986,11 @@ ] }, "database_id": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "external_id": { "type": [ @@ -976,21 +1011,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": [ @@ -1040,37 +1075,34 @@ "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": [ @@ -1078,29 +1110,33 @@ "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" @@ -1112,27 +1148,26 @@ "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": [ @@ -1141,79 +1176,82 @@ ] }, "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": [ @@ -1236,16 +1274,18 @@ "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" @@ -1257,16 +1297,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" @@ -1283,18 +1323,10 @@ "surface": { "type": "string" } - }, - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "type": "object" + } }, "EpiphanyScratchPad": { + "type": "object", "properties": { "hypothesis": { "type": [ @@ -1309,10 +1341,10 @@ ] }, "notes": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1320,10 +1352,15 @@ "null" ] } - }, - "type": "object" + } }, "EpiphanySubgoal": { + "type": "object", + "required": [ + "id", + "status", + "title" + ], "properties": { "id": { "type": "string" @@ -1340,21 +1377,19 @@ "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": [ @@ -1396,10 +1431,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - }, - "type": "array" + } }, "investigation_checkpoint": { "anyOf": [ @@ -1412,10 +1447,10 @@ ] }, "job_bindings": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - }, - "type": "array" + } }, "last_updated_turn_id": { "type": [ @@ -1440,19 +1475,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": [ @@ -1465,15 +1500,15 @@ ] }, "revision": { + "type": "integer", "format": "uint64", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "runtime_links": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - }, - "type": "array" + } }, "scratch": { "anyOf": [ @@ -1486,18 +1521,15 @@ ] }, "subgoals": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - }, - "type": "array" + } } - }, - "required": [ - "revision" - ], - "type": "object" + } }, "ThreadEpiphanyStateUpdatedField": { + "type": "string", "enum": [ "objective", "activeSubgoalId", @@ -1516,10 +1548,10 @@ "churn", "mode", "planning" - ], - "type": "string" + ] }, "ThreadEpiphanyStateUpdatedSource": { + "type": "string", "enum": [ "update", "promote", @@ -1527,39 +1559,7 @@ "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 16a41d0d..76524319 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,355 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - }, - "skill_approval": { - "default": false, - "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" - } - }, + "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": [ @@ -362,6 +18,7 @@ ] }, "approvalsReviewer": { + "description": "Override where approval requests are routed for review on this thread and subsequent turns.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -369,8 +26,7 @@ { "type": "null" } - ], - "description": "Override where approval requests are routed for review on this thread and subsequent turns." + ] }, "baseInstructions": { "type": [ @@ -379,11 +35,11 @@ ] }, "config": { - "additionalProperties": true, "type": [ "object", "null" - ] + ], + "additionalProperties": true }, "cwd": { "type": [ @@ -413,27 +69,6 @@ "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": [ { @@ -451,13 +86,378 @@ } ] }, + "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" + } + ] } }, - "required": [ - "threadId" - ], - "title": "ThreadForkParams", - "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": { + "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" + }, + "skill_approval": { + "default": false, + "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" + ] + } + } } \ 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 afcbde42..ca5a6d3e 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,5 +1,89 @@ { "$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.", @@ -10,28 +94,37 @@ }, "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" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "granular" + ], "properties": { "granular": { + "type": "object", + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -50,46 +143,38 @@ "default": false, "type": "boolean" } - }, - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "type": "object" + } } }, - "required": [ - "granular" - ], - "title": "GranularAskForApproval", - "type": "object" + "additionalProperties": false, + "title": "GranularAskForApproval" } ] }, "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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", @@ -100,129 +185,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -233,13 +321,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -248,30 +333,36 @@ "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" @@ -283,23 +374,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -311,21 +400,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -343,113 +432,119 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "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" @@ -493,41 +588,42 @@ "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": [ @@ -536,10 +632,10 @@ ] }, "evidence_refs": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "horizon": { "type": "string" @@ -551,10 +647,10 @@ "type": "string" }, "lane_hints": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -563,10 +659,10 @@ "type": "string" }, "source_refs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "type": "array" + } }, "status": { "type": "string" @@ -583,21 +679,14 @@ "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" @@ -612,12 +701,12 @@ "type": "string" }, "unexplained_writes": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "warning": { "type": [ @@ -625,22 +714,21 @@ "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": [ @@ -652,12 +740,12 @@ "type": "string" }, "start_line": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "symbol": { "type": [ @@ -665,19 +753,22 @@ "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" @@ -691,59 +782,57 @@ "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, - "type": "integer" + "minimum": 0.0 }, "open_gap_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "open_question_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -751,20 +840,21 @@ "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": [ @@ -793,59 +883,58 @@ "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" @@ -856,20 +945,21 @@ "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" @@ -898,15 +988,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "purpose", - "title" - ], - "type": "object" + } }, "EpiphanyGraphs": { + "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -915,15 +1000,20 @@ "$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" @@ -940,15 +1030,16 @@ "status": { "type": "string" } - }, - "required": [ - "description", - "id", - "status" - ], - "type": "object" + } }, "EpiphanyInvestigationCheckpoint": { + "type": "object", + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], "properties": { "captured_at_turn_id": { "type": [ @@ -960,19 +1051,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" @@ -987,10 +1078,10 @@ ] }, "open_questions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -998,23 +1089,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": [ @@ -1035,16 +1126,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" @@ -1052,32 +1143,29 @@ "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": [ @@ -1092,31 +1180,36 @@ "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" @@ -1125,25 +1218,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" @@ -1154,18 +1247,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "type": "object" + } }, "EpiphanyObjectiveDraftLanePlan": { + "type": "object", "properties": { "body": { "type": [ @@ -1203,39 +1288,45 @@ "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" @@ -1249,16 +1340,17 @@ "summary": { "type": "string" } - }, - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "type": "object" + } }, "EpiphanyPlanningCapture": { + "type": "object", + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], "properties": { "body": { "type": [ @@ -1291,10 +1383,10 @@ "type": "string" }, "tags": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": "string" @@ -1305,23 +1397,20 @@ "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": [ @@ -1351,10 +1440,10 @@ ] }, "unblocks": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "urgency": { "type": [ @@ -1365,20 +1454,19 @@ "value": { "type": "string" } - }, - "required": [ - "rationale", - "value" - ], - "type": "object" + } }, "EpiphanyPlanningSourceRef": { + "type": "object", + "required": [ + "kind" + ], "properties": { "assignees": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "author": { "type": [ @@ -1399,11 +1487,11 @@ ] }, "database_id": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "external_id": { "type": [ @@ -1424,21 +1512,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": [ @@ -1488,37 +1576,34 @@ "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": [ @@ -1526,29 +1611,33 @@ "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" @@ -1560,27 +1649,26 @@ "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": [ @@ -1589,79 +1677,82 @@ ] }, "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": [ @@ -1684,16 +1775,18 @@ "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" @@ -1705,16 +1798,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" @@ -1731,18 +1824,10 @@ "surface": { "type": "string" } - }, - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "type": "object" + } }, "EpiphanyScratchPad": { + "type": "object", "properties": { "hypothesis": { "type": [ @@ -1757,10 +1842,10 @@ ] }, "notes": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1768,10 +1853,15 @@ "null" ] } - }, - "type": "object" + } }, "EpiphanySubgoal": { + "type": "object", + "required": [ + "id", + "status", + "title" + ], "properties": { "id": { "type": "string" @@ -1788,21 +1878,19 @@ "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": [ @@ -1844,10 +1932,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - }, - "type": "array" + } }, "investigation_checkpoint": { "anyOf": [ @@ -1860,10 +1948,10 @@ ] }, "job_bindings": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - }, - "type": "array" + } }, "last_updated_turn_id": { "type": [ @@ -1888,19 +1976,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": [ @@ -1913,15 +2001,15 @@ ] }, "revision": { + "type": "integer", "format": "uint64", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "runtime_links": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - }, - "type": "array" + } }, "scratch": { "anyOf": [ @@ -1934,90 +2022,91 @@ ] }, "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", - "type": "string" + "title": "PathFileSystemPathType" } }, - "required": [ - "path", - "type" - ], - "title": "PathFileSystemPath", - "type": "object" + "title": "PathFileSystemPath" }, { + "type": "object", + "required": [ + "pattern", + "type" + ], "properties": { "pattern": { "type": "string" }, "type": { + "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType", - "type": "string" + "title": "GlobPatternFileSystemPathType" } }, - "required": [ - "pattern", - "type" - ], - "title": "GlobPatternFileSystemPath", - "type": "object" + "title": "GlobPatternFileSystemPath" }, { + "type": "object", + "required": [ + "type", + "value" + ], "properties": { "type": { + "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType", - "type": "string" + "title": "SpecialFileSystemPathType" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "required": [ - "type", - "value" - ], - "title": "SpecialFileSystemPath", - "type": "object" + "title": "SpecialFileSystemPath" } ] }, "FileSystemSandboxEntry": { + "type": "object", + "required": [ + "access", + "path" + ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -2025,67 +2114,66 @@ "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": [ @@ -2094,49 +2182,50 @@ ] } }, + "title": "KindFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "KindFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "tmpdir" - ], - "type": "string" + ] } }, + "title": "TmpdirFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "TmpdirFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "slash_tmp" - ], - "type": "string" + ] } }, - "required": [ - "kind" - ], - "title": "SlashTmpFileSystemSpecialPath", - "type": "object" + "title": "SlashTmpFileSystemSpecialPath" }, { + "type": "object", + "required": [ + "kind", + "path" + ], "properties": { "kind": { + "type": "string", "enum": [ "unknown" - ], - "type": "string" + ] }, "path": { "type": "string" @@ -2147,16 +2236,17 @@ "null" ] } - }, - "required": [ - "kind", - "path" - ], - "type": "object" + } } ] }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -2167,15 +2257,10 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "GitInfo": { + "type": "object", "properties": { "branch": { "type": [ @@ -2195,10 +2280,14 @@ "null" ] } - }, - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -2206,78 +2295,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -2285,92 +2376,89 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -2379,22 +2467,19 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "PermissionProfile": { + "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -2416,32 +2501,32 @@ } ] } - }, - "type": "object" + } }, "PermissionProfileFileSystemPermissions": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - }, - "type": "array" - }, - "globScanMaxDepth": { - "format": "uint", - "minimum": 1.0, - "type": [ - "integer", - "null" - ] - } - }, + "type": "object", "required": [ "entries" ], - "type": "object" + "properties": { + "entries": { + "type": "array", + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + } + }, + "globScanMaxDepth": { + "type": [ + "integer", + "null" + ], + "format": "uint", + "minimum": 1.0 + } + } }, "PermissionProfileNetworkPermissions": { + "type": "object", "properties": { "enabled": { "type": [ @@ -2449,12 +2534,15 @@ "null" ] } - }, - "type": "object" + } }, "ReadOnlyAccess": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "includePlatformDefaults": { "default": true, @@ -2462,45 +2550,42 @@ }, "readableRoots": { "default": [], + "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "restricted" ], - "title": "RestrictedReadOnlyAccessType", - "type": "string" + "title": "RestrictedReadOnlyAccessType" } }, + "title": "RestrictedReadOnlyAccess" + }, + { + "type": "object", "required": [ "type" ], - "title": "RestrictedReadOnlyAccess", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "fullAccess" ], - "title": "FullAccessReadOnlyAccessType", - "type": "string" + "title": "FullAccessReadOnlyAccessType" } }, - "required": [ - "type" - ], - "title": "FullAccessReadOnlyAccess", - "type": "object" + "title": "FullAccessReadOnlyAccess" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -2508,82 +2593,85 @@ "medium", "high", "xhigh" - ], - "type": "string" + ] }, "SandboxPolicy": { "oneOf": [ { - "properties": { - "type": { - "enum": [ - "dangerFullAccess" - ], - "title": "DangerFullAccessSandboxPolicyType", - "type": "string" - } - }, + "type": "object", "required": [ "type" ], - "title": "DangerFullAccessSandboxPolicy", - "type": "object" + "properties": { + "type": { + "type": "string", + "enum": [ + "dangerFullAccess" + ], + "title": "DangerFullAccessSandboxPolicyType" + } + }, + "title": "DangerFullAccessSandboxPolicy" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "access": { + "default": { + "type": "fullAccess" + }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ], - "default": { - "type": "fullAccess" - } + ] }, "networkAccess": { "default": false, "type": "boolean" }, "type": { + "type": "string", "enum": [ "readOnly" ], - "title": "ReadOnlySandboxPolicyType", - "type": "string" + "title": "ReadOnlySandboxPolicyType" } }, + "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", - "type": "string" + "title": "ExternalSandboxSandboxPolicyType" } }, + "title": "ExternalSandboxSandboxPolicy" + }, + { + "type": "object", "required": [ "type" ], - "title": "ExternalSandboxSandboxPolicy", - "type": "object" - }, - { "properties": { "excludeSlashTmp": { "default": false, @@ -2598,99 +2686,103 @@ "type": "boolean" }, "readOnlyAccess": { + "default": { + "type": "fullAccess" + }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ], - "default": { - "type": "fullAccess" - } + ] }, "type": { + "type": "string", "enum": [ "workspaceWrite" ], - "title": "WorkspaceWriteSandboxPolicyType", - "type": "string" + "title": "WorkspaceWriteSandboxPolicyType" }, "writableRoots": { "default": [], + "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" + } } }, - "required": [ - "type" - ], - "title": "WorkspaceWriteSandboxPolicy", - "type": "object" + "title": "WorkspaceWriteSandboxPolicy" } ] }, "ServiceTier": { + "type": "string", "enum": [ "fast", "flex" - ], - "type": "string" + ] }, "SessionSource": { "oneOf": [ { + "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "custom" + ], "properties": { "custom": { "type": "string" } }, - "required": [ - "custom" - ], - "title": "CustomSessionSource", - "type": "object" + "additionalProperties": false, + "title": "CustomSessionSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "subAgent" + ], "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "required": [ - "subAgent" - ], - "title": "SubAgentSessionSource", - "type": "object" + "additionalProperties": false, + "title": "SubAgentSessionSource" } ] }, "SubAgentSource": { "oneOf": [ { + "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "thread_spawn" + ], "properties": { "thread_spawn": { + "type": "object", + "required": [ + "depth", + "parent_thread_id" + ], "properties": { "agent_nickname": { "default": null, @@ -2700,6 +2792,7 @@ ] }, "agent_path": { + "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2707,8 +2800,7 @@ { "type": "null" } - ], - "default": null + ] }, "agent_role": { "default": null, @@ -2718,50 +2810,46 @@ ] }, "depth": { - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - }, - "required": [ - "depth", - "parent_thread_id" - ], - "type": "object" + } } }, - "required": [ - "thread_spawn" - ], - "title": "ThreadSpawnSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "ThreadSpawnSubAgentSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "other" + ], "properties": { "other": { "type": "string" } }, - "required": [ - "other" - ], - "title": "OtherSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "OtherSubAgentSource" } ] }, "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.", @@ -2770,13 +2858,23 @@ "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.", @@ -2798,22 +2896,23 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "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" @@ -2821,8 +2920,7 @@ { "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.", @@ -2832,6 +2930,7 @@ ] }, "gitInfo": { + "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2839,8 +2938,7 @@ { "type": "null" } - ], - "description": "Optional Git metadata captured when the thread was created." + ] }, "id": { "type": "string" @@ -2868,55 +2966,41 @@ "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.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } - }, - "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" @@ -2924,65 +3008,72 @@ "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -2990,10 +3081,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -3001,30 +3092,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -3033,56 +3123,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -3097,34 +3190,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" @@ -3137,42 +3230,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -3181,32 +3272,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -3247,43 +3340,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -3307,31 +3399,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -3352,6 +3446,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -3359,57 +3454,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -3428,22 +3518,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -3452,22 +3542,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -3495,23 +3586,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -3520,22 +3610,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -3544,137 +3634,138 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "ThreadStatus": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType", - "type": "string" + "title": "NotLoadedThreadStatusType" } }, + "title": "NotLoadedThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "NotLoadedThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType", - "type": "string" + "title": "IdleThreadStatusType" } }, + "title": "IdleThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "IdleThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType", - "type": "string" + "title": "SystemErrorThreadStatusType" } }, - "required": [ - "type" - ], - "title": "SystemErrorThreadStatus", - "type": "object" + "title": "SystemErrorThreadStatus" }, { - "properties": { - "activeFlags": { - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - }, - "type": "array" - }, - "type": { - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType", - "type": "string" - } - }, + "type": "object", "required": [ "activeFlags", "type" ], - "title": "ActiveThreadStatus", - "type": "object" + "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.", - "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" @@ -3682,39 +3773,36 @@ { "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, @@ -3736,92 +3824,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3830,22 +3920,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3854,35 +3944,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -3891,27 +3979,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -3920,13 +4008,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -3935,11 +4023,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -3948,113 +4036,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 d117f3ae..53afb30b 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#", - "properties": { - "items": { - "description": "Raw Responses API items to append to the thread's model-visible history.", - "items": true, - "type": "array" - }, - "threadId": { - "type": "string" - } - }, + "title": "ThreadInjectItemsParams", + "type": "object", "required": [ "items", "threadId" ], - "title": "ThreadInjectItemsParams", - "type": "object" + "properties": { + "items": { + "description": "Raw Responses API items to append to the thread's model-visible history.", + "type": "array", + "items": true + }, + "threadId": { + "type": "string" + } + } } \ 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 789d9b61..46a8683e 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,49 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "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.", @@ -60,6 +18,7 @@ ] }, "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" @@ -67,27 +26,26 @@ { "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.", @@ -97,6 +55,7 @@ ] }, "sortDirection": { + "description": "Optional sort direction; defaults to descending (newest first).", "anyOf": [ { "$ref": "#/definitions/SortDirection" @@ -104,10 +63,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" @@ -115,24 +74,65 @@ { "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" } }, - "title": "ThreadListParams", - "type": "object" + "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" + ] + } + } } \ 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 35905637..22070f9c 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,5 +1,32 @@ { "$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.", @@ -9,28 +36,29 @@ "type": "string" }, "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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", @@ -41,129 +69,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -174,13 +205,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -189,30 +217,36 @@ "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" @@ -224,23 +258,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -252,21 +284,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -284,113 +316,119 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "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" @@ -434,41 +472,42 @@ "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": [ @@ -477,10 +516,10 @@ ] }, "evidence_refs": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "horizon": { "type": "string" @@ -492,10 +531,10 @@ "type": "string" }, "lane_hints": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -504,10 +543,10 @@ "type": "string" }, "source_refs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "type": "array" + } }, "status": { "type": "string" @@ -524,21 +563,14 @@ "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" @@ -553,12 +585,12 @@ "type": "string" }, "unexplained_writes": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "warning": { "type": [ @@ -566,22 +598,21 @@ "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": [ @@ -593,12 +624,12 @@ "type": "string" }, "start_line": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "symbol": { "type": [ @@ -606,19 +637,22 @@ "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" @@ -632,59 +666,57 @@ "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, - "type": "integer" + "minimum": 0.0 }, "open_gap_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "open_question_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -692,20 +724,21 @@ "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": [ @@ -734,59 +767,58 @@ "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" @@ -797,20 +829,21 @@ "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" @@ -839,15 +872,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "purpose", - "title" - ], - "type": "object" + } }, "EpiphanyGraphs": { + "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -856,15 +884,20 @@ "$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" @@ -881,15 +914,16 @@ "status": { "type": "string" } - }, - "required": [ - "description", - "id", - "status" - ], - "type": "object" + } }, "EpiphanyInvestigationCheckpoint": { + "type": "object", + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], "properties": { "captured_at_turn_id": { "type": [ @@ -901,19 +935,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" @@ -928,10 +962,10 @@ ] }, "open_questions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -939,23 +973,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": [ @@ -976,16 +1010,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" @@ -993,32 +1027,29 @@ "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": [ @@ -1033,31 +1064,36 @@ "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" @@ -1066,25 +1102,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" @@ -1095,18 +1131,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "type": "object" + } }, "EpiphanyObjectiveDraftLanePlan": { + "type": "object", "properties": { "body": { "type": [ @@ -1144,39 +1172,45 @@ "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" @@ -1190,16 +1224,17 @@ "summary": { "type": "string" } - }, - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "type": "object" + } }, "EpiphanyPlanningCapture": { + "type": "object", + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], "properties": { "body": { "type": [ @@ -1232,10 +1267,10 @@ "type": "string" }, "tags": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": "string" @@ -1246,23 +1281,20 @@ "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": [ @@ -1292,10 +1324,10 @@ ] }, "unblocks": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "urgency": { "type": [ @@ -1306,20 +1338,19 @@ "value": { "type": "string" } - }, - "required": [ - "rationale", - "value" - ], - "type": "object" + } }, "EpiphanyPlanningSourceRef": { + "type": "object", + "required": [ + "kind" + ], "properties": { "assignees": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "author": { "type": [ @@ -1340,11 +1371,11 @@ ] }, "database_id": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "external_id": { "type": [ @@ -1365,21 +1396,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": [ @@ -1429,37 +1460,34 @@ "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": [ @@ -1467,29 +1495,33 @@ "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" @@ -1501,27 +1533,26 @@ "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": [ @@ -1530,79 +1561,82 @@ ] }, "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": [ @@ -1625,16 +1659,18 @@ "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" @@ -1646,16 +1682,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" @@ -1672,18 +1708,10 @@ "surface": { "type": "string" } - }, - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "type": "object" + } }, "EpiphanyScratchPad": { + "type": "object", "properties": { "hypothesis": { "type": [ @@ -1698,10 +1726,10 @@ ] }, "notes": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1709,10 +1737,15 @@ "null" ] } - }, - "type": "object" + } }, "EpiphanySubgoal": { + "type": "object", + "required": [ + "id", + "status", + "title" + ], "properties": { "id": { "type": "string" @@ -1729,21 +1762,19 @@ "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": [ @@ -1785,10 +1816,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - }, - "type": "array" + } }, "investigation_checkpoint": { "anyOf": [ @@ -1801,10 +1832,10 @@ ] }, "job_bindings": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - }, - "type": "array" + } }, "last_updated_turn_id": { "type": [ @@ -1829,19 +1860,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": [ @@ -1854,15 +1885,15 @@ ] }, "revision": { + "type": "integer", "format": "uint64", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "runtime_links": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - }, - "type": "array" + } }, "scratch": { "anyOf": [ @@ -1875,18 +1906,20 @@ ] }, "subgoals": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - }, - "type": "array" + } } - }, - "required": [ - "revision" - ], - "type": "object" + } }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -1897,15 +1930,10 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "GitInfo": { + "type": "object", "properties": { "branch": { "type": [ @@ -1925,10 +1953,14 @@ "null" ] } - }, - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -1936,78 +1968,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -2015,85 +2049,82 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -2102,23 +2133,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -2126,63 +2154,70 @@ "medium", "high", "xhigh" - ], - "type": "string" + ] }, "SessionSource": { "oneOf": [ { + "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "custom" + ], "properties": { "custom": { "type": "string" } }, - "required": [ - "custom" - ], - "title": "CustomSessionSource", - "type": "object" + "additionalProperties": false, + "title": "CustomSessionSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "subAgent" + ], "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "required": [ - "subAgent" - ], - "title": "SubAgentSessionSource", - "type": "object" + "additionalProperties": false, + "title": "SubAgentSessionSource" } ] }, "SubAgentSource": { "oneOf": [ { + "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "thread_spawn" + ], "properties": { "thread_spawn": { + "type": "object", + "required": [ + "depth", + "parent_thread_id" + ], "properties": { "agent_nickname": { "default": null, @@ -2192,6 +2227,7 @@ ] }, "agent_path": { + "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2199,8 +2235,7 @@ { "type": "null" } - ], - "default": null + ] }, "agent_role": { "default": null, @@ -2210,50 +2245,46 @@ ] }, "depth": { - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - }, - "required": [ - "depth", - "parent_thread_id" - ], - "type": "object" + } } }, - "required": [ - "thread_spawn" - ], - "title": "ThreadSpawnSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "ThreadSpawnSubAgentSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "other" + ], "properties": { "other": { "type": "string" } }, - "required": [ - "other" - ], - "title": "OtherSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "OtherSubAgentSource" } ] }, "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.", @@ -2262,13 +2293,23 @@ "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.", @@ -2290,22 +2331,23 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "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" @@ -2313,8 +2355,7 @@ { "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.", @@ -2324,6 +2365,7 @@ ] }, "gitInfo": { + "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2331,8 +2373,7 @@ { "type": "null" } - ], - "description": "Optional Git metadata captured when the thread was created." + ] }, "id": { "type": "string" @@ -2360,55 +2401,41 @@ "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.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } - }, - "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" @@ -2416,65 +2443,72 @@ "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -2482,10 +2516,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -2493,30 +2527,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -2525,56 +2558,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -2589,34 +2625,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" @@ -2629,42 +2665,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -2673,32 +2707,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -2739,43 +2775,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -2799,31 +2834,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -2844,6 +2881,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -2851,57 +2889,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -2920,22 +2953,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -2944,22 +2977,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -2987,23 +3021,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -3012,22 +3045,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -3036,137 +3069,138 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "ThreadStatus": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType", - "type": "string" + "title": "NotLoadedThreadStatusType" } }, + "title": "NotLoadedThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "NotLoadedThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType", - "type": "string" + "title": "IdleThreadStatusType" } }, + "title": "IdleThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "IdleThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType", - "type": "string" + "title": "SystemErrorThreadStatusType" } }, - "required": [ - "type" - ], - "title": "SystemErrorThreadStatus", - "type": "object" + "title": "SystemErrorThreadStatus" }, { - "properties": { - "activeFlags": { - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - }, - "type": "array" - }, - "type": { - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType", - "type": "string" - } - }, + "type": "object", "required": [ "activeFlags", "type" ], - "title": "ActiveThreadStatus", - "type": "object" + "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.", - "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" @@ -3174,39 +3208,36 @@ { "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, @@ -3228,92 +3259,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3322,22 +3355,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3346,35 +3379,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -3383,27 +3414,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -3412,13 +3443,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -3427,11 +3458,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -3440,56 +3471,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 d10ee7ed..7c4e08c7 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,5 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadLoadedListParams", + "type": "object", "properties": { "cursor": { "description": "Opaque pagination cursor returned by a previous call.", @@ -10,14 +12,12 @@ }, "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 cfd90fb8..7a1bbcde 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,12 +1,17 @@ { "$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.", @@ -15,10 +20,5 @@ "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 c6679568..313a7626 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,7 +1,29 @@ { "$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.", @@ -24,29 +46,7 @@ "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 031f8973..f9bf8580 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,5 +1,15 @@ { "$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.", @@ -9,28 +19,29 @@ "type": "string" }, "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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", @@ -41,129 +52,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -174,13 +188,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -189,30 +200,36 @@ "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" @@ -224,23 +241,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -252,21 +267,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -284,113 +299,119 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "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" @@ -434,41 +455,42 @@ "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": [ @@ -477,10 +499,10 @@ ] }, "evidence_refs": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "horizon": { "type": "string" @@ -492,10 +514,10 @@ "type": "string" }, "lane_hints": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -504,10 +526,10 @@ "type": "string" }, "source_refs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "type": "array" + } }, "status": { "type": "string" @@ -524,21 +546,14 @@ "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" @@ -553,12 +568,12 @@ "type": "string" }, "unexplained_writes": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "warning": { "type": [ @@ -566,22 +581,21 @@ "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": [ @@ -593,12 +607,12 @@ "type": "string" }, "start_line": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "symbol": { "type": [ @@ -606,19 +620,22 @@ "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" @@ -632,59 +649,57 @@ "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, - "type": "integer" + "minimum": 0.0 }, "open_gap_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "open_question_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -692,20 +707,21 @@ "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": [ @@ -734,59 +750,58 @@ "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" @@ -797,20 +812,21 @@ "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" @@ -839,15 +855,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "purpose", - "title" - ], - "type": "object" + } }, "EpiphanyGraphs": { + "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -856,15 +867,20 @@ "$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" @@ -881,15 +897,16 @@ "status": { "type": "string" } - }, - "required": [ - "description", - "id", - "status" - ], - "type": "object" + } }, "EpiphanyInvestigationCheckpoint": { + "type": "object", + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], "properties": { "captured_at_turn_id": { "type": [ @@ -901,19 +918,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" @@ -928,10 +945,10 @@ ] }, "open_questions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -939,23 +956,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": [ @@ -976,16 +993,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" @@ -993,32 +1010,29 @@ "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": [ @@ -1033,31 +1047,36 @@ "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" @@ -1066,25 +1085,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" @@ -1095,18 +1114,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "type": "object" + } }, "EpiphanyObjectiveDraftLanePlan": { + "type": "object", "properties": { "body": { "type": [ @@ -1144,39 +1155,45 @@ "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" @@ -1190,16 +1207,17 @@ "summary": { "type": "string" } - }, - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "type": "object" + } }, "EpiphanyPlanningCapture": { + "type": "object", + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], "properties": { "body": { "type": [ @@ -1232,10 +1250,10 @@ "type": "string" }, "tags": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": "string" @@ -1246,23 +1264,20 @@ "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": [ @@ -1292,10 +1307,10 @@ ] }, "unblocks": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "urgency": { "type": [ @@ -1306,20 +1321,19 @@ "value": { "type": "string" } - }, - "required": [ - "rationale", - "value" - ], - "type": "object" + } }, "EpiphanyPlanningSourceRef": { + "type": "object", + "required": [ + "kind" + ], "properties": { "assignees": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "author": { "type": [ @@ -1340,11 +1354,11 @@ ] }, "database_id": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "external_id": { "type": [ @@ -1365,21 +1379,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": [ @@ -1429,37 +1443,34 @@ "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": [ @@ -1467,29 +1478,33 @@ "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" @@ -1501,27 +1516,26 @@ "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": [ @@ -1530,79 +1544,82 @@ ] }, "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": [ @@ -1625,16 +1642,18 @@ "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" @@ -1646,16 +1665,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" @@ -1672,18 +1691,10 @@ "surface": { "type": "string" } - }, - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "type": "object" + } }, "EpiphanyScratchPad": { + "type": "object", "properties": { "hypothesis": { "type": [ @@ -1698,10 +1709,10 @@ ] }, "notes": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1709,10 +1720,15 @@ "null" ] } - }, - "type": "object" + } }, "EpiphanySubgoal": { + "type": "object", + "required": [ + "id", + "status", + "title" + ], "properties": { "id": { "type": "string" @@ -1729,21 +1745,19 @@ "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": [ @@ -1785,10 +1799,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - }, - "type": "array" + } }, "investigation_checkpoint": { "anyOf": [ @@ -1801,10 +1815,10 @@ ] }, "job_bindings": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - }, - "type": "array" + } }, "last_updated_turn_id": { "type": [ @@ -1829,19 +1843,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": [ @@ -1854,15 +1868,15 @@ ] }, "revision": { + "type": "integer", "format": "uint64", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "runtime_links": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - }, - "type": "array" + } }, "scratch": { "anyOf": [ @@ -1875,18 +1889,20 @@ ] }, "subgoals": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - }, - "type": "array" + } } - }, - "required": [ - "revision" - ], - "type": "object" + } }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -1897,15 +1913,10 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "GitInfo": { + "type": "object", "properties": { "branch": { "type": [ @@ -1925,10 +1936,14 @@ "null" ] } - }, - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -1936,78 +1951,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -2015,85 +2032,82 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -2102,23 +2116,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -2126,63 +2137,70 @@ "medium", "high", "xhigh" - ], - "type": "string" + ] }, "SessionSource": { "oneOf": [ { + "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "custom" + ], "properties": { "custom": { "type": "string" } }, - "required": [ - "custom" - ], - "title": "CustomSessionSource", - "type": "object" + "additionalProperties": false, + "title": "CustomSessionSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "subAgent" + ], "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "required": [ - "subAgent" - ], - "title": "SubAgentSessionSource", - "type": "object" + "additionalProperties": false, + "title": "SubAgentSessionSource" } ] }, "SubAgentSource": { "oneOf": [ { + "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "thread_spawn" + ], "properties": { "thread_spawn": { + "type": "object", + "required": [ + "depth", + "parent_thread_id" + ], "properties": { "agent_nickname": { "default": null, @@ -2192,6 +2210,7 @@ ] }, "agent_path": { + "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2199,8 +2218,7 @@ { "type": "null" } - ], - "default": null + ] }, "agent_role": { "default": null, @@ -2210,50 +2228,46 @@ ] }, "depth": { - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - }, - "required": [ - "depth", - "parent_thread_id" - ], - "type": "object" + } } }, - "required": [ - "thread_spawn" - ], - "title": "ThreadSpawnSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "ThreadSpawnSubAgentSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "other" + ], "properties": { "other": { "type": "string" } }, - "required": [ - "other" - ], - "title": "OtherSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "OtherSubAgentSource" } ] }, "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.", @@ -2262,13 +2276,23 @@ "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.", @@ -2290,22 +2314,23 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "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" @@ -2313,8 +2338,7 @@ { "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.", @@ -2324,6 +2348,7 @@ ] }, "gitInfo": { + "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2331,8 +2356,7 @@ { "type": "null" } - ], - "description": "Optional Git metadata captured when the thread was created." + ] }, "id": { "type": "string" @@ -2360,55 +2384,41 @@ "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.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } - }, - "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" @@ -2416,65 +2426,72 @@ "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -2482,10 +2499,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -2493,30 +2510,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -2525,56 +2541,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -2589,34 +2608,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" @@ -2629,42 +2648,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -2673,32 +2690,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -2739,43 +2758,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -2799,31 +2817,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -2844,6 +2864,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -2851,57 +2872,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -2920,22 +2936,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -2944,22 +2960,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -2987,23 +3004,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -3012,22 +3028,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -3036,137 +3052,138 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "ThreadStatus": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType", - "type": "string" + "title": "NotLoadedThreadStatusType" } }, + "title": "NotLoadedThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "NotLoadedThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType", - "type": "string" + "title": "IdleThreadStatusType" } }, + "title": "IdleThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "IdleThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType", - "type": "string" + "title": "SystemErrorThreadStatusType" } }, - "required": [ - "type" - ], - "title": "SystemErrorThreadStatus", - "type": "object" + "title": "SystemErrorThreadStatus" }, { - "properties": { - "activeFlags": { - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - }, - "type": "array" - }, - "type": { - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType", - "type": "string" - } - }, + "type": "object", "required": [ "activeFlags", "type" ], - "title": "ActiveThreadStatus", - "type": "object" + "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.", - "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" @@ -3174,39 +3191,36 @@ { "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, @@ -3228,92 +3242,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3322,22 +3338,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3346,35 +3362,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -3383,27 +3397,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -3412,13 +3426,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -3427,11 +3441,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -3440,39 +3454,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 8c3b2095..705cd8b0 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,5 +1,10 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadNameUpdatedNotification", + "type": "object", + "required": [ + "threadId" + ], "properties": { "threadId": { "type": "string" @@ -10,10 +15,5 @@ "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 f5e5503c..76ce44a9 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": { - "default": false, "description": "When true, include turns and their items from rollout history.", + "default": false, "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 791bdc4c..590bcbe8 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,5 +1,15 @@ { "$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.", @@ -9,28 +19,29 @@ "type": "string" }, "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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", @@ -41,129 +52,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -174,13 +188,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -189,30 +200,36 @@ "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" @@ -224,23 +241,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -252,21 +267,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -284,113 +299,119 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "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" @@ -434,41 +455,42 @@ "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": [ @@ -477,10 +499,10 @@ ] }, "evidence_refs": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "horizon": { "type": "string" @@ -492,10 +514,10 @@ "type": "string" }, "lane_hints": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -504,10 +526,10 @@ "type": "string" }, "source_refs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "type": "array" + } }, "status": { "type": "string" @@ -524,21 +546,14 @@ "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" @@ -553,12 +568,12 @@ "type": "string" }, "unexplained_writes": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "warning": { "type": [ @@ -566,22 +581,21 @@ "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": [ @@ -593,12 +607,12 @@ "type": "string" }, "start_line": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "symbol": { "type": [ @@ -606,19 +620,22 @@ "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" @@ -632,59 +649,57 @@ "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, - "type": "integer" + "minimum": 0.0 }, "open_gap_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "open_question_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -692,20 +707,21 @@ "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": [ @@ -734,59 +750,58 @@ "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" @@ -797,20 +812,21 @@ "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" @@ -839,15 +855,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "purpose", - "title" - ], - "type": "object" + } }, "EpiphanyGraphs": { + "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -856,15 +867,20 @@ "$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" @@ -881,15 +897,16 @@ "status": { "type": "string" } - }, - "required": [ - "description", - "id", - "status" - ], - "type": "object" + } }, "EpiphanyInvestigationCheckpoint": { + "type": "object", + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], "properties": { "captured_at_turn_id": { "type": [ @@ -901,19 +918,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" @@ -928,10 +945,10 @@ ] }, "open_questions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -939,23 +956,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": [ @@ -976,16 +993,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" @@ -993,32 +1010,29 @@ "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": [ @@ -1033,31 +1047,36 @@ "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" @@ -1066,25 +1085,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" @@ -1095,18 +1114,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "type": "object" + } }, "EpiphanyObjectiveDraftLanePlan": { + "type": "object", "properties": { "body": { "type": [ @@ -1144,39 +1155,45 @@ "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" @@ -1190,16 +1207,17 @@ "summary": { "type": "string" } - }, - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "type": "object" + } }, "EpiphanyPlanningCapture": { + "type": "object", + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], "properties": { "body": { "type": [ @@ -1232,10 +1250,10 @@ "type": "string" }, "tags": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": "string" @@ -1246,23 +1264,20 @@ "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": [ @@ -1292,10 +1307,10 @@ ] }, "unblocks": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "urgency": { "type": [ @@ -1306,20 +1321,19 @@ "value": { "type": "string" } - }, - "required": [ - "rationale", - "value" - ], - "type": "object" + } }, "EpiphanyPlanningSourceRef": { + "type": "object", + "required": [ + "kind" + ], "properties": { "assignees": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "author": { "type": [ @@ -1340,11 +1354,11 @@ ] }, "database_id": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "external_id": { "type": [ @@ -1365,21 +1379,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": [ @@ -1429,37 +1443,34 @@ "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": [ @@ -1467,29 +1478,33 @@ "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" @@ -1501,27 +1516,26 @@ "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": [ @@ -1530,79 +1544,82 @@ ] }, "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": [ @@ -1625,16 +1642,18 @@ "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" @@ -1646,16 +1665,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" @@ -1672,18 +1691,10 @@ "surface": { "type": "string" } - }, - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "type": "object" + } }, "EpiphanyScratchPad": { + "type": "object", "properties": { "hypothesis": { "type": [ @@ -1698,10 +1709,10 @@ ] }, "notes": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1709,10 +1720,15 @@ "null" ] } - }, - "type": "object" + } }, "EpiphanySubgoal": { + "type": "object", + "required": [ + "id", + "status", + "title" + ], "properties": { "id": { "type": "string" @@ -1729,21 +1745,19 @@ "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": [ @@ -1785,10 +1799,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - }, - "type": "array" + } }, "investigation_checkpoint": { "anyOf": [ @@ -1801,10 +1815,10 @@ ] }, "job_bindings": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - }, - "type": "array" + } }, "last_updated_turn_id": { "type": [ @@ -1829,19 +1843,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": [ @@ -1854,15 +1868,15 @@ ] }, "revision": { + "type": "integer", "format": "uint64", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "runtime_links": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - }, - "type": "array" + } }, "scratch": { "anyOf": [ @@ -1875,18 +1889,20 @@ ] }, "subgoals": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - }, - "type": "array" + } } - }, - "required": [ - "revision" - ], - "type": "object" + } }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -1897,15 +1913,10 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "GitInfo": { + "type": "object", "properties": { "branch": { "type": [ @@ -1925,10 +1936,14 @@ "null" ] } - }, - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -1936,78 +1951,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -2015,85 +2032,82 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -2102,23 +2116,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -2126,63 +2137,70 @@ "medium", "high", "xhigh" - ], - "type": "string" + ] }, "SessionSource": { "oneOf": [ { + "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "custom" + ], "properties": { "custom": { "type": "string" } }, - "required": [ - "custom" - ], - "title": "CustomSessionSource", - "type": "object" + "additionalProperties": false, + "title": "CustomSessionSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "subAgent" + ], "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "required": [ - "subAgent" - ], - "title": "SubAgentSessionSource", - "type": "object" + "additionalProperties": false, + "title": "SubAgentSessionSource" } ] }, "SubAgentSource": { "oneOf": [ { + "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "thread_spawn" + ], "properties": { "thread_spawn": { + "type": "object", + "required": [ + "depth", + "parent_thread_id" + ], "properties": { "agent_nickname": { "default": null, @@ -2192,6 +2210,7 @@ ] }, "agent_path": { + "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2199,8 +2218,7 @@ { "type": "null" } - ], - "default": null + ] }, "agent_role": { "default": null, @@ -2210,50 +2228,46 @@ ] }, "depth": { - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - }, - "required": [ - "depth", - "parent_thread_id" - ], - "type": "object" + } } }, - "required": [ - "thread_spawn" - ], - "title": "ThreadSpawnSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "ThreadSpawnSubAgentSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "other" + ], "properties": { "other": { "type": "string" } }, - "required": [ - "other" - ], - "title": "OtherSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "OtherSubAgentSource" } ] }, "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.", @@ -2262,13 +2276,23 @@ "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.", @@ -2290,22 +2314,23 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "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" @@ -2313,8 +2338,7 @@ { "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.", @@ -2324,6 +2348,7 @@ ] }, "gitInfo": { + "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2331,8 +2356,7 @@ { "type": "null" } - ], - "description": "Optional Git metadata captured when the thread was created." + ] }, "id": { "type": "string" @@ -2360,55 +2384,41 @@ "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.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } - }, - "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" @@ -2416,65 +2426,72 @@ "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -2482,10 +2499,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -2493,30 +2510,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -2525,56 +2541,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -2589,34 +2608,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" @@ -2629,42 +2648,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -2673,32 +2690,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -2739,43 +2758,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -2799,31 +2817,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -2844,6 +2864,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -2851,57 +2872,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -2920,22 +2936,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -2944,22 +2960,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -2987,23 +3004,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -3012,22 +3028,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -3036,137 +3052,138 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "ThreadStatus": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType", - "type": "string" + "title": "NotLoadedThreadStatusType" } }, + "title": "NotLoadedThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "NotLoadedThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType", - "type": "string" + "title": "IdleThreadStatusType" } }, + "title": "IdleThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "IdleThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType", - "type": "string" + "title": "SystemErrorThreadStatusType" } }, - "required": [ - "type" - ], - "title": "SystemErrorThreadStatus", - "type": "object" + "title": "SystemErrorThreadStatus" }, { - "properties": { - "activeFlags": { - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - }, - "type": "array" - }, - "type": { - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType", - "type": "string" - } - }, + "type": "object", "required": [ "activeFlags", "type" ], - "title": "ActiveThreadStatus", - "type": "object" + "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.", - "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" @@ -3174,39 +3191,36 @@ { "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, @@ -3228,92 +3242,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3322,22 +3338,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3346,35 +3362,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -3383,27 +3397,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -3412,13 +3426,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -3427,11 +3441,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -3440,39 +3454,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 edfba83b..58276d18 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,6 +1,11 @@ { "$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": [ @@ -11,10 +16,5 @@ "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 e7ec7603..0ddd7d48 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,6 +1,12 @@ { "$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" @@ -8,11 +14,5 @@ "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 06de7e00..00fe35cf 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 6c75f675..5e681f5c 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,8 +1,29 @@ { "$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" @@ -14,45 +35,24 @@ ] }, "numChannels": { + "type": "integer", "format": "uint16", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "sampleRate": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "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 907dc856..94089a9b 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,6 +1,12 @@ { "$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" @@ -8,11 +14,5 @@ "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 dd94a5cc..3fea2c80 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,15 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "RealtimeConversationVersion": { - "enum": [ - "v1", - "v2" - ], - "type": "string" - } - }, + "title": "ThreadRealtimeStartedNotification", "description": "EXPERIMENTAL - emitted when thread realtime startup is accepted.", + "type": "object", + "required": [ + "threadId", + "version" + ], "properties": { "sessionId": { "type": [ @@ -24,10 +21,13 @@ "$ref": "#/definitions/RealtimeConversationVersion" } }, - "required": [ - "threadId", - "version" - ], - "title": "ThreadRealtimeStartedNotification", - "type": "object" + "definitions": { + "RealtimeConversationVersion": { + "type": "string", + "enum": [ + "v1", + "v2" + ] + } + } } \ 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 22ad778e..06629209 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,6 +1,13 @@ { "$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.", @@ -12,12 +19,5 @@ "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 2f4199fd..f19a70a4 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,6 +1,13 @@ { "$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" @@ -12,12 +19,5 @@ "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 7fb27c08..2aa7dada 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,1271 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - }, - "skill_approval": { - "default": false, - "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" - } - }, + "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": [ @@ -1278,6 +18,7 @@ ] }, "approvalsReviewer": { + "description": "Override where approval requests are routed for review on this thread and subsequent turns.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -1285,8 +26,7 @@ { "type": "null" } - ], - "description": "Override where approval requests are routed for review on this thread and subsequent turns." + ] }, "baseInstructions": { "type": [ @@ -1295,11 +35,11 @@ ] }, "config": { - "additionalProperties": true, "type": [ "object", "null" - ] + ], + "additionalProperties": true }, "cwd": { "type": [ @@ -1313,6 +53,9 @@ "null" ] }, + "threadId": { + "type": "string" + }, "model": { "description": "Configuration overrides for the resumed thread, if any.", "type": [ @@ -1326,31 +69,21 @@ "null" ] }, - "permissionProfile": { + "sandbox": { "anyOf": [ { - "$ref": "#/definitions/PermissionProfile" - }, - { - "type": "null" - } - ], - "description": "Full permissions override for the resumed thread. Cannot be combined with `sandbox`." - }, - "personality": { - "anyOf": [ - { - "$ref": "#/definitions/Personality" + "$ref": "#/definitions/SandboxMode" }, { "type": "null" } ] }, - "sandbox": { + "permissionProfile": { + "description": "Full permissions override for the resumed thread. Cannot be combined with `sandbox`.", "anyOf": [ { - "$ref": "#/definitions/SandboxMode" + "$ref": "#/definitions/PermissionProfile" }, { "type": "null" @@ -1374,13 +107,1280 @@ } ] }, - "threadId": { - "type": "string" + "personality": { + "anyOf": [ + { + "$ref": "#/definitions/Personality" + }, + { + "type": "null" + } + ] } }, - "required": [ - "threadId" - ], - "title": "ThreadResumeParams", - "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": { + "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" + }, + "skill_approval": { + "default": false, + "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" + ] + } + } } \ 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 1156b822..d593a198 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,5 +1,89 @@ { "$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.", @@ -10,28 +94,37 @@ }, "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" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "granular" + ], "properties": { "granular": { + "type": "object", + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -50,46 +143,38 @@ "default": false, "type": "boolean" } - }, - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "type": "object" + } } }, - "required": [ - "granular" - ], - "title": "GranularAskForApproval", - "type": "object" + "additionalProperties": false, + "title": "GranularAskForApproval" } ] }, "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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", @@ -100,129 +185,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -233,13 +321,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -248,30 +333,36 @@ "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" @@ -283,23 +374,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -311,21 +400,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -343,113 +432,119 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "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" @@ -493,41 +588,42 @@ "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": [ @@ -536,10 +632,10 @@ ] }, "evidence_refs": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "horizon": { "type": "string" @@ -551,10 +647,10 @@ "type": "string" }, "lane_hints": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -563,10 +659,10 @@ "type": "string" }, "source_refs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "type": "array" + } }, "status": { "type": "string" @@ -583,21 +679,14 @@ "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" @@ -612,12 +701,12 @@ "type": "string" }, "unexplained_writes": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "warning": { "type": [ @@ -625,22 +714,21 @@ "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": [ @@ -652,12 +740,12 @@ "type": "string" }, "start_line": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "symbol": { "type": [ @@ -665,19 +753,22 @@ "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" @@ -691,59 +782,57 @@ "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, - "type": "integer" + "minimum": 0.0 }, "open_gap_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "open_question_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -751,20 +840,21 @@ "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": [ @@ -793,59 +883,58 @@ "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" @@ -856,20 +945,21 @@ "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" @@ -898,15 +988,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "purpose", - "title" - ], - "type": "object" + } }, "EpiphanyGraphs": { + "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -915,15 +1000,20 @@ "$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" @@ -940,15 +1030,16 @@ "status": { "type": "string" } - }, - "required": [ - "description", - "id", - "status" - ], - "type": "object" + } }, "EpiphanyInvestigationCheckpoint": { + "type": "object", + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], "properties": { "captured_at_turn_id": { "type": [ @@ -960,19 +1051,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" @@ -987,10 +1078,10 @@ ] }, "open_questions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -998,23 +1089,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": [ @@ -1035,16 +1126,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" @@ -1052,32 +1143,29 @@ "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": [ @@ -1092,31 +1180,36 @@ "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" @@ -1125,25 +1218,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" @@ -1154,18 +1247,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "type": "object" + } }, "EpiphanyObjectiveDraftLanePlan": { + "type": "object", "properties": { "body": { "type": [ @@ -1203,39 +1288,45 @@ "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" @@ -1249,16 +1340,17 @@ "summary": { "type": "string" } - }, - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "type": "object" + } }, "EpiphanyPlanningCapture": { + "type": "object", + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], "properties": { "body": { "type": [ @@ -1291,10 +1383,10 @@ "type": "string" }, "tags": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": "string" @@ -1305,23 +1397,20 @@ "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": [ @@ -1351,10 +1440,10 @@ ] }, "unblocks": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "urgency": { "type": [ @@ -1365,20 +1454,19 @@ "value": { "type": "string" } - }, - "required": [ - "rationale", - "value" - ], - "type": "object" + } }, "EpiphanyPlanningSourceRef": { + "type": "object", + "required": [ + "kind" + ], "properties": { "assignees": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "author": { "type": [ @@ -1399,11 +1487,11 @@ ] }, "database_id": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "external_id": { "type": [ @@ -1424,21 +1512,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": [ @@ -1488,37 +1576,34 @@ "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": [ @@ -1526,29 +1611,33 @@ "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" @@ -1560,27 +1649,26 @@ "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": [ @@ -1589,79 +1677,82 @@ ] }, "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": [ @@ -1684,16 +1775,18 @@ "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" @@ -1705,16 +1798,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" @@ -1731,18 +1824,10 @@ "surface": { "type": "string" } - }, - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "type": "object" + } }, "EpiphanyScratchPad": { + "type": "object", "properties": { "hypothesis": { "type": [ @@ -1757,10 +1842,10 @@ ] }, "notes": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1768,10 +1853,15 @@ "null" ] } - }, - "type": "object" + } }, "EpiphanySubgoal": { + "type": "object", + "required": [ + "id", + "status", + "title" + ], "properties": { "id": { "type": "string" @@ -1788,21 +1878,19 @@ "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": [ @@ -1844,10 +1932,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - }, - "type": "array" + } }, "investigation_checkpoint": { "anyOf": [ @@ -1860,10 +1948,10 @@ ] }, "job_bindings": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - }, - "type": "array" + } }, "last_updated_turn_id": { "type": [ @@ -1888,19 +1976,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": [ @@ -1913,15 +2001,15 @@ ] }, "revision": { + "type": "integer", "format": "uint64", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "runtime_links": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - }, - "type": "array" + } }, "scratch": { "anyOf": [ @@ -1934,90 +2022,91 @@ ] }, "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", - "type": "string" + "title": "PathFileSystemPathType" } }, - "required": [ - "path", - "type" - ], - "title": "PathFileSystemPath", - "type": "object" + "title": "PathFileSystemPath" }, { + "type": "object", + "required": [ + "pattern", + "type" + ], "properties": { "pattern": { "type": "string" }, "type": { + "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType", - "type": "string" + "title": "GlobPatternFileSystemPathType" } }, - "required": [ - "pattern", - "type" - ], - "title": "GlobPatternFileSystemPath", - "type": "object" + "title": "GlobPatternFileSystemPath" }, { + "type": "object", + "required": [ + "type", + "value" + ], "properties": { "type": { + "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType", - "type": "string" + "title": "SpecialFileSystemPathType" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "required": [ - "type", - "value" - ], - "title": "SpecialFileSystemPath", - "type": "object" + "title": "SpecialFileSystemPath" } ] }, "FileSystemSandboxEntry": { + "type": "object", + "required": [ + "access", + "path" + ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -2025,67 +2114,66 @@ "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": [ @@ -2094,49 +2182,50 @@ ] } }, + "title": "KindFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "KindFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "tmpdir" - ], - "type": "string" + ] } }, + "title": "TmpdirFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "TmpdirFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "slash_tmp" - ], - "type": "string" + ] } }, - "required": [ - "kind" - ], - "title": "SlashTmpFileSystemSpecialPath", - "type": "object" + "title": "SlashTmpFileSystemSpecialPath" }, { + "type": "object", + "required": [ + "kind", + "path" + ], "properties": { "kind": { + "type": "string", "enum": [ "unknown" - ], - "type": "string" + ] }, "path": { "type": "string" @@ -2147,16 +2236,17 @@ "null" ] } - }, - "required": [ - "kind", - "path" - ], - "type": "object" + } } ] }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -2167,15 +2257,10 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "GitInfo": { + "type": "object", "properties": { "branch": { "type": [ @@ -2195,10 +2280,14 @@ "null" ] } - }, - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -2206,78 +2295,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -2285,92 +2376,89 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -2379,22 +2467,19 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "PermissionProfile": { + "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -2416,32 +2501,32 @@ } ] } - }, - "type": "object" + } }, "PermissionProfileFileSystemPermissions": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - }, - "type": "array" - }, - "globScanMaxDepth": { - "format": "uint", - "minimum": 1.0, - "type": [ - "integer", - "null" - ] - } - }, + "type": "object", "required": [ "entries" ], - "type": "object" + "properties": { + "entries": { + "type": "array", + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + } + }, + "globScanMaxDepth": { + "type": [ + "integer", + "null" + ], + "format": "uint", + "minimum": 1.0 + } + } }, "PermissionProfileNetworkPermissions": { + "type": "object", "properties": { "enabled": { "type": [ @@ -2449,12 +2534,15 @@ "null" ] } - }, - "type": "object" + } }, "ReadOnlyAccess": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "includePlatformDefaults": { "default": true, @@ -2462,45 +2550,42 @@ }, "readableRoots": { "default": [], + "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "restricted" ], - "title": "RestrictedReadOnlyAccessType", - "type": "string" + "title": "RestrictedReadOnlyAccessType" } }, + "title": "RestrictedReadOnlyAccess" + }, + { + "type": "object", "required": [ "type" ], - "title": "RestrictedReadOnlyAccess", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "fullAccess" ], - "title": "FullAccessReadOnlyAccessType", - "type": "string" + "title": "FullAccessReadOnlyAccessType" } }, - "required": [ - "type" - ], - "title": "FullAccessReadOnlyAccess", - "type": "object" + "title": "FullAccessReadOnlyAccess" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -2508,82 +2593,85 @@ "medium", "high", "xhigh" - ], - "type": "string" + ] }, "SandboxPolicy": { "oneOf": [ { - "properties": { - "type": { - "enum": [ - "dangerFullAccess" - ], - "title": "DangerFullAccessSandboxPolicyType", - "type": "string" - } - }, + "type": "object", "required": [ "type" ], - "title": "DangerFullAccessSandboxPolicy", - "type": "object" + "properties": { + "type": { + "type": "string", + "enum": [ + "dangerFullAccess" + ], + "title": "DangerFullAccessSandboxPolicyType" + } + }, + "title": "DangerFullAccessSandboxPolicy" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "access": { + "default": { + "type": "fullAccess" + }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ], - "default": { - "type": "fullAccess" - } + ] }, "networkAccess": { "default": false, "type": "boolean" }, "type": { + "type": "string", "enum": [ "readOnly" ], - "title": "ReadOnlySandboxPolicyType", - "type": "string" + "title": "ReadOnlySandboxPolicyType" } }, + "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", - "type": "string" + "title": "ExternalSandboxSandboxPolicyType" } }, + "title": "ExternalSandboxSandboxPolicy" + }, + { + "type": "object", "required": [ "type" ], - "title": "ExternalSandboxSandboxPolicy", - "type": "object" - }, - { "properties": { "excludeSlashTmp": { "default": false, @@ -2598,99 +2686,103 @@ "type": "boolean" }, "readOnlyAccess": { + "default": { + "type": "fullAccess" + }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ], - "default": { - "type": "fullAccess" - } + ] }, "type": { + "type": "string", "enum": [ "workspaceWrite" ], - "title": "WorkspaceWriteSandboxPolicyType", - "type": "string" + "title": "WorkspaceWriteSandboxPolicyType" }, "writableRoots": { "default": [], + "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" + } } }, - "required": [ - "type" - ], - "title": "WorkspaceWriteSandboxPolicy", - "type": "object" + "title": "WorkspaceWriteSandboxPolicy" } ] }, "ServiceTier": { + "type": "string", "enum": [ "fast", "flex" - ], - "type": "string" + ] }, "SessionSource": { "oneOf": [ { + "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "custom" + ], "properties": { "custom": { "type": "string" } }, - "required": [ - "custom" - ], - "title": "CustomSessionSource", - "type": "object" + "additionalProperties": false, + "title": "CustomSessionSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "subAgent" + ], "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "required": [ - "subAgent" - ], - "title": "SubAgentSessionSource", - "type": "object" + "additionalProperties": false, + "title": "SubAgentSessionSource" } ] }, "SubAgentSource": { "oneOf": [ { + "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "thread_spawn" + ], "properties": { "thread_spawn": { + "type": "object", + "required": [ + "depth", + "parent_thread_id" + ], "properties": { "agent_nickname": { "default": null, @@ -2700,6 +2792,7 @@ ] }, "agent_path": { + "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2707,8 +2800,7 @@ { "type": "null" } - ], - "default": null + ] }, "agent_role": { "default": null, @@ -2718,50 +2810,46 @@ ] }, "depth": { - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - }, - "required": [ - "depth", - "parent_thread_id" - ], - "type": "object" + } } }, - "required": [ - "thread_spawn" - ], - "title": "ThreadSpawnSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "ThreadSpawnSubAgentSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "other" + ], "properties": { "other": { "type": "string" } }, - "required": [ - "other" - ], - "title": "OtherSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "OtherSubAgentSource" } ] }, "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.", @@ -2770,13 +2858,23 @@ "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.", @@ -2798,22 +2896,23 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "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" @@ -2821,8 +2920,7 @@ { "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.", @@ -2832,6 +2930,7 @@ ] }, "gitInfo": { + "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2839,8 +2938,7 @@ { "type": "null" } - ], - "description": "Optional Git metadata captured when the thread was created." + ] }, "id": { "type": "string" @@ -2868,55 +2966,41 @@ "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.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } - }, - "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" @@ -2924,65 +3008,72 @@ "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -2990,10 +3081,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -3001,30 +3092,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -3033,56 +3123,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -3097,34 +3190,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" @@ -3137,42 +3230,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -3181,32 +3272,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -3247,43 +3340,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -3307,31 +3399,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -3352,6 +3446,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -3359,57 +3454,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -3428,22 +3518,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -3452,22 +3542,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -3495,23 +3586,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -3520,22 +3610,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -3544,137 +3634,138 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "ThreadStatus": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType", - "type": "string" + "title": "NotLoadedThreadStatusType" } }, + "title": "NotLoadedThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "NotLoadedThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType", - "type": "string" + "title": "IdleThreadStatusType" } }, + "title": "IdleThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "IdleThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType", - "type": "string" + "title": "SystemErrorThreadStatusType" } }, - "required": [ - "type" - ], - "title": "SystemErrorThreadStatus", - "type": "object" + "title": "SystemErrorThreadStatus" }, { - "properties": { - "activeFlags": { - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - }, - "type": "array" - }, - "type": { - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType", - "type": "string" - } - }, + "type": "object", "required": [ "activeFlags", "type" ], - "title": "ActiveThreadStatus", - "type": "object" + "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.", - "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" @@ -3682,39 +3773,36 @@ { "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, @@ -3736,92 +3824,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3830,22 +3920,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3854,35 +3944,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -3891,27 +3979,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -3920,13 +4008,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -3935,11 +4023,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -3948,113 +4036,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 cb3ba0db..bc91ce46 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#", - "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" - } - }, + "title": "ThreadRollbackParams", + "type": "object", "required": [ "numTurns", "threadId" ], - "title": "ThreadRollbackParams", - "type": "object" + "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" + } + } } \ 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 4104b77b..829a9f23 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,5 +1,20 @@ { "$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.", @@ -9,28 +24,29 @@ "type": "string" }, "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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", @@ -41,129 +57,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -174,13 +193,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -189,30 +205,36 @@ "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" @@ -224,23 +246,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -252,21 +272,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -284,113 +304,119 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "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" @@ -434,41 +460,42 @@ "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": [ @@ -477,10 +504,10 @@ ] }, "evidence_refs": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "horizon": { "type": "string" @@ -492,10 +519,10 @@ "type": "string" }, "lane_hints": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -504,10 +531,10 @@ "type": "string" }, "source_refs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "type": "array" + } }, "status": { "type": "string" @@ -524,21 +551,14 @@ "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" @@ -553,12 +573,12 @@ "type": "string" }, "unexplained_writes": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "warning": { "type": [ @@ -566,22 +586,21 @@ "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": [ @@ -593,12 +612,12 @@ "type": "string" }, "start_line": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "symbol": { "type": [ @@ -606,19 +625,22 @@ "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" @@ -632,59 +654,57 @@ "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, - "type": "integer" + "minimum": 0.0 }, "open_gap_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "open_question_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -692,20 +712,21 @@ "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": [ @@ -734,59 +755,58 @@ "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" @@ -797,20 +817,21 @@ "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" @@ -839,15 +860,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "purpose", - "title" - ], - "type": "object" + } }, "EpiphanyGraphs": { + "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -856,15 +872,20 @@ "$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" @@ -881,15 +902,16 @@ "status": { "type": "string" } - }, - "required": [ - "description", - "id", - "status" - ], - "type": "object" + } }, "EpiphanyInvestigationCheckpoint": { + "type": "object", + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], "properties": { "captured_at_turn_id": { "type": [ @@ -901,19 +923,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" @@ -928,10 +950,10 @@ ] }, "open_questions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -939,23 +961,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": [ @@ -976,16 +998,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" @@ -993,32 +1015,29 @@ "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": [ @@ -1033,31 +1052,36 @@ "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" @@ -1066,25 +1090,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" @@ -1095,18 +1119,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "type": "object" + } }, "EpiphanyObjectiveDraftLanePlan": { + "type": "object", "properties": { "body": { "type": [ @@ -1144,39 +1160,45 @@ "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" @@ -1190,16 +1212,17 @@ "summary": { "type": "string" } - }, - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "type": "object" + } }, "EpiphanyPlanningCapture": { + "type": "object", + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], "properties": { "body": { "type": [ @@ -1232,10 +1255,10 @@ "type": "string" }, "tags": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": "string" @@ -1246,23 +1269,20 @@ "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": [ @@ -1292,10 +1312,10 @@ ] }, "unblocks": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "urgency": { "type": [ @@ -1306,20 +1326,19 @@ "value": { "type": "string" } - }, - "required": [ - "rationale", - "value" - ], - "type": "object" + } }, "EpiphanyPlanningSourceRef": { + "type": "object", + "required": [ + "kind" + ], "properties": { "assignees": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "author": { "type": [ @@ -1340,11 +1359,11 @@ ] }, "database_id": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "external_id": { "type": [ @@ -1365,21 +1384,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": [ @@ -1429,37 +1448,34 @@ "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": [ @@ -1467,29 +1483,33 @@ "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" @@ -1501,27 +1521,26 @@ "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": [ @@ -1530,79 +1549,82 @@ ] }, "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": [ @@ -1625,16 +1647,18 @@ "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" @@ -1646,16 +1670,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" @@ -1672,18 +1696,10 @@ "surface": { "type": "string" } - }, - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "type": "object" + } }, "EpiphanyScratchPad": { + "type": "object", "properties": { "hypothesis": { "type": [ @@ -1698,10 +1714,10 @@ ] }, "notes": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1709,10 +1725,15 @@ "null" ] } - }, - "type": "object" + } }, "EpiphanySubgoal": { + "type": "object", + "required": [ + "id", + "status", + "title" + ], "properties": { "id": { "type": "string" @@ -1729,21 +1750,19 @@ "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": [ @@ -1785,10 +1804,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - }, - "type": "array" + } }, "investigation_checkpoint": { "anyOf": [ @@ -1801,10 +1820,10 @@ ] }, "job_bindings": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - }, - "type": "array" + } }, "last_updated_turn_id": { "type": [ @@ -1829,19 +1848,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": [ @@ -1854,15 +1873,15 @@ ] }, "revision": { + "type": "integer", "format": "uint64", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "runtime_links": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - }, - "type": "array" + } }, "scratch": { "anyOf": [ @@ -1875,18 +1894,20 @@ ] }, "subgoals": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - }, - "type": "array" + } } - }, - "required": [ - "revision" - ], - "type": "object" + } }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -1897,15 +1918,10 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "GitInfo": { + "type": "object", "properties": { "branch": { "type": [ @@ -1925,10 +1941,14 @@ "null" ] } - }, - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -1936,78 +1956,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -2015,85 +2037,82 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -2102,23 +2121,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -2126,63 +2142,70 @@ "medium", "high", "xhigh" - ], - "type": "string" + ] }, "SessionSource": { "oneOf": [ { + "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "custom" + ], "properties": { "custom": { "type": "string" } }, - "required": [ - "custom" - ], - "title": "CustomSessionSource", - "type": "object" + "additionalProperties": false, + "title": "CustomSessionSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "subAgent" + ], "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "required": [ - "subAgent" - ], - "title": "SubAgentSessionSource", - "type": "object" + "additionalProperties": false, + "title": "SubAgentSessionSource" } ] }, "SubAgentSource": { "oneOf": [ { + "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "thread_spawn" + ], "properties": { "thread_spawn": { + "type": "object", + "required": [ + "depth", + "parent_thread_id" + ], "properties": { "agent_nickname": { "default": null, @@ -2192,6 +2215,7 @@ ] }, "agent_path": { + "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2199,8 +2223,7 @@ { "type": "null" } - ], - "default": null + ] }, "agent_role": { "default": null, @@ -2210,50 +2233,46 @@ ] }, "depth": { - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - }, - "required": [ - "depth", - "parent_thread_id" - ], - "type": "object" + } } }, - "required": [ - "thread_spawn" - ], - "title": "ThreadSpawnSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "ThreadSpawnSubAgentSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "other" + ], "properties": { "other": { "type": "string" } }, - "required": [ - "other" - ], - "title": "OtherSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "OtherSubAgentSource" } ] }, "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.", @@ -2262,13 +2281,23 @@ "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.", @@ -2290,22 +2319,23 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "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" @@ -2313,8 +2343,7 @@ { "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.", @@ -2324,6 +2353,7 @@ ] }, "gitInfo": { + "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2331,8 +2361,7 @@ { "type": "null" } - ], - "description": "Optional Git metadata captured when the thread was created." + ] }, "id": { "type": "string" @@ -2360,55 +2389,41 @@ "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.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } - }, - "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" @@ -2416,65 +2431,72 @@ "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -2482,10 +2504,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -2493,30 +2515,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -2525,56 +2546,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -2589,34 +2613,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" @@ -2629,42 +2653,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -2673,32 +2695,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -2739,43 +2763,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -2799,31 +2822,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -2844,6 +2869,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -2851,57 +2877,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -2920,22 +2941,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -2944,22 +2965,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -2987,23 +3009,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -3012,22 +3033,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -3036,137 +3057,138 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "ThreadStatus": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType", - "type": "string" + "title": "NotLoadedThreadStatusType" } }, + "title": "NotLoadedThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "NotLoadedThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType", - "type": "string" + "title": "IdleThreadStatusType" } }, + "title": "IdleThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "IdleThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType", - "type": "string" + "title": "SystemErrorThreadStatusType" } }, - "required": [ - "type" - ], - "title": "SystemErrorThreadStatus", - "type": "object" + "title": "SystemErrorThreadStatus" }, { - "properties": { - "activeFlags": { - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - }, - "type": "array" - }, - "type": { - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType", - "type": "string" - } - }, + "type": "object", "required": [ "activeFlags", "type" ], - "title": "ActiveThreadStatus", - "type": "object" + "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.", - "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" @@ -3174,39 +3196,36 @@ { "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, @@ -3228,92 +3247,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3322,22 +3343,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3346,35 +3367,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -3383,27 +3402,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -3412,13 +3431,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -3427,11 +3446,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -3440,44 +3459,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 9381c7cb..3c701359 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,5 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "ThreadSetNameParams", + "type": "object", + "required": [ + "name", + "threadId" + ], "properties": { "name": { "type": "string" @@ -7,11 +13,5 @@ "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 13ef468a..8965b045 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,5 +1,11 @@ { "$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.", @@ -8,11 +14,5 @@ "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 0c5f2176..b6ee92d3 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,395 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - }, - "skill_approval": { - "default": false, - "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" - } - }, + "title": "ThreadStartParams", + "type": "object", "properties": { "approvalPolicy": { "anyOf": [ @@ -402,6 +14,7 @@ ] }, "approvalsReviewer": { + "description": "Override where approval requests are routed for review on this thread and subsequent turns.", "anyOf": [ { "$ref": "#/definitions/ApprovalsReviewer" @@ -409,8 +22,7 @@ { "type": "null" } - ], - "description": "Override where approval requests are routed for review on this thread and subsequent turns." + ] }, "baseInstructions": { "type": [ @@ -419,11 +31,11 @@ ] }, "config": { - "additionalProperties": true, "type": [ "object", "null" - ] + ], + "additionalProperties": true }, "cwd": { "type": [ @@ -437,61 +49,6 @@ "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": [ { @@ -509,6 +66,22 @@ } ] }, + "ephemeral": { + "type": [ + "boolean", + "null" + ] + }, + "sandbox": { + "anyOf": [ + { + "$ref": "#/definitions/SandboxMode" + }, + { + "type": "null" + } + ] + }, "sessionStartSource": { "anyOf": [ { @@ -518,8 +91,435 @@ "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" + } + ] } }, - "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.", + "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" + }, + "skill_approval": { + "default": false, + "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" + ] + } + } } \ 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 76b4f218..11e511a3 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,5 +1,89 @@ { "$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.", @@ -10,28 +94,37 @@ }, "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" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "granular" + ], "properties": { "granular": { + "type": "object", + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -50,46 +143,38 @@ "default": false, "type": "boolean" } - }, - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "type": "object" + } } }, - "required": [ - "granular" - ], - "title": "GranularAskForApproval", - "type": "object" + "additionalProperties": false, + "title": "GranularAskForApproval" } ] }, "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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", @@ -100,129 +185,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -233,13 +321,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -248,30 +333,36 @@ "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" @@ -283,23 +374,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -311,21 +400,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -343,113 +432,119 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "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" @@ -493,41 +588,42 @@ "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": [ @@ -536,10 +632,10 @@ ] }, "evidence_refs": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "horizon": { "type": "string" @@ -551,10 +647,10 @@ "type": "string" }, "lane_hints": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -563,10 +659,10 @@ "type": "string" }, "source_refs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "type": "array" + } }, "status": { "type": "string" @@ -583,21 +679,14 @@ "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" @@ -612,12 +701,12 @@ "type": "string" }, "unexplained_writes": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "warning": { "type": [ @@ -625,22 +714,21 @@ "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": [ @@ -652,12 +740,12 @@ "type": "string" }, "start_line": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "symbol": { "type": [ @@ -665,19 +753,22 @@ "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" @@ -691,59 +782,57 @@ "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, - "type": "integer" + "minimum": 0.0 }, "open_gap_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "open_question_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -751,20 +840,21 @@ "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": [ @@ -793,59 +883,58 @@ "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" @@ -856,20 +945,21 @@ "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" @@ -898,15 +988,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "purpose", - "title" - ], - "type": "object" + } }, "EpiphanyGraphs": { + "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -915,15 +1000,20 @@ "$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" @@ -940,15 +1030,16 @@ "status": { "type": "string" } - }, - "required": [ - "description", - "id", - "status" - ], - "type": "object" + } }, "EpiphanyInvestigationCheckpoint": { + "type": "object", + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], "properties": { "captured_at_turn_id": { "type": [ @@ -960,19 +1051,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" @@ -987,10 +1078,10 @@ ] }, "open_questions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -998,23 +1089,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": [ @@ -1035,16 +1126,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" @@ -1052,32 +1143,29 @@ "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": [ @@ -1092,31 +1180,36 @@ "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" @@ -1125,25 +1218,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" @@ -1154,18 +1247,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "type": "object" + } }, "EpiphanyObjectiveDraftLanePlan": { + "type": "object", "properties": { "body": { "type": [ @@ -1203,39 +1288,45 @@ "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" @@ -1249,16 +1340,17 @@ "summary": { "type": "string" } - }, - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "type": "object" + } }, "EpiphanyPlanningCapture": { + "type": "object", + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], "properties": { "body": { "type": [ @@ -1291,10 +1383,10 @@ "type": "string" }, "tags": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": "string" @@ -1305,23 +1397,20 @@ "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": [ @@ -1351,10 +1440,10 @@ ] }, "unblocks": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "urgency": { "type": [ @@ -1365,20 +1454,19 @@ "value": { "type": "string" } - }, - "required": [ - "rationale", - "value" - ], - "type": "object" + } }, "EpiphanyPlanningSourceRef": { + "type": "object", + "required": [ + "kind" + ], "properties": { "assignees": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "author": { "type": [ @@ -1399,11 +1487,11 @@ ] }, "database_id": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "external_id": { "type": [ @@ -1424,21 +1512,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": [ @@ -1488,37 +1576,34 @@ "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": [ @@ -1526,29 +1611,33 @@ "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" @@ -1560,27 +1649,26 @@ "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": [ @@ -1589,79 +1677,82 @@ ] }, "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": [ @@ -1684,16 +1775,18 @@ "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" @@ -1705,16 +1798,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" @@ -1731,18 +1824,10 @@ "surface": { "type": "string" } - }, - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "type": "object" + } }, "EpiphanyScratchPad": { + "type": "object", "properties": { "hypothesis": { "type": [ @@ -1757,10 +1842,10 @@ ] }, "notes": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1768,10 +1853,15 @@ "null" ] } - }, - "type": "object" + } }, "EpiphanySubgoal": { + "type": "object", + "required": [ + "id", + "status", + "title" + ], "properties": { "id": { "type": "string" @@ -1788,21 +1878,19 @@ "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": [ @@ -1844,10 +1932,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - }, - "type": "array" + } }, "investigation_checkpoint": { "anyOf": [ @@ -1860,10 +1948,10 @@ ] }, "job_bindings": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - }, - "type": "array" + } }, "last_updated_turn_id": { "type": [ @@ -1888,19 +1976,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": [ @@ -1913,15 +2001,15 @@ ] }, "revision": { + "type": "integer", "format": "uint64", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "runtime_links": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - }, - "type": "array" + } }, "scratch": { "anyOf": [ @@ -1934,90 +2022,91 @@ ] }, "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", - "type": "string" + "title": "PathFileSystemPathType" } }, - "required": [ - "path", - "type" - ], - "title": "PathFileSystemPath", - "type": "object" + "title": "PathFileSystemPath" }, { + "type": "object", + "required": [ + "pattern", + "type" + ], "properties": { "pattern": { "type": "string" }, "type": { + "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType", - "type": "string" + "title": "GlobPatternFileSystemPathType" } }, - "required": [ - "pattern", - "type" - ], - "title": "GlobPatternFileSystemPath", - "type": "object" + "title": "GlobPatternFileSystemPath" }, { + "type": "object", + "required": [ + "type", + "value" + ], "properties": { "type": { + "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType", - "type": "string" + "title": "SpecialFileSystemPathType" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "required": [ - "type", - "value" - ], - "title": "SpecialFileSystemPath", - "type": "object" + "title": "SpecialFileSystemPath" } ] }, "FileSystemSandboxEntry": { + "type": "object", + "required": [ + "access", + "path" + ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -2025,67 +2114,66 @@ "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": [ @@ -2094,49 +2182,50 @@ ] } }, + "title": "KindFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "KindFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "tmpdir" - ], - "type": "string" + ] } }, + "title": "TmpdirFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "TmpdirFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "slash_tmp" - ], - "type": "string" + ] } }, - "required": [ - "kind" - ], - "title": "SlashTmpFileSystemSpecialPath", - "type": "object" + "title": "SlashTmpFileSystemSpecialPath" }, { + "type": "object", + "required": [ + "kind", + "path" + ], "properties": { "kind": { + "type": "string", "enum": [ "unknown" - ], - "type": "string" + ] }, "path": { "type": "string" @@ -2147,16 +2236,17 @@ "null" ] } - }, - "required": [ - "kind", - "path" - ], - "type": "object" + } } ] }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -2167,15 +2257,10 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "GitInfo": { + "type": "object", "properties": { "branch": { "type": [ @@ -2195,10 +2280,14 @@ "null" ] } - }, - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -2206,78 +2295,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -2285,92 +2376,89 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -2379,22 +2467,19 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "PermissionProfile": { + "type": "object", "properties": { "fileSystem": { "anyOf": [ @@ -2416,32 +2501,32 @@ } ] } - }, - "type": "object" + } }, "PermissionProfileFileSystemPermissions": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - }, - "type": "array" - }, - "globScanMaxDepth": { - "format": "uint", - "minimum": 1.0, - "type": [ - "integer", - "null" - ] - } - }, + "type": "object", "required": [ "entries" ], - "type": "object" + "properties": { + "entries": { + "type": "array", + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + } + }, + "globScanMaxDepth": { + "type": [ + "integer", + "null" + ], + "format": "uint", + "minimum": 1.0 + } + } }, "PermissionProfileNetworkPermissions": { + "type": "object", "properties": { "enabled": { "type": [ @@ -2449,12 +2534,15 @@ "null" ] } - }, - "type": "object" + } }, "ReadOnlyAccess": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "includePlatformDefaults": { "default": true, @@ -2462,45 +2550,42 @@ }, "readableRoots": { "default": [], + "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "restricted" ], - "title": "RestrictedReadOnlyAccessType", - "type": "string" + "title": "RestrictedReadOnlyAccessType" } }, + "title": "RestrictedReadOnlyAccess" + }, + { + "type": "object", "required": [ "type" ], - "title": "RestrictedReadOnlyAccess", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "fullAccess" ], - "title": "FullAccessReadOnlyAccessType", - "type": "string" + "title": "FullAccessReadOnlyAccessType" } }, - "required": [ - "type" - ], - "title": "FullAccessReadOnlyAccess", - "type": "object" + "title": "FullAccessReadOnlyAccess" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -2508,82 +2593,85 @@ "medium", "high", "xhigh" - ], - "type": "string" + ] }, "SandboxPolicy": { "oneOf": [ { - "properties": { - "type": { - "enum": [ - "dangerFullAccess" - ], - "title": "DangerFullAccessSandboxPolicyType", - "type": "string" - } - }, + "type": "object", "required": [ "type" ], - "title": "DangerFullAccessSandboxPolicy", - "type": "object" + "properties": { + "type": { + "type": "string", + "enum": [ + "dangerFullAccess" + ], + "title": "DangerFullAccessSandboxPolicyType" + } + }, + "title": "DangerFullAccessSandboxPolicy" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "access": { + "default": { + "type": "fullAccess" + }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ], - "default": { - "type": "fullAccess" - } + ] }, "networkAccess": { "default": false, "type": "boolean" }, "type": { + "type": "string", "enum": [ "readOnly" ], - "title": "ReadOnlySandboxPolicyType", - "type": "string" + "title": "ReadOnlySandboxPolicyType" } }, + "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", - "type": "string" + "title": "ExternalSandboxSandboxPolicyType" } }, + "title": "ExternalSandboxSandboxPolicy" + }, + { + "type": "object", "required": [ "type" ], - "title": "ExternalSandboxSandboxPolicy", - "type": "object" - }, - { "properties": { "excludeSlashTmp": { "default": false, @@ -2598,99 +2686,103 @@ "type": "boolean" }, "readOnlyAccess": { + "default": { + "type": "fullAccess" + }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ], - "default": { - "type": "fullAccess" - } + ] }, "type": { + "type": "string", "enum": [ "workspaceWrite" ], - "title": "WorkspaceWriteSandboxPolicyType", - "type": "string" + "title": "WorkspaceWriteSandboxPolicyType" }, "writableRoots": { "default": [], + "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" + } } }, - "required": [ - "type" - ], - "title": "WorkspaceWriteSandboxPolicy", - "type": "object" + "title": "WorkspaceWriteSandboxPolicy" } ] }, "ServiceTier": { + "type": "string", "enum": [ "fast", "flex" - ], - "type": "string" + ] }, "SessionSource": { "oneOf": [ { + "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "custom" + ], "properties": { "custom": { "type": "string" } }, - "required": [ - "custom" - ], - "title": "CustomSessionSource", - "type": "object" + "additionalProperties": false, + "title": "CustomSessionSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "subAgent" + ], "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "required": [ - "subAgent" - ], - "title": "SubAgentSessionSource", - "type": "object" + "additionalProperties": false, + "title": "SubAgentSessionSource" } ] }, "SubAgentSource": { "oneOf": [ { + "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "thread_spawn" + ], "properties": { "thread_spawn": { + "type": "object", + "required": [ + "depth", + "parent_thread_id" + ], "properties": { "agent_nickname": { "default": null, @@ -2700,6 +2792,7 @@ ] }, "agent_path": { + "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2707,8 +2800,7 @@ { "type": "null" } - ], - "default": null + ] }, "agent_role": { "default": null, @@ -2718,50 +2810,46 @@ ] }, "depth": { - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - }, - "required": [ - "depth", - "parent_thread_id" - ], - "type": "object" + } } }, - "required": [ - "thread_spawn" - ], - "title": "ThreadSpawnSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "ThreadSpawnSubAgentSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "other" + ], "properties": { "other": { "type": "string" } }, - "required": [ - "other" - ], - "title": "OtherSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "OtherSubAgentSource" } ] }, "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.", @@ -2770,13 +2858,23 @@ "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.", @@ -2798,22 +2896,23 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "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" @@ -2821,8 +2920,7 @@ { "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.", @@ -2832,6 +2930,7 @@ ] }, "gitInfo": { + "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2839,8 +2938,7 @@ { "type": "null" } - ], - "description": "Optional Git metadata captured when the thread was created." + ] }, "id": { "type": "string" @@ -2868,55 +2966,41 @@ "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.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } - }, - "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" @@ -2924,65 +3008,72 @@ "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -2990,10 +3081,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -3001,30 +3092,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -3033,56 +3123,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -3097,34 +3190,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" @@ -3137,42 +3230,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -3181,32 +3272,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -3247,43 +3340,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -3307,31 +3399,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -3352,6 +3446,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -3359,57 +3454,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -3428,22 +3518,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -3452,22 +3542,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -3495,23 +3586,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -3520,22 +3610,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -3544,137 +3634,138 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "ThreadStatus": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType", - "type": "string" + "title": "NotLoadedThreadStatusType" } }, + "title": "NotLoadedThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "NotLoadedThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType", - "type": "string" + "title": "IdleThreadStatusType" } }, + "title": "IdleThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "IdleThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType", - "type": "string" + "title": "SystemErrorThreadStatusType" } }, - "required": [ - "type" - ], - "title": "SystemErrorThreadStatus", - "type": "object" + "title": "SystemErrorThreadStatus" }, { - "properties": { - "activeFlags": { - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - }, - "type": "array" - }, - "type": { - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType", - "type": "string" - } - }, + "type": "object", "required": [ "activeFlags", "type" ], - "title": "ActiveThreadStatus", - "type": "object" + "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.", - "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" @@ -3682,39 +3773,36 @@ { "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, @@ -3736,92 +3824,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3830,22 +3920,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3854,35 +3944,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -3891,27 +3979,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -3920,13 +4008,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -3935,11 +4023,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -3948,113 +4036,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 e55d27c2..e1148e8b 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,5 +1,15 @@ { "$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.", @@ -9,28 +19,29 @@ "type": "string" }, "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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", @@ -41,129 +52,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -174,13 +188,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -189,30 +200,36 @@ "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" @@ -224,23 +241,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -252,21 +267,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -284,113 +299,119 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "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" @@ -434,41 +455,42 @@ "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": [ @@ -477,10 +499,10 @@ ] }, "evidence_refs": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "horizon": { "type": "string" @@ -492,10 +514,10 @@ "type": "string" }, "lane_hints": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -504,10 +526,10 @@ "type": "string" }, "source_refs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "type": "array" + } }, "status": { "type": "string" @@ -524,21 +546,14 @@ "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" @@ -553,12 +568,12 @@ "type": "string" }, "unexplained_writes": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "warning": { "type": [ @@ -566,22 +581,21 @@ "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": [ @@ -593,12 +607,12 @@ "type": "string" }, "start_line": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "symbol": { "type": [ @@ -606,19 +620,22 @@ "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" @@ -632,59 +649,57 @@ "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, - "type": "integer" + "minimum": 0.0 }, "open_gap_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "open_question_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -692,20 +707,21 @@ "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": [ @@ -734,59 +750,58 @@ "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" @@ -797,20 +812,21 @@ "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" @@ -839,15 +855,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "purpose", - "title" - ], - "type": "object" + } }, "EpiphanyGraphs": { + "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -856,15 +867,20 @@ "$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" @@ -881,15 +897,16 @@ "status": { "type": "string" } - }, - "required": [ - "description", - "id", - "status" - ], - "type": "object" + } }, "EpiphanyInvestigationCheckpoint": { + "type": "object", + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], "properties": { "captured_at_turn_id": { "type": [ @@ -901,19 +918,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" @@ -928,10 +945,10 @@ ] }, "open_questions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -939,23 +956,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": [ @@ -976,16 +993,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" @@ -993,32 +1010,29 @@ "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": [ @@ -1033,31 +1047,36 @@ "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" @@ -1066,25 +1085,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" @@ -1095,18 +1114,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "type": "object" + } }, "EpiphanyObjectiveDraftLanePlan": { + "type": "object", "properties": { "body": { "type": [ @@ -1144,39 +1155,45 @@ "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" @@ -1190,16 +1207,17 @@ "summary": { "type": "string" } - }, - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "type": "object" + } }, "EpiphanyPlanningCapture": { + "type": "object", + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], "properties": { "body": { "type": [ @@ -1232,10 +1250,10 @@ "type": "string" }, "tags": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": "string" @@ -1246,23 +1264,20 @@ "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": [ @@ -1292,10 +1307,10 @@ ] }, "unblocks": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "urgency": { "type": [ @@ -1306,20 +1321,19 @@ "value": { "type": "string" } - }, - "required": [ - "rationale", - "value" - ], - "type": "object" + } }, "EpiphanyPlanningSourceRef": { + "type": "object", + "required": [ + "kind" + ], "properties": { "assignees": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "author": { "type": [ @@ -1340,11 +1354,11 @@ ] }, "database_id": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "external_id": { "type": [ @@ -1365,21 +1379,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": [ @@ -1429,37 +1443,34 @@ "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": [ @@ -1467,29 +1478,33 @@ "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" @@ -1501,27 +1516,26 @@ "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": [ @@ -1530,79 +1544,82 @@ ] }, "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": [ @@ -1625,16 +1642,18 @@ "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" @@ -1646,16 +1665,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" @@ -1672,18 +1691,10 @@ "surface": { "type": "string" } - }, - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "type": "object" + } }, "EpiphanyScratchPad": { + "type": "object", "properties": { "hypothesis": { "type": [ @@ -1698,10 +1709,10 @@ ] }, "notes": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1709,10 +1720,15 @@ "null" ] } - }, - "type": "object" + } }, "EpiphanySubgoal": { + "type": "object", + "required": [ + "id", + "status", + "title" + ], "properties": { "id": { "type": "string" @@ -1729,21 +1745,19 @@ "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": [ @@ -1785,10 +1799,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - }, - "type": "array" + } }, "investigation_checkpoint": { "anyOf": [ @@ -1801,10 +1815,10 @@ ] }, "job_bindings": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - }, - "type": "array" + } }, "last_updated_turn_id": { "type": [ @@ -1829,19 +1843,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": [ @@ -1854,15 +1868,15 @@ ] }, "revision": { + "type": "integer", "format": "uint64", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "runtime_links": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - }, - "type": "array" + } }, "scratch": { "anyOf": [ @@ -1875,18 +1889,20 @@ ] }, "subgoals": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - }, - "type": "array" + } } - }, - "required": [ - "revision" - ], - "type": "object" + } }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -1897,15 +1913,10 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "GitInfo": { + "type": "object", "properties": { "branch": { "type": [ @@ -1925,10 +1936,14 @@ "null" ] } - }, - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -1936,78 +1951,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -2015,85 +2032,82 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -2102,23 +2116,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -2126,63 +2137,70 @@ "medium", "high", "xhigh" - ], - "type": "string" + ] }, "SessionSource": { "oneOf": [ { + "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "custom" + ], "properties": { "custom": { "type": "string" } }, - "required": [ - "custom" - ], - "title": "CustomSessionSource", - "type": "object" + "additionalProperties": false, + "title": "CustomSessionSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "subAgent" + ], "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "required": [ - "subAgent" - ], - "title": "SubAgentSessionSource", - "type": "object" + "additionalProperties": false, + "title": "SubAgentSessionSource" } ] }, "SubAgentSource": { "oneOf": [ { + "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "thread_spawn" + ], "properties": { "thread_spawn": { + "type": "object", + "required": [ + "depth", + "parent_thread_id" + ], "properties": { "agent_nickname": { "default": null, @@ -2192,6 +2210,7 @@ ] }, "agent_path": { + "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2199,8 +2218,7 @@ { "type": "null" } - ], - "default": null + ] }, "agent_role": { "default": null, @@ -2210,50 +2228,46 @@ ] }, "depth": { - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - }, - "required": [ - "depth", - "parent_thread_id" - ], - "type": "object" + } } }, - "required": [ - "thread_spawn" - ], - "title": "ThreadSpawnSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "ThreadSpawnSubAgentSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "other" + ], "properties": { "other": { "type": "string" } }, - "required": [ - "other" - ], - "title": "OtherSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "OtherSubAgentSource" } ] }, "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.", @@ -2262,13 +2276,23 @@ "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.", @@ -2290,22 +2314,23 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "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" @@ -2313,8 +2338,7 @@ { "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.", @@ -2324,6 +2348,7 @@ ] }, "gitInfo": { + "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2331,8 +2356,7 @@ { "type": "null" } - ], - "description": "Optional Git metadata captured when the thread was created." + ] }, "id": { "type": "string" @@ -2360,55 +2384,41 @@ "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.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } - }, - "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" @@ -2416,65 +2426,72 @@ "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -2482,10 +2499,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -2493,30 +2510,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -2525,56 +2541,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -2589,34 +2608,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" @@ -2629,42 +2648,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -2673,32 +2690,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -2739,43 +2758,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -2799,31 +2817,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -2844,6 +2864,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -2851,57 +2872,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -2920,22 +2936,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -2944,22 +2960,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -2987,23 +3004,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -3012,22 +3028,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -3036,137 +3052,138 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "ThreadStatus": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType", - "type": "string" + "title": "NotLoadedThreadStatusType" } }, + "title": "NotLoadedThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "NotLoadedThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType", - "type": "string" + "title": "IdleThreadStatusType" } }, + "title": "IdleThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "IdleThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType", - "type": "string" + "title": "SystemErrorThreadStatusType" } }, - "required": [ - "type" - ], - "title": "SystemErrorThreadStatus", - "type": "object" + "title": "SystemErrorThreadStatus" }, { - "properties": { - "activeFlags": { - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - }, - "type": "array" - }, - "type": { - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType", - "type": "string" - } - }, + "type": "object", "required": [ "activeFlags", "type" ], - "title": "ActiveThreadStatus", - "type": "object" + "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.", - "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" @@ -3174,39 +3191,36 @@ { "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, @@ -3228,92 +3242,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3322,22 +3338,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3346,35 +3362,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -3383,27 +3397,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -3412,13 +3426,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -3427,11 +3441,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -3440,39 +3454,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 bd658504..74176bbe 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,89 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - ] - } - }, + "title": "ThreadStatusChangedNotification", + "type": "object", + "required": [ + "status", + "threadId" + ], "properties": { "status": { "$ref": "#/definitions/ThreadStatus" @@ -92,10 +14,88 @@ "type": "string" } }, - "required": [ - "status", - "threadId" - ], - "title": "ThreadStatusChangedNotification", - "type": "object" + "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" + } + ] + } + } } \ 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 a1aba9b1..20edbcdf 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,68 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "title": "ThreadTokenUsageUpdatedNotification", + "type": "object", + "required": [ + "threadId", + "tokenUsage", + "turnId" + ], "properties": { "threadId": { "type": "string" @@ -74,11 +18,67 @@ "type": "string" } }, - "required": [ - "threadId", - "tokenUsage", - "turnId" - ], - "title": "ThreadTokenUsageUpdatedNotification", - "type": "object" + "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" + } + } + } + } } \ 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 ed58a454..b5bcb923 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,14 +1,10 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "SortDirection": { - "enum": [ - "asc", - "desc" - ], - "type": "string" - } - }, + "title": "ThreadTurnsListParams", + "type": "object", + "required": [ + "threadId" + ], "properties": { "cursor": { "description": "Opaque cursor to pass to the next call to continue after the last turn.", @@ -19,14 +15,15 @@ }, "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" @@ -34,16 +31,19 @@ { "type": "null" } - ], - "description": "Optional turn pagination direction; defaults to descending." + ] }, "threadId": { "type": "string" } }, - "required": [ - "threadId" - ], - "title": "ThreadTurnsListParams", - "type": "object" + "definitions": { + "SortDirection": { + "type": "string", + "enum": [ + "asc", + "desc" + ] + } + } } \ 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 8d4ee72e..ac218967 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,33 +1,61 @@ { "$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": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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,129 +66,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -171,13 +202,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -186,30 +214,36 @@ "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" @@ -221,23 +255,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -249,21 +281,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -281,113 +313,114 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "DynamicToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -398,15 +431,14 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -414,78 +446,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -493,85 +527,82 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -580,23 +611,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -604,18 +632,21 @@ "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.", @@ -624,74 +655,77 @@ "null" ] } - }, - "required": [ - "byteRange" - ], - "type": "object" + } }, "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -699,10 +733,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -710,30 +744,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -742,56 +775,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -806,34 +842,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" @@ -846,42 +882,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -890,32 +924,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -956,43 +992,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -1016,31 +1051,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -1061,6 +1098,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -1068,57 +1106,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -1137,22 +1170,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -1161,22 +1194,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -1204,23 +1238,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -1229,22 +1262,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -1253,62 +1286,63 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "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" @@ -1316,39 +1350,36 @@ { "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, @@ -1370,92 +1401,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1464,22 +1497,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1488,35 +1521,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -1525,27 +1556,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -1554,13 +1585,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -1569,11 +1600,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -1582,56 +1613,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 fd62a96c..d61b125f 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 abdf046a..54233a88 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,5 +1,15 @@ { "$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.", @@ -9,28 +19,29 @@ "type": "string" }, "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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", @@ -41,129 +52,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -174,13 +188,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -189,30 +200,36 @@ "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" @@ -224,23 +241,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -252,21 +267,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -284,113 +299,119 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "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" @@ -434,41 +455,42 @@ "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": [ @@ -477,10 +499,10 @@ ] }, "evidence_refs": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "horizon": { "type": "string" @@ -492,10 +514,10 @@ "type": "string" }, "lane_hints": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "priority": { "$ref": "#/definitions/EpiphanyPlanningPriority" @@ -504,10 +526,10 @@ "type": "string" }, "source_refs": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyPlanningSourceRef" - }, - "type": "array" + } }, "status": { "type": "string" @@ -524,21 +546,14 @@ "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" @@ -553,12 +568,12 @@ "type": "string" }, "unexplained_writes": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "warning": { "type": [ @@ -566,22 +581,21 @@ "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": [ @@ -593,12 +607,12 @@ "type": "string" }, "start_line": { - "format": "uint32", - "minimum": 0.0, "type": [ "integer", "null" - ] + ], + "format": "uint32", + "minimum": 0.0 }, "symbol": { "type": [ @@ -606,19 +620,22 @@ "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" @@ -632,59 +649,57 @@ "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, - "type": "integer" + "minimum": 0.0 }, "open_gap_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "open_question_ids": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -692,20 +707,21 @@ "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": [ @@ -734,59 +750,58 @@ "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" @@ -797,20 +812,21 @@ "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" @@ -839,15 +855,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "purpose", - "title" - ], - "type": "object" + } }, "EpiphanyGraphs": { + "type": "object", "properties": { "architecture": { "$ref": "#/definitions/EpiphanyGraph" @@ -856,15 +867,20 @@ "$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" @@ -881,15 +897,16 @@ "status": { "type": "string" } - }, - "required": [ - "description", - "id", - "status" - ], - "type": "object" + } }, "EpiphanyInvestigationCheckpoint": { + "type": "object", + "required": [ + "checkpoint_id", + "disposition", + "focus", + "kind" + ], "properties": { "captured_at_turn_id": { "type": [ @@ -901,19 +918,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" @@ -928,10 +945,10 @@ ] }, "open_questions": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -939,23 +956,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": [ @@ -976,16 +993,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" @@ -993,32 +1010,29 @@ "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": [ @@ -1033,31 +1047,36 @@ "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" @@ -1066,25 +1085,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" @@ -1095,18 +1114,10 @@ "title": { "type": "string" } - }, - "required": [ - "id", - "lane_plan", - "scope", - "status", - "summary", - "title" - ], - "type": "object" + } }, "EpiphanyObjectiveDraftLanePlan": { + "type": "object", "properties": { "body": { "type": [ @@ -1144,39 +1155,45 @@ "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" @@ -1190,16 +1207,17 @@ "summary": { "type": "string" } - }, - "required": [ - "id", - "source_kind", - "status", - "summary" - ], - "type": "object" + } }, "EpiphanyPlanningCapture": { + "type": "object", + "required": [ + "confidence", + "id", + "source", + "status", + "title" + ], "properties": { "body": { "type": [ @@ -1232,10 +1250,10 @@ "type": "string" }, "tags": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "title": { "type": "string" @@ -1246,23 +1264,20 @@ "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": [ @@ -1292,10 +1307,10 @@ ] }, "unblocks": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "urgency": { "type": [ @@ -1306,20 +1321,19 @@ "value": { "type": "string" } - }, - "required": [ - "rationale", - "value" - ], - "type": "object" + } }, "EpiphanyPlanningSourceRef": { + "type": "object", + "required": [ + "kind" + ], "properties": { "assignees": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "author": { "type": [ @@ -1340,11 +1354,11 @@ ] }, "database_id": { - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "external_id": { "type": [ @@ -1365,21 +1379,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": [ @@ -1429,37 +1443,34 @@ "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": [ @@ -1467,29 +1478,33 @@ "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" @@ -1501,27 +1516,26 @@ "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": [ @@ -1530,79 +1544,82 @@ ] }, "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": [ @@ -1625,16 +1642,18 @@ "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" @@ -1646,16 +1665,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" @@ -1672,18 +1691,10 @@ "surface": { "type": "string" } - }, - "required": [ - "authority_scope", - "binding_id", - "id", - "role_id", - "runtime_job_id", - "surface" - ], - "type": "object" + } }, "EpiphanyScratchPad": { + "type": "object", "properties": { "hypothesis": { "type": [ @@ -1698,10 +1709,10 @@ ] }, "notes": { + "type": "array", "items": { "type": "string" - }, - "type": "array" + } }, "summary": { "type": [ @@ -1709,10 +1720,15 @@ "null" ] } - }, - "type": "object" + } }, "EpiphanySubgoal": { + "type": "object", + "required": [ + "id", + "status", + "title" + ], "properties": { "id": { "type": "string" @@ -1729,21 +1745,19 @@ "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": [ @@ -1785,10 +1799,10 @@ "$ref": "#/definitions/EpiphanyGraphs" }, "invariants": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyInvariant" - }, - "type": "array" + } }, "investigation_checkpoint": { "anyOf": [ @@ -1801,10 +1815,10 @@ ] }, "job_bindings": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyJobBinding" - }, - "type": "array" + } }, "last_updated_turn_id": { "type": [ @@ -1829,19 +1843,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": [ @@ -1854,15 +1868,15 @@ ] }, "revision": { + "type": "integer", "format": "uint64", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "runtime_links": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanyRuntimeLink" - }, - "type": "array" + } }, "scratch": { "anyOf": [ @@ -1875,18 +1889,20 @@ ] }, "subgoals": { + "type": "array", "items": { "$ref": "#/definitions/EpiphanySubgoal" - }, - "type": "array" + } } - }, - "required": [ - "revision" - ], - "type": "object" + } }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -1897,15 +1913,10 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "GitInfo": { + "type": "object", "properties": { "branch": { "type": [ @@ -1925,10 +1936,14 @@ "null" ] } - }, - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -1936,78 +1951,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -2015,85 +2032,82 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -2102,23 +2116,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -2126,63 +2137,70 @@ "medium", "high", "xhigh" - ], - "type": "string" + ] }, "SessionSource": { "oneOf": [ { + "type": "string", "enum": [ "cli", "vscode", "exec", "appServer", "unknown" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "custom" + ], "properties": { "custom": { "type": "string" } }, - "required": [ - "custom" - ], - "title": "CustomSessionSource", - "type": "object" + "additionalProperties": false, + "title": "CustomSessionSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "subAgent" + ], "properties": { "subAgent": { "$ref": "#/definitions/SubAgentSource" } }, - "required": [ - "subAgent" - ], - "title": "SubAgentSessionSource", - "type": "object" + "additionalProperties": false, + "title": "SubAgentSessionSource" } ] }, "SubAgentSource": { "oneOf": [ { + "type": "string", "enum": [ "review", "compact", "memory_consolidation" - ], - "type": "string" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "thread_spawn" + ], "properties": { "thread_spawn": { + "type": "object", + "required": [ + "depth", + "parent_thread_id" + ], "properties": { "agent_nickname": { "default": null, @@ -2192,6 +2210,7 @@ ] }, "agent_path": { + "default": null, "anyOf": [ { "$ref": "#/definitions/AgentPath" @@ -2199,8 +2218,7 @@ { "type": "null" } - ], - "default": null + ] }, "agent_role": { "default": null, @@ -2210,50 +2228,46 @@ ] }, "depth": { - "format": "int32", - "type": "integer" + "type": "integer", + "format": "int32" }, "parent_thread_id": { "$ref": "#/definitions/ThreadId" } - }, - "required": [ - "depth", - "parent_thread_id" - ], - "type": "object" + } } }, - "required": [ - "thread_spawn" - ], - "title": "ThreadSpawnSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "ThreadSpawnSubAgentSource" }, { - "additionalProperties": false, + "type": "object", + "required": [ + "other" + ], "properties": { "other": { "type": "string" } }, - "required": [ - "other" - ], - "title": "OtherSubAgentSource", - "type": "object" + "additionalProperties": false, + "title": "OtherSubAgentSource" } ] }, "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.", @@ -2262,13 +2276,23 @@ "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.", @@ -2290,22 +2314,23 @@ }, "createdAt": { "description": "Unix timestamp (in seconds) when the thread was created.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" }, "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" @@ -2313,8 +2338,7 @@ { "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.", @@ -2324,6 +2348,7 @@ ] }, "gitInfo": { + "description": "Optional Git metadata captured when the thread was created.", "anyOf": [ { "$ref": "#/definitions/GitInfo" @@ -2331,8 +2356,7 @@ { "type": "null" } - ], - "description": "Optional Git metadata captured when the thread was created." + ] }, "id": { "type": "string" @@ -2360,55 +2384,41 @@ "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.", - "format": "int64", - "type": "integer" + "type": "integer", + "format": "int64" } - }, - "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" @@ -2416,65 +2426,72 @@ "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -2482,10 +2499,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -2493,30 +2510,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -2525,56 +2541,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -2589,34 +2608,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" @@ -2629,42 +2648,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -2673,32 +2690,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -2739,43 +2758,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -2799,31 +2817,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -2844,6 +2864,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -2851,57 +2872,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -2920,22 +2936,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -2944,22 +2960,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -2987,23 +3004,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -3012,22 +3028,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -3036,137 +3052,138 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "ThreadStatus": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "type": { + "type": "string", "enum": [ "notLoaded" ], - "title": "NotLoadedThreadStatusType", - "type": "string" + "title": "NotLoadedThreadStatusType" } }, + "title": "NotLoadedThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "NotLoadedThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "idle" ], - "title": "IdleThreadStatusType", - "type": "string" + "title": "IdleThreadStatusType" } }, + "title": "IdleThreadStatus" + }, + { + "type": "object", "required": [ "type" ], - "title": "IdleThreadStatus", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "systemError" ], - "title": "SystemErrorThreadStatusType", - "type": "string" + "title": "SystemErrorThreadStatusType" } }, - "required": [ - "type" - ], - "title": "SystemErrorThreadStatus", - "type": "object" + "title": "SystemErrorThreadStatus" }, { - "properties": { - "activeFlags": { - "items": { - "$ref": "#/definitions/ThreadActiveFlag" - }, - "type": "array" - }, - "type": { - "enum": [ - "active" - ], - "title": "ActiveThreadStatusType", - "type": "string" - } - }, + "type": "object", "required": [ "activeFlags", "type" ], - "title": "ActiveThreadStatus", - "type": "object" + "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.", - "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" @@ -3174,39 +3191,36 @@ { "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, @@ -3228,92 +3242,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3322,22 +3338,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -3346,35 +3362,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -3383,27 +3397,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -3412,13 +3426,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -3427,11 +3441,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -3440,39 +3454,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 7e4bcd56..b19eb288 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 dec3670c..ddb31219 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 2e545dbf..ade0e65e 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#", - "definitions": { - "ThreadUnsubscribeStatus": { - "enum": [ - "notLoaded", - "notSubscribed", - "unsubscribed" - ], - "type": "string" - } - }, + "title": "ThreadUnsubscribeResponse", + "type": "object", + "required": [ + "status" + ], "properties": { "status": { "$ref": "#/definitions/ThreadUnsubscribeStatus" } }, - "required": [ - "status" - ], - "title": "ThreadUnsubscribeResponse", - "type": "object" + "definitions": { + "ThreadUnsubscribeStatus": { + "type": "string", + "enum": [ + "notLoaded", + "notSubscribed", + "unsubscribed" + ] + } + } } \ 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 05395f4f..c6f52fb9 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,33 +1,48 @@ { "$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": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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,129 +53,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -171,13 +189,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -186,30 +201,36 @@ "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" @@ -221,23 +242,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -249,21 +268,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -281,113 +300,114 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "DynamicToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -398,15 +418,14 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -414,78 +433,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -493,85 +514,82 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -580,23 +598,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -604,18 +619,21 @@ "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.", @@ -624,74 +642,77 @@ "null" ] } - }, - "required": [ - "byteRange" - ], - "type": "object" + } }, "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -699,10 +720,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -710,30 +731,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -742,56 +762,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -806,34 +829,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" @@ -846,42 +869,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -890,32 +911,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -956,43 +979,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -1016,31 +1038,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -1061,6 +1085,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -1068,57 +1093,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -1137,22 +1157,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -1161,22 +1181,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -1204,23 +1225,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -1229,22 +1249,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -1253,62 +1273,63 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "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" @@ -1316,39 +1337,36 @@ { "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, @@ -1370,92 +1388,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1464,22 +1484,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1488,35 +1508,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -1525,27 +1543,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -1554,13 +1572,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -1569,11 +1587,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -1582,43 +1600,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 b694ce25..e4394765 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,6 +1,13 @@ { "$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" @@ -11,12 +18,5 @@ "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 9181428a..f38a75ea 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,5 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "TurnInterruptParams", + "type": "object", + "required": [ + "threadId", + "turnId" + ], "properties": { "threadId": { "type": "string" @@ -7,11 +13,5 @@ "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 5a28ffbf..0f835387 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,30 +1,12 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "TurnPlanStep": { - "properties": { - "status": { - "$ref": "#/definitions/TurnPlanStepStatus" - }, - "step": { - "type": "string" - } - }, - "required": [ - "status", - "step" - ], - "type": "object" - }, - "TurnPlanStepStatus": { - "enum": [ - "pending", - "inProgress", - "completed" - ], - "type": "string" - } - }, + "title": "TurnPlanUpdatedNotification", + "type": "object", + "required": [ + "plan", + "threadId", + "turnId" + ], "properties": { "explanation": { "type": [ @@ -33,10 +15,10 @@ ] }, "plan": { + "type": "array", "items": { "$ref": "#/definitions/TurnPlanStep" - }, - "type": "array" + } }, "threadId": { "type": "string" @@ -45,11 +27,29 @@ "type": "string" } }, - "required": [ - "plan", - "threadId", - "turnId" - ], - "title": "TurnPlanUpdatedNotification", - "type": "object" + "definitions": { + "TurnPlanStep": { + "type": "object", + "required": [ + "status", + "step" + ], + "properties": { + "status": { + "$ref": "#/definitions/TurnPlanStepStatus" + }, + "step": { + "type": "string" + } + } + }, + "TurnPlanStepStatus": { + "type": "string", + "enum": [ + "pending", + "inProgress", + "completed" + ] + } + } } \ 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 06277102..e5e81f68 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,5 +1,134 @@ { "$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" + } + ] + }, + "summary": { + "description": "Override the reasoning summary for this turn and subsequent turns.", + "anyOf": [ + { + "$ref": "#/definitions/ReasoningSummary" + }, + { + "type": "null" + } + ] + }, + "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" + } + ] + }, + "serviceTier": { + "description": "Override the service tier for this turn and subsequent turns.", + "anyOf": [ + { + "anyOf": [ + { + "$ref": "#/definitions/ServiceTier" + }, + { + "type": "null" + } + ] + }, + { + "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" + } + ] + }, + "threadId": { + "type": "string" + }, + "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.", @@ -7,28 +136,37 @@ }, "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" + ] }, { - "additionalProperties": false, + "type": "object", + "required": [ + "granular" + ], "properties": { "granular": { + "type": "object", + "required": [ + "mcp_elicitations", + "rules", + "sandbox_approval" + ], "properties": { "mcp_elicitations": { "type": "boolean" @@ -47,44 +185,40 @@ "default": false, "type": "boolean" } - }, - "required": [ - "mcp_elicitations", - "rules", - "sandbox_approval" - ], - "type": "object" + } } }, - "required": [ - "granular" - ], - "title": "GranularAskForApproval", - "type": "object" + "additionalProperties": false, + "title": "GranularAskForApproval" } ] }, "ByteRange": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "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" @@ -92,86 +226,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", - "type": "string" + "title": "PathFileSystemPathType" } }, - "required": [ - "path", - "type" - ], - "title": "PathFileSystemPath", - "type": "object" + "title": "PathFileSystemPath" }, { + "type": "object", + "required": [ + "pattern", + "type" + ], "properties": { "pattern": { "type": "string" }, "type": { + "type": "string", "enum": [ "glob_pattern" ], - "title": "GlobPatternFileSystemPathType", - "type": "string" + "title": "GlobPatternFileSystemPathType" } }, - "required": [ - "pattern", - "type" - ], - "title": "GlobPatternFileSystemPath", - "type": "object" + "title": "GlobPatternFileSystemPath" }, { + "type": "object", + "required": [ + "type", + "value" + ], "properties": { "type": { + "type": "string", "enum": [ "special" ], - "title": "SpecialFileSystemPathType", - "type": "string" + "title": "SpecialFileSystemPathType" }, "value": { "$ref": "#/definitions/FileSystemSpecialPath" } }, - "required": [ - "type", - "value" - ], - "title": "SpecialFileSystemPath", - "type": "object" + "title": "SpecialFileSystemPath" } ] }, "FileSystemSandboxEntry": { + "type": "object", + "required": [ + "access", + "path" + ], "properties": { "access": { "$ref": "#/definitions/FileSystemAccessMode" @@ -179,67 +313,66 @@ "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": [ @@ -248,49 +381,50 @@ ] } }, + "title": "KindFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "KindFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "tmpdir" - ], - "type": "string" + ] } }, + "title": "TmpdirFileSystemSpecialPath" + }, + { + "type": "object", "required": [ "kind" ], - "title": "TmpdirFileSystemSpecialPath", - "type": "object" - }, - { "properties": { "kind": { + "type": "string", "enum": [ "slash_tmp" - ], - "type": "string" + ] } }, - "required": [ - "kind" - ], - "title": "SlashTmpFileSystemSpecialPath", - "type": "object" + "title": "SlashTmpFileSystemSpecialPath" }, { + "type": "object", + "required": [ + "kind", + "path" + ], "properties": { "kind": { + "type": "string", "enum": [ "unknown" - ], - "type": "string" + ] }, "path": { "type": "string" @@ -301,31 +435,27 @@ "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": [ @@ -347,32 +477,32 @@ } ] } - }, - "type": "object" + } }, "PermissionProfileFileSystemPermissions": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/FileSystemSandboxEntry" - }, - "type": "array" - }, - "globScanMaxDepth": { - "format": "uint", - "minimum": 1.0, - "type": [ - "integer", - "null" - ] - } - }, + "type": "object", "required": [ "entries" ], - "type": "object" + "properties": { + "entries": { + "type": "array", + "items": { + "$ref": "#/definitions/FileSystemSandboxEntry" + } + }, + "globScanMaxDepth": { + "type": [ + "integer", + "null" + ], + "format": "uint", + "minimum": 1.0 + } + } }, "PermissionProfileNetworkPermissions": { + "type": "object", "properties": { "enabled": { "type": [ @@ -380,20 +510,23 @@ "null" ] } - }, - "type": "object" + } }, "Personality": { + "type": "string", "enum": [ "none", "friendly", "pragmatic" - ], - "type": "string" + ] }, "ReadOnlyAccess": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "includePlatformDefaults": { "default": true, @@ -401,45 +534,42 @@ }, "readableRoots": { "default": [], + "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "restricted" ], - "title": "RestrictedReadOnlyAccessType", - "type": "string" + "title": "RestrictedReadOnlyAccessType" } }, + "title": "RestrictedReadOnlyAccess" + }, + { + "type": "object", "required": [ "type" ], - "title": "RestrictedReadOnlyAccess", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "fullAccess" ], - "title": "FullAccessReadOnlyAccessType", - "type": "string" + "title": "FullAccessReadOnlyAccessType" } }, - "required": [ - "type" - ], - "title": "FullAccessReadOnlyAccess", - "type": "object" + "title": "FullAccessReadOnlyAccess" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -447,102 +577,105 @@ "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": [ { - "properties": { - "type": { - "enum": [ - "dangerFullAccess" - ], - "title": "DangerFullAccessSandboxPolicyType", - "type": "string" - } - }, + "type": "object", "required": [ "type" ], - "title": "DangerFullAccessSandboxPolicy", - "type": "object" + "properties": { + "type": { + "type": "string", + "enum": [ + "dangerFullAccess" + ], + "title": "DangerFullAccessSandboxPolicyType" + } + }, + "title": "DangerFullAccessSandboxPolicy" }, { + "type": "object", + "required": [ + "type" + ], "properties": { "access": { + "default": { + "type": "fullAccess" + }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ], - "default": { - "type": "fullAccess" - } + ] }, "networkAccess": { "default": false, "type": "boolean" }, "type": { + "type": "string", "enum": [ "readOnly" ], - "title": "ReadOnlySandboxPolicyType", - "type": "string" + "title": "ReadOnlySandboxPolicyType" } }, + "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", - "type": "string" + "title": "ExternalSandboxSandboxPolicyType" } }, + "title": "ExternalSandboxSandboxPolicy" + }, + { + "type": "object", "required": [ "type" ], - "title": "ExternalSandboxSandboxPolicy", - "type": "object" - }, - { "properties": { "excludeSlashTmp": { "default": false, @@ -557,47 +690,47 @@ "type": "boolean" }, "readOnlyAccess": { + "default": { + "type": "fullAccess" + }, "allOf": [ { "$ref": "#/definitions/ReadOnlyAccess" } - ], - "default": { - "type": "fullAccess" - } + ] }, "type": { + "type": "string", "enum": [ "workspaceWrite" ], - "title": "WorkspaceWriteSandboxPolicyType", - "type": "string" + "title": "WorkspaceWriteSandboxPolicyType" }, "writableRoots": { "default": [], + "type": "array", "items": { "$ref": "#/definitions/AbsolutePathBuf" - }, - "type": "array" + } } }, - "required": [ - "type" - ], - "title": "WorkspaceWriteSandboxPolicy", - "type": "object" + "title": "WorkspaceWriteSandboxPolicy" } ] }, "ServiceTier": { + "type": "string", "enum": [ "fast", "flex" - ], - "type": "string" + ] }, "Settings": { "description": "Settings for a collaboration mode.", + "type": "object", + "required": [ + "model" + ], "properties": { "developer_instructions": { "type": [ @@ -618,21 +751,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.", @@ -641,13 +774,14 @@ "null" ] } - }, - "required": [ - "byteRange" - ], - "type": "object" + } }, "TurnEnvironmentParams": { + "type": "object", + "required": [ + "cwd", + "environmentId" + ], "properties": { "cwd": { "$ref": "#/definitions/AbsolutePathBuf" @@ -655,84 +789,85 @@ "environmentId": { "type": "string" } - }, - "required": [ - "cwd", - "environmentId" - ], - "type": "object" + } }, "UserInput": { "oneOf": [ { + "type": "object", + "required": [ + "text", + "type" + ], "properties": { "text": { "type": "string" }, "text_elements": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -741,22 +876,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -765,151 +900,16 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] } - }, - "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 c818dd8c..52fa4969 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,33 +1,44 @@ { "$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": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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,129 +49,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -171,13 +185,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -186,30 +197,36 @@ "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" @@ -221,23 +238,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -249,21 +264,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -281,113 +296,114 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "DynamicToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -398,15 +414,14 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -414,78 +429,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -493,85 +510,82 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -580,23 +594,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -604,18 +615,21 @@ "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.", @@ -624,74 +638,77 @@ "null" ] } - }, - "required": [ - "byteRange" - ], - "type": "object" + } }, "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -699,10 +716,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -710,30 +727,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -742,56 +758,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -806,34 +825,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" @@ -846,42 +865,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -890,32 +907,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -956,43 +975,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -1016,31 +1034,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -1061,6 +1081,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -1068,57 +1089,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -1137,22 +1153,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -1161,22 +1177,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -1204,23 +1221,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -1229,22 +1245,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -1253,62 +1269,63 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "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" @@ -1316,39 +1333,36 @@ { "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, @@ -1370,92 +1384,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1464,22 +1480,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1488,35 +1504,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -1525,27 +1539,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -1554,13 +1568,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -1569,11 +1583,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -1582,39 +1596,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 3c8eafcd..1eccc825 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,33 +1,48 @@ { "$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": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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,129 +53,132 @@ "threadRollbackFailed", "sandboxError", "other" - ], - "type": "string" + ] }, { - "additionalProperties": false, - "properties": { - "httpConnectionFailed": { - "properties": { - "httpStatusCode": { - "format": "uint16", - "minimum": 0.0, - "type": [ - "integer", - "null" - ] - } - }, - "type": "object" - } - }, + "type": "object", "required": [ "httpConnectionFailed" ], - "title": "HttpConnectionFailedCodexErrorInfo", - "type": "object" - }, - { - "additionalProperties": false, - "description": "Failed to connect to the response SSE stream.", "properties": { - "responseStreamConnectionFailed": { + "httpConnectionFailed": { + "type": "object", "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": { - "responseStreamDisconnected": { + "responseStreamConnectionFailed": { + "type": "object", "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": { - "responseTooManyFailedAttempts": { + "responseStreamDisconnected": { + "type": "object", "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" ], - "title": "ResponseTooManyFailedAttemptsCodexErrorInfo", - "type": "object" + "properties": { + "responseTooManyFailedAttempts": { + "type": "object", + "properties": { + "httpStatusCode": { + "type": [ + "integer", + "null" + ], + "format": "uint16", + "minimum": 0.0 + } + } + } + }, + "additionalProperties": false, + "title": "ResponseTooManyFailedAttemptsCodexErrorInfo" }, { - "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" + } } }, - "required": [ - "activeTurnNotSteerable" - ], - "title": "ActiveTurnNotSteerableCodexErrorInfo", - "type": "object" + "additionalProperties": false, + "title": "ActiveTurnNotSteerableCodexErrorInfo" } ] }, "CollabAgentState": { + "type": "object", + "required": [ + "status" + ], "properties": { "message": { "type": [ @@ -171,13 +189,10 @@ "status": { "$ref": "#/definitions/CollabAgentStatus" } - }, - "required": [ - "status" - ], - "type": "object" + } }, "CollabAgentStatus": { + "type": "string", "enum": [ "pendingInit", "running", @@ -186,30 +201,36 @@ "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" @@ -221,23 +242,21 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "read" ], - "title": "ReadCommandActionType", - "type": "string" + "title": "ReadCommandActionType" } }, - "required": [ - "command", - "name", - "path", - "type" - ], - "title": "ReadCommandAction", - "type": "object" + "title": "ReadCommandAction" }, { + "type": "object", + "required": [ + "command", + "type" + ], "properties": { "command": { "type": "string" @@ -249,21 +268,21 @@ ] }, "type": { + "type": "string", "enum": [ "listFiles" ], - "title": "ListFilesCommandActionType", - "type": "string" + "title": "ListFilesCommandActionType" } }, + "title": "ListFilesCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "ListFilesCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" @@ -281,113 +300,114 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchCommandActionType", - "type": "string" + "title": "SearchCommandActionType" } }, + "title": "SearchCommandAction" + }, + { + "type": "object", "required": [ "command", "type" ], - "title": "SearchCommandAction", - "type": "object" - }, - { "properties": { "command": { "type": "string" }, "type": { + "type": "string", "enum": [ "unknown" ], - "title": "UnknownCommandActionType", - "type": "string" + "title": "UnknownCommandActionType" } }, - "required": [ - "command", - "type" - ], - "title": "UnknownCommandAction", - "type": "object" + "title": "UnknownCommandAction" } ] }, "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", - "type": "string" + "title": "InputTextDynamicToolCallOutputContentItemType" } }, - "required": [ - "text", - "type" - ], - "title": "InputTextDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputTextDynamicToolCallOutputContentItem" }, { + "type": "object", + "required": [ + "imageUrl", + "type" + ], "properties": { "imageUrl": { "type": "string" }, "type": { + "type": "string", "enum": [ "inputImage" ], - "title": "InputImageDynamicToolCallOutputContentItemType", - "type": "string" + "title": "InputImageDynamicToolCallOutputContentItemType" } }, - "required": [ - "imageUrl", - "type" - ], - "title": "InputImageDynamicToolCallOutputContentItem", - "type": "object" + "title": "InputImageDynamicToolCallOutputContentItem" } ] }, "DynamicToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "FileUpdateChange": { + "type": "object", + "required": [ + "diff", + "kind", + "path" + ], "properties": { "diff": { "type": "string" @@ -398,15 +418,14 @@ "path": { "type": "string" } - }, - "required": [ - "diff", - "kind", - "path" - ], - "type": "object" + } }, "HookPromptFragment": { + "type": "object", + "required": [ + "hookRunId", + "text" + ], "properties": { "hookRunId": { "type": "string" @@ -414,78 +433,80 @@ "text": { "type": "string" } - }, - "required": [ - "hookRunId", - "text" - ], - "type": "object" + } }, "McpToolCallError": { + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "type": "string" } - }, - "required": [ - "message" - ], - "type": "object" + } }, "McpToolCallResult": { - "properties": { - "_meta": true, - "content": { - "items": true, - "type": "array" - }, - "structuredContent": true - }, + "type": "object", "required": [ "content" ], - "type": "object" + "properties": { + "_meta": true, + "content": { + "type": "array", + "items": true + }, + "structuredContent": true + } }, "McpToolCallStatus": { + "type": "string", "enum": [ "inProgress", "completed", "failed" - ], - "type": "string" + ] }, "MemoryCitation": { - "properties": { - "entries": { - "items": { - "$ref": "#/definitions/MemoryCitationEntry" - }, - "type": "array" - }, - "threadIds": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "type": "object", "required": [ "entries", "threadIds" ], - "type": "object" + "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, - "type": "integer" + "minimum": 0.0 }, "lineStart": { + "type": "integer", "format": "uint32", - "minimum": 0.0, - "type": "integer" + "minimum": 0.0 }, "note": { "type": "string" @@ -493,85 +514,82 @@ "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", - "type": "string" + "title": "AddPatchChangeKindType" } }, + "title": "AddPatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "AddPatchChangeKind", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "delete" ], - "title": "DeletePatchChangeKindType", - "type": "string" + "title": "DeletePatchChangeKindType" } }, + "title": "DeletePatchChangeKind" + }, + { + "type": "object", "required": [ "type" ], - "title": "DeletePatchChangeKind", - "type": "object" - }, - { "properties": { "move_path": { "type": [ @@ -580,23 +598,20 @@ ] }, "type": { + "type": "string", "enum": [ "update" ], - "title": "UpdatePatchChangeKindType", - "type": "string" + "title": "UpdatePatchChangeKindType" } }, - "required": [ - "type" - ], - "title": "UpdatePatchChangeKind", - "type": "object" + "title": "UpdatePatchChangeKind" } ] }, "ReasoningEffort": { "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning", + "type": "string", "enum": [ "none", "minimal", @@ -604,18 +619,21 @@ "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.", @@ -624,74 +642,77 @@ "null" ] } - }, - "required": [ - "byteRange" - ], - "type": "object" + } }, "ThreadItem": { "oneOf": [ { - "properties": { - "content": { - "items": { - "$ref": "#/definitions/UserInput" - }, - "type": "array" - }, - "id": { - "type": "string" - }, - "type": { - "enum": [ - "userMessage" - ], - "title": "UserMessageThreadItemType", - "type": "string" - } - }, + "type": "object", "required": [ "content", "id", "type" ], - "title": "UserMessageThreadItem", - "type": "object" - }, - { "properties": { - "fragments": { + "content": { + "type": "array", "items": { - "$ref": "#/definitions/HookPromptFragment" - }, - "type": "array" + "$ref": "#/definitions/UserInput" + } }, "id": { "type": "string" }, "type": { + "type": "string", "enum": [ - "hookPrompt" + "userMessage" ], - "title": "HookPromptThreadItemType", - "type": "string" + "title": "UserMessageThreadItemType" } }, + "title": "UserMessageThreadItem" + }, + { + "type": "object", "required": [ "fragments", "id", "type" ], - "title": "HookPromptThreadItem", - "type": "object" + "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" @@ -699,10 +720,10 @@ { "type": "null" } - ], - "default": null + ] }, "phase": { + "default": null, "anyOf": [ { "$ref": "#/definitions/MessagePhase" @@ -710,30 +731,29 @@ { "type": "null" } - ], - "default": null + ] }, "text": { "type": "string" }, "type": { + "type": "string", "enum": [ "agentMessage" ], - "title": "AgentMessageThreadItemType", - "type": "string" + "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" ], - "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" @@ -742,56 +762,59 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "plan" ], - "title": "PlanThreadItemType", - "type": "string" + "title": "PlanThreadItemType" } }, - "required": [ - "id", - "text", - "type" - ], - "title": "PlanThreadItem", - "type": "object" + "title": "PlanThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "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", - "type": "string" + "title": "ReasoningThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ReasoningThreadItem", - "type": "object" + "title": "ReasoningThreadItem" }, { + "type": "object", + "required": [ + "command", + "commandActions", + "cwd", + "id", + "status", + "type" + ], "properties": { "aggregatedOutput": { "description": "The command's output, aggregated from stdout and stderr.", @@ -806,34 +829,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" @@ -846,42 +869,40 @@ ] }, "source": { + "default": "agent", "allOf": [ { "$ref": "#/definitions/CommandExecutionSource" } - ], - "default": "agent" + ] }, "status": { "$ref": "#/definitions/CommandExecutionStatus" }, "type": { + "type": "string", "enum": [ "commandExecution" ], - "title": "CommandExecutionThreadItemType", - "type": "string" + "title": "CommandExecutionThreadItemType" } }, + "title": "CommandExecutionThreadItem" + }, + { + "type": "object", "required": [ - "command", - "commandActions", - "cwd", + "changes", "id", "status", "type" ], - "title": "CommandExecutionThreadItem", - "type": "object" - }, - { "properties": { "changes": { + "type": "array", "items": { "$ref": "#/definitions/FileUpdateChange" - }, - "type": "array" + } }, "id": { "type": "string" @@ -890,32 +911,34 @@ "$ref": "#/definitions/PatchApplyStatus" }, "type": { + "type": "string", "enum": [ "fileChange" ], - "title": "FileChangeThreadItemType", - "type": "string" + "title": "FileChangeThreadItemType" } }, - "required": [ - "changes", - "id", - "status", - "type" - ], - "title": "FileChangeThreadItem", - "type": "object" + "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.", - "format": "int64", "type": [ "integer", "null" - ] + ], + "format": "int64" }, "error": { "anyOf": [ @@ -956,43 +979,42 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mcpToolCall" ], - "title": "McpToolCallThreadItemType", - "type": "string" + "title": "McpToolCallThreadItemType" } }, + "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" @@ -1016,31 +1038,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "dynamicToolCall" ], - "title": "DynamicToolCallThreadItemType", - "type": "string" + "title": "DynamicToolCallThreadItemType" } }, + "title": "DynamicToolCallThreadItem" + }, + { + "type": "object", "required": [ - "arguments", + "agentsStates", "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.", @@ -1061,6 +1085,7 @@ ] }, "reasoningEffort": { + "description": "Reasoning effort requested for the spawned agent, when applicable.", "anyOf": [ { "$ref": "#/definitions/ReasoningEffort" @@ -1068,57 +1093,52 @@ { "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", - "type": "string" + "title": "CollabAgentToolCallThreadItemType" } }, - "required": [ - "agentsStates", - "id", - "receiverThreadIds", - "senderThreadId", - "status", - "tool", - "type" - ], - "title": "CollabAgentToolCallThreadItem", - "type": "object" + "title": "CollabAgentToolCallThreadItem" }, { + "type": "object", + "required": [ + "id", + "query", + "type" + ], "properties": { "action": { "anyOf": [ @@ -1137,22 +1157,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "webSearch" ], - "title": "WebSearchThreadItemType", - "type": "string" + "title": "WebSearchThreadItemType" } }, - "required": [ - "id", - "query", - "type" - ], - "title": "WebSearchThreadItem", - "type": "object" + "title": "WebSearchThreadItem" }, { + "type": "object", + "required": [ + "id", + "path", + "type" + ], "properties": { "id": { "type": "string" @@ -1161,22 +1181,23 @@ "$ref": "#/definitions/AbsolutePathBuf" }, "type": { + "type": "string", "enum": [ "imageView" ], - "title": "ImageViewThreadItemType", - "type": "string" + "title": "ImageViewThreadItemType" } }, - "required": [ - "id", - "path", - "type" - ], - "title": "ImageViewThreadItem", - "type": "object" + "title": "ImageViewThreadItem" }, { + "type": "object", + "required": [ + "id", + "result", + "status", + "type" + ], "properties": { "id": { "type": "string" @@ -1204,23 +1225,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "imageGeneration" ], - "title": "ImageGenerationThreadItemType", - "type": "string" + "title": "ImageGenerationThreadItemType" } }, - "required": [ - "id", - "result", - "status", - "type" - ], - "title": "ImageGenerationThreadItem", - "type": "object" + "title": "ImageGenerationThreadItem" }, { + "type": "object", + "required": [ + "id", + "review", + "type" + ], "properties": { "id": { "type": "string" @@ -1229,22 +1249,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "enteredReviewMode" ], - "title": "EnteredReviewModeThreadItemType", - "type": "string" + "title": "EnteredReviewModeThreadItemType" } }, + "title": "EnteredReviewModeThreadItem" + }, + { + "type": "object", "required": [ "id", "review", "type" ], - "title": "EnteredReviewModeThreadItem", - "type": "object" - }, - { "properties": { "id": { "type": "string" @@ -1253,62 +1273,63 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "exitedReviewMode" ], - "title": "ExitedReviewModeThreadItemType", - "type": "string" + "title": "ExitedReviewModeThreadItemType" } }, - "required": [ - "id", - "review", - "type" - ], - "title": "ExitedReviewModeThreadItem", - "type": "object" + "title": "ExitedReviewModeThreadItem" }, { + "type": "object", + "required": [ + "id", + "type" + ], "properties": { "id": { "type": "string" }, "type": { + "type": "string", "enum": [ "contextCompaction" ], - "title": "ContextCompactionThreadItemType", - "type": "string" + "title": "ContextCompactionThreadItemType" } }, - "required": [ - "id", - "type" - ], - "title": "ContextCompactionThreadItem", - "type": "object" + "title": "ContextCompactionThreadItem" } ] }, "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" @@ -1316,39 +1337,36 @@ { "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, @@ -1370,92 +1388,94 @@ "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": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1464,22 +1484,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -1488,35 +1508,33 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] }, "WebSearchAction": { "oneOf": [ { + "type": "object", + "required": [ + "type" + ], "properties": { "queries": { - "items": { - "type": "string" - }, "type": [ "array", "null" - ] + ], + "items": { + "type": "string" + } }, "query": { "type": [ @@ -1525,27 +1543,27 @@ ] }, "type": { + "type": "string", "enum": [ "search" ], - "title": "SearchWebSearchActionType", - "type": "string" + "title": "SearchWebSearchActionType" } }, + "title": "SearchWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "SearchWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "openPage" ], - "title": "OpenPageWebSearchActionType", - "type": "string" + "title": "OpenPageWebSearchActionType" }, "url": { "type": [ @@ -1554,13 +1572,13 @@ ] } }, + "title": "OpenPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "OpenPageWebSearchAction", - "type": "object" - }, - { "properties": { "pattern": { "type": [ @@ -1569,11 +1587,11 @@ ] }, "type": { + "type": "string", "enum": [ "findInPage" ], - "title": "FindInPageWebSearchActionType", - "type": "string" + "title": "FindInPageWebSearchActionType" }, "url": { "type": [ @@ -1582,43 +1600,25 @@ ] } }, + "title": "FindInPageWebSearchAction" + }, + { + "type": "object", "required": [ "type" ], - "title": "FindInPageWebSearchAction", - "type": "object" - }, - { "properties": { "type": { + "type": "string", "enum": [ "other" ], - "title": "OtherWebSearchActionType", - "type": "string" + "title": "OtherWebSearchActionType" } }, - "required": [ - "type" - ], - "title": "OtherWebSearchAction", - "type": "object" + "title": "OtherWebSearchAction" } ] } - }, - "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 a064d9e7..f34390e0 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,34 +1,60 @@ { "$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": { - "properties": { - "end": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "start": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - } - }, + "type": "object", "required": [ "end", "start" ], - "type": "object" + "properties": { + "end": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "start": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + } + } }, "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.", @@ -37,83 +63,85 @@ "null" ] } - }, - "required": [ - "byteRange" - ], - "type": "object" + } }, "UserInput": { "oneOf": [ { + "type": "object", + "required": [ + "text", + "type" + ], "properties": { "text": { "type": "string" }, "text_elements": { - "default": [], "description": "UI-defined spans within `text` used to render or persist special elements.", + "default": [], + "type": "array", "items": { "$ref": "#/definitions/TextElement" - }, - "type": "array" + } }, "type": { + "type": "string", "enum": [ "text" ], - "title": "TextUserInputType", - "type": "string" + "title": "TextUserInputType" } }, - "required": [ - "text", - "type" - ], - "title": "TextUserInput", - "type": "object" + "title": "TextUserInput" }, { + "type": "object", + "required": [ + "type", + "url" + ], "properties": { "type": { + "type": "string", "enum": [ "image" ], - "title": "ImageUserInputType", - "type": "string" + "title": "ImageUserInputType" }, "url": { "type": "string" } }, - "required": [ - "type", - "url" - ], - "title": "ImageUserInput", - "type": "object" + "title": "ImageUserInput" }, { + "type": "object", + "required": [ + "path", + "type" + ], "properties": { "path": { "type": "string" }, "type": { + "type": "string", "enum": [ "localImage" ], - "title": "LocalImageUserInputType", - "type": "string" + "title": "LocalImageUserInputType" } }, + "title": "LocalImageUserInput" + }, + { + "type": "object", "required": [ + "name", "path", "type" ], - "title": "LocalImageUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -122,22 +150,22 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "skill" ], - "title": "SkillUserInputType", - "type": "string" + "title": "SkillUserInputType" } }, + "title": "SkillUserInput" + }, + { + "type": "object", "required": [ "name", "path", "type" ], - "title": "SkillUserInput", - "type": "object" - }, - { "properties": { "name": { "type": "string" @@ -146,44 +174,16 @@ "type": "string" }, "type": { + "type": "string", "enum": [ "mention" ], - "title": "MentionUserInputType", - "type": "string" + "title": "MentionUserInputType" } }, - "required": [ - "name", - "path", - "type" - ], - "title": "MentionUserInput", - "type": "object" + "title": "MentionUserInput" } ] } - }, - "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 d801a361..61a912b7 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 46048689..98991174 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,5 +1,10 @@ { "$schema": "http://json-schema.org/draft-07/schema#", + "title": "WarningNotification", + "type": "object", + "required": [ + "message" + ], "properties": { "message": { "description": "Concise warning message for the user.", @@ -12,10 +17,5 @@ "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 9ed9632f..a365b155 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,14 +1,11 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "definitions": { - "WindowsSandboxSetupMode": { - "enum": [ - "elevated", - "unelevated" - ], - "type": "string" - } - }, + "title": "WindowsSandboxSetupCompletedNotification", + "type": "object", + "required": [ + "mode", + "success" + ], "properties": { "error": { "type": [ @@ -23,10 +20,13 @@ "type": "boolean" } }, - "required": [ - "mode", - "success" - ], - "title": "WindowsSandboxSetupCompletedNotification", - "type": "object" + "definitions": { + "WindowsSandboxSetupMode": { + "type": "string", + "enum": [ + "elevated", + "unelevated" + ] + } + } } \ 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 ed93913c..7fcc455c 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,18 +1,10 @@ { "$schema": "http://json-schema.org/draft-07/schema#", - "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" - } - }, + "title": "WindowsSandboxSetupStartParams", + "type": "object", + "required": [ + "mode" + ], "properties": { "cwd": { "anyOf": [ @@ -28,9 +20,17 @@ "$ref": "#/definitions/WindowsSandboxSetupMode" } }, - "required": [ - "mode" - ], - "title": "WindowsSandboxSetupStartParams", - "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" + }, + "WindowsSandboxSetupMode": { + "type": "string", + "enum": [ + "elevated", + "unelevated" + ] + } + } } \ 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 ce35665b..5f831454 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 893dbbaf..20460105 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#", - "properties": { - "extraCount": { - "format": "uint", - "minimum": 0.0, - "type": "integer" - }, - "failedScan": { - "type": "boolean" - }, - "samplePaths": { - "items": { - "type": "string" - }, - "type": "array" - } - }, + "title": "WindowsWorldWritableWarningNotification", + "type": "object", "required": [ "extraCount", "failedScan", "samplePaths" ], - "title": "WindowsWorldWritableWarningNotification", - "type": "object" + "properties": { + "extraCount": { + "type": "integer", + "format": "uint", + "minimum": 0.0 + }, + "failedScan": { + "type": "boolean" + }, + "samplePaths": { + "type": "array", + "items": { + "type": "string" + } + } + } } \ No newline at end of file diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/ClientRequest.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/ClientRequest.ts index 3468b184..847b06ad 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/ClientRequest.ts +++ b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/ClientRequest.ts @@ -39,7 +39,6 @@ import type { McpServerToolCallParams } from "./v2/McpServerToolCallParams"; import type { ModelListParams } from "./v2/ModelListParams"; import type { ReviewStartParams } from "./v2/ReviewStartParams"; import type { SendAddCreditsNudgeEmailParams } from "./v2/SendAddCreditsNudgeEmailParams"; -import type { SkillsConfigWriteParams } from "./v2/SkillsConfigWriteParams"; import type { SkillsListParams } from "./v2/SkillsListParams"; import type { ThreadApproveGuardianDeniedActionParams } from "./v2/ThreadApproveGuardianDeniedActionParams"; import type { ThreadArchiveParams } from "./v2/ThreadArchiveParams"; @@ -66,4 +65,4 @@ import type { WindowsSandboxSetupStartParams } from "./v2/WindowsSandboxSetupSta /** * Request from the client to the server. */ -export type ClientRequest ={ "method": "initialize", id: RequestId, params: InitializeParams, } | { "method": "thread/start", id: RequestId, params: ThreadStartParams, } | { "method": "thread/resume", id: RequestId, params: ThreadResumeParams, } | { "method": "thread/fork", id: RequestId, params: ThreadForkParams, } | { "method": "thread/archive", id: RequestId, params: ThreadArchiveParams, } | { "method": "thread/unsubscribe", id: RequestId, params: ThreadUnsubscribeParams, } | { "method": "thread/name/set", id: RequestId, params: ThreadSetNameParams, } | { "method": "thread/metadata/update", id: RequestId, params: ThreadMetadataUpdateParams, } | { "method": "thread/unarchive", id: RequestId, params: ThreadUnarchiveParams, } | { "method": "thread/compact/start", id: RequestId, params: ThreadCompactStartParams, } | { "method": "thread/shellCommand", id: RequestId, params: ThreadShellCommandParams, } | { "method": "thread/approveGuardianDeniedAction", id: RequestId, params: ThreadApproveGuardianDeniedActionParams, } | { "method": "thread/rollback", id: RequestId, params: ThreadRollbackParams, } | { "method": "thread/list", id: RequestId, params: ThreadListParams, } | { "method": "thread/loaded/list", id: RequestId, params: ThreadLoadedListParams, } | { "method": "thread/read", id: RequestId, params: ThreadReadParams, } | { "method": "thread/turns/list", id: RequestId, params: ThreadTurnsListParams, } | { "method": "thread/inject_items", id: RequestId, params: ThreadInjectItemsParams, } | { "method": "skills/list", id: RequestId, params: SkillsListParams, } | { "method": "device/key/create", id: RequestId, params: DeviceKeyCreateParams, } | { "method": "device/key/public", id: RequestId, params: DeviceKeyPublicParams, } | { "method": "device/key/sign", id: RequestId, params: DeviceKeySignParams, } | { "method": "fs/readFile", id: RequestId, params: FsReadFileParams, } | { "method": "fs/writeFile", id: RequestId, params: FsWriteFileParams, } | { "method": "fs/createDirectory", id: RequestId, params: FsCreateDirectoryParams, } | { "method": "fs/getMetadata", id: RequestId, params: FsGetMetadataParams, } | { "method": "fs/readDirectory", id: RequestId, params: FsReadDirectoryParams, } | { "method": "fs/remove", id: RequestId, params: FsRemoveParams, } | { "method": "fs/copy", id: RequestId, params: FsCopyParams, } | { "method": "fs/watch", id: RequestId, params: FsWatchParams, } | { "method": "fs/unwatch", id: RequestId, params: FsUnwatchParams, } | { "method": "skills/config/write", id: RequestId, params: SkillsConfigWriteParams, } | { "method": "turn/start", id: RequestId, params: TurnStartParams, } | { "method": "turn/steer", id: RequestId, params: TurnSteerParams, } | { "method": "turn/interrupt", id: RequestId, params: TurnInterruptParams, } | { "method": "review/start", id: RequestId, params: ReviewStartParams, } | { "method": "model/list", id: RequestId, params: ModelListParams, } | { "method": "experimentalFeature/list", id: RequestId, params: ExperimentalFeatureListParams, } | { "method": "experimentalFeature/enablement/set", id: RequestId, params: ExperimentalFeatureEnablementSetParams, } | { "method": "mcpServer/oauth/login", id: RequestId, params: McpServerOauthLoginParams, } | { "method": "config/mcpServer/reload", id: RequestId, params: undefined, } | { "method": "mcpServerStatus/list", id: RequestId, params: ListMcpServerStatusParams, } | { "method": "mcpServer/resource/read", id: RequestId, params: McpResourceReadParams, } | { "method": "mcpServer/tool/call", id: RequestId, params: McpServerToolCallParams, } | { "method": "windowsSandbox/setupStart", id: RequestId, params: WindowsSandboxSetupStartParams, } | { "method": "account/login/start", id: RequestId, params: LoginAccountParams, } | { "method": "account/login/cancel", id: RequestId, params: CancelLoginAccountParams, } | { "method": "account/logout", id: RequestId, params: undefined, } | { "method": "account/rateLimits/read", id: RequestId, params: undefined, } | { "method": "account/sendAddCreditsNudgeEmail", id: RequestId, params: SendAddCreditsNudgeEmailParams, } | { "method": "feedback/upload", id: RequestId, params: FeedbackUploadParams, } | { "method": "command/exec", id: RequestId, params: CommandExecParams, } | { "method": "command/exec/write", id: RequestId, params: CommandExecWriteParams, } | { "method": "command/exec/terminate", id: RequestId, params: CommandExecTerminateParams, } | { "method": "command/exec/resize", id: RequestId, params: CommandExecResizeParams, } | { "method": "config/read", id: RequestId, params: ConfigReadParams, } | { "method": "config/value/write", id: RequestId, params: ConfigValueWriteParams, } | { "method": "config/batchWrite", id: RequestId, params: ConfigBatchWriteParams, } | { "method": "configRequirements/read", id: RequestId, params: undefined, } | { "method": "account/read", id: RequestId, params: GetAccountParams, } | { "method": "getConversationSummary", id: RequestId, params: GetConversationSummaryParams, } | { "method": "gitDiffToRemote", id: RequestId, params: GitDiffToRemoteParams, } | { "method": "getAuthStatus", id: RequestId, params: GetAuthStatusParams, } | { "method": "fuzzyFileSearch", id: RequestId, params: FuzzyFileSearchParams, }; +export type ClientRequest ={ "method": "initialize", id: RequestId, params: InitializeParams, } | { "method": "thread/start", id: RequestId, params: ThreadStartParams, } | { "method": "thread/resume", id: RequestId, params: ThreadResumeParams, } | { "method": "thread/fork", id: RequestId, params: ThreadForkParams, } | { "method": "thread/archive", id: RequestId, params: ThreadArchiveParams, } | { "method": "thread/unsubscribe", id: RequestId, params: ThreadUnsubscribeParams, } | { "method": "thread/name/set", id: RequestId, params: ThreadSetNameParams, } | { "method": "thread/metadata/update", id: RequestId, params: ThreadMetadataUpdateParams, } | { "method": "thread/unarchive", id: RequestId, params: ThreadUnarchiveParams, } | { "method": "thread/compact/start", id: RequestId, params: ThreadCompactStartParams, } | { "method": "thread/shellCommand", id: RequestId, params: ThreadShellCommandParams, } | { "method": "thread/approveGuardianDeniedAction", id: RequestId, params: ThreadApproveGuardianDeniedActionParams, } | { "method": "thread/rollback", id: RequestId, params: ThreadRollbackParams, } | { "method": "thread/list", id: RequestId, params: ThreadListParams, } | { "method": "thread/loaded/list", id: RequestId, params: ThreadLoadedListParams, } | { "method": "thread/read", id: RequestId, params: ThreadReadParams, } | { "method": "thread/turns/list", id: RequestId, params: ThreadTurnsListParams, } | { "method": "thread/inject_items", id: RequestId, params: ThreadInjectItemsParams, } | { "method": "skills/list", id: RequestId, params: SkillsListParams, } | { "method": "device/key/create", id: RequestId, params: DeviceKeyCreateParams, } | { "method": "device/key/public", id: RequestId, params: DeviceKeyPublicParams, } | { "method": "device/key/sign", id: RequestId, params: DeviceKeySignParams, } | { "method": "fs/readFile", id: RequestId, params: FsReadFileParams, } | { "method": "fs/writeFile", id: RequestId, params: FsWriteFileParams, } | { "method": "fs/createDirectory", id: RequestId, params: FsCreateDirectoryParams, } | { "method": "fs/getMetadata", id: RequestId, params: FsGetMetadataParams, } | { "method": "fs/readDirectory", id: RequestId, params: FsReadDirectoryParams, } | { "method": "fs/remove", id: RequestId, params: FsRemoveParams, } | { "method": "fs/copy", id: RequestId, params: FsCopyParams, } | { "method": "fs/watch", id: RequestId, params: FsWatchParams, } | { "method": "fs/unwatch", id: RequestId, params: FsUnwatchParams, } | { "method": "turn/start", id: RequestId, params: TurnStartParams, } | { "method": "turn/steer", id: RequestId, params: TurnSteerParams, } | { "method": "turn/interrupt", id: RequestId, params: TurnInterruptParams, } | { "method": "review/start", id: RequestId, params: ReviewStartParams, } | { "method": "model/list", id: RequestId, params: ModelListParams, } | { "method": "experimentalFeature/list", id: RequestId, params: ExperimentalFeatureListParams, } | { "method": "experimentalFeature/enablement/set", id: RequestId, params: ExperimentalFeatureEnablementSetParams, } | { "method": "mcpServer/oauth/login", id: RequestId, params: McpServerOauthLoginParams, } | { "method": "config/mcpServer/reload", id: RequestId, params: undefined, } | { "method": "mcpServerStatus/list", id: RequestId, params: ListMcpServerStatusParams, } | { "method": "mcpServer/resource/read", id: RequestId, params: McpResourceReadParams, } | { "method": "mcpServer/tool/call", id: RequestId, params: McpServerToolCallParams, } | { "method": "windowsSandbox/setupStart", id: RequestId, params: WindowsSandboxSetupStartParams, } | { "method": "account/login/start", id: RequestId, params: LoginAccountParams, } | { "method": "account/login/cancel", id: RequestId, params: CancelLoginAccountParams, } | { "method": "account/logout", id: RequestId, params: undefined, } | { "method": "account/rateLimits/read", id: RequestId, params: undefined, } | { "method": "account/sendAddCreditsNudgeEmail", id: RequestId, params: SendAddCreditsNudgeEmailParams, } | { "method": "feedback/upload", id: RequestId, params: FeedbackUploadParams, } | { "method": "command/exec", id: RequestId, params: CommandExecParams, } | { "method": "command/exec/write", id: RequestId, params: CommandExecWriteParams, } | { "method": "command/exec/terminate", id: RequestId, params: CommandExecTerminateParams, } | { "method": "command/exec/resize", id: RequestId, params: CommandExecResizeParams, } | { "method": "config/read", id: RequestId, params: ConfigReadParams, } | { "method": "config/value/write", id: RequestId, params: ConfigValueWriteParams, } | { "method": "config/batchWrite", id: RequestId, params: ConfigBatchWriteParams, } | { "method": "configRequirements/read", id: RequestId, params: undefined, } | { "method": "account/read", id: RequestId, params: GetAccountParams, } | { "method": "getConversationSummary", id: RequestId, params: GetConversationSummaryParams, } | { "method": "gitDiffToRemote", id: RequestId, params: GitDiffToRemoteParams, } | { "method": "getAuthStatus", id: RequestId, params: GetAuthStatusParams, } | { "method": "fuzzyFileSearch", id: RequestId, params: FuzzyFileSearchParams, }; diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/ServerNotification.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/ServerNotification.ts index d0226b46..09438f44 100644 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/ServerNotification.ts +++ b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/ServerNotification.ts @@ -33,7 +33,6 @@ import type { ReasoningSummaryPartAddedNotification } from "./v2/ReasoningSummar import type { ReasoningSummaryTextDeltaNotification } from "./v2/ReasoningSummaryTextDeltaNotification"; import type { ReasoningTextDeltaNotification } from "./v2/ReasoningTextDeltaNotification"; import type { ServerRequestResolvedNotification } from "./v2/ServerRequestResolvedNotification"; -import type { SkillsChangedNotification } from "./v2/SkillsChangedNotification"; import type { TerminalInteractionNotification } from "./v2/TerminalInteractionNotification"; import type { ThreadArchivedNotification } from "./v2/ThreadArchivedNotification"; import type { ThreadClosedNotification } from "./v2/ThreadClosedNotification"; @@ -63,4 +62,4 @@ import type { WindowsWorldWritableWarningNotification } from "./v2/WindowsWorldW /** * Notification sent from the server to the client. */ -export type ServerNotification = { "method": "error", "params": ErrorNotification } | { "method": "thread/started", "params": ThreadStartedNotification } | { "method": "thread/status/changed", "params": ThreadStatusChangedNotification } | { "method": "thread/archived", "params": ThreadArchivedNotification } | { "method": "thread/unarchived", "params": ThreadUnarchivedNotification } | { "method": "thread/closed", "params": ThreadClosedNotification } | { "method": "skills/changed", "params": SkillsChangedNotification } | { "method": "thread/name/updated", "params": ThreadNameUpdatedNotification } | { "method": "thread/tokenUsage/updated", "params": ThreadTokenUsageUpdatedNotification } | { "method": "turn/started", "params": TurnStartedNotification } | { "method": "hook/started", "params": HookStartedNotification } | { "method": "turn/completed", "params": TurnCompletedNotification } | { "method": "hook/completed", "params": HookCompletedNotification } | { "method": "turn/diff/updated", "params": TurnDiffUpdatedNotification } | { "method": "turn/plan/updated", "params": TurnPlanUpdatedNotification } | { "method": "item/started", "params": ItemStartedNotification } | { "method": "item/autoApprovalReview/started", "params": ItemGuardianApprovalReviewStartedNotification } | { "method": "item/autoApprovalReview/completed", "params": ItemGuardianApprovalReviewCompletedNotification } | { "method": "item/completed", "params": ItemCompletedNotification } | { "method": "rawResponseItem/completed", "params": RawResponseItemCompletedNotification } | { "method": "item/agentMessage/delta", "params": AgentMessageDeltaNotification } | { "method": "item/plan/delta", "params": PlanDeltaNotification } | { "method": "command/exec/outputDelta", "params": CommandExecOutputDeltaNotification } | { "method": "item/commandExecution/outputDelta", "params": CommandExecutionOutputDeltaNotification } | { "method": "item/commandExecution/terminalInteraction", "params": TerminalInteractionNotification } | { "method": "item/fileChange/outputDelta", "params": FileChangeOutputDeltaNotification } | { "method": "item/fileChange/patchUpdated", "params": FileChangePatchUpdatedNotification } | { "method": "serverRequest/resolved", "params": ServerRequestResolvedNotification } | { "method": "item/mcpToolCall/progress", "params": McpToolCallProgressNotification } | { "method": "mcpServer/oauthLogin/completed", "params": McpServerOauthLoginCompletedNotification } | { "method": "mcpServer/startupStatus/updated", "params": McpServerStatusUpdatedNotification } | { "method": "account/updated", "params": AccountUpdatedNotification } | { "method": "account/rateLimits/updated", "params": AccountRateLimitsUpdatedNotification } | { "method": "fs/changed", "params": FsChangedNotification } | { "method": "item/reasoning/summaryTextDelta", "params": ReasoningSummaryTextDeltaNotification } | { "method": "item/reasoning/summaryPartAdded", "params": ReasoningSummaryPartAddedNotification } | { "method": "item/reasoning/textDelta", "params": ReasoningTextDeltaNotification } | { "method": "thread/compacted", "params": ContextCompactedNotification } | { "method": "model/rerouted", "params": ModelReroutedNotification } | { "method": "warning", "params": WarningNotification } | { "method": "guardianWarning", "params": GuardianWarningNotification } | { "method": "deprecationNotice", "params": DeprecationNoticeNotification } | { "method": "configWarning", "params": ConfigWarningNotification } | { "method": "thread/epiphany/stateUpdated", "params": ThreadEpiphanyStateUpdatedNotification } | { "method": "thread/epiphany/jobsUpdated", "params": ThreadEpiphanyJobsUpdatedNotification } | { "method": "fuzzyFileSearch/sessionUpdated", "params": FuzzyFileSearchSessionUpdatedNotification } | { "method": "fuzzyFileSearch/sessionCompleted", "params": FuzzyFileSearchSessionCompletedNotification } | { "method": "thread/realtime/started", "params": ThreadRealtimeStartedNotification } | { "method": "thread/realtime/itemAdded", "params": ThreadRealtimeItemAddedNotification } | { "method": "thread/realtime/transcript/delta", "params": ThreadRealtimeTranscriptDeltaNotification } | { "method": "thread/realtime/transcript/done", "params": ThreadRealtimeTranscriptDoneNotification } | { "method": "thread/realtime/outputAudio/delta", "params": ThreadRealtimeOutputAudioDeltaNotification } | { "method": "thread/realtime/sdp", "params": ThreadRealtimeSdpNotification } | { "method": "thread/realtime/error", "params": ThreadRealtimeErrorNotification } | { "method": "thread/realtime/closed", "params": ThreadRealtimeClosedNotification } | { "method": "windows/worldWritableWarning", "params": WindowsWorldWritableWarningNotification } | { "method": "windowsSandbox/setupCompleted", "params": WindowsSandboxSetupCompletedNotification } | { "method": "account/login/completed", "params": AccountLoginCompletedNotification }; +export type ServerNotification = { "method": "error", "params": ErrorNotification } | { "method": "thread/started", "params": ThreadStartedNotification } | { "method": "thread/status/changed", "params": ThreadStatusChangedNotification } | { "method": "thread/archived", "params": ThreadArchivedNotification } | { "method": "thread/unarchived", "params": ThreadUnarchivedNotification } | { "method": "thread/closed", "params": ThreadClosedNotification } | { "method": "thread/name/updated", "params": ThreadNameUpdatedNotification } | { "method": "thread/tokenUsage/updated", "params": ThreadTokenUsageUpdatedNotification } | { "method": "turn/started", "params": TurnStartedNotification } | { "method": "hook/started", "params": HookStartedNotification } | { "method": "turn/completed", "params": TurnCompletedNotification } | { "method": "hook/completed", "params": HookCompletedNotification } | { "method": "turn/diff/updated", "params": TurnDiffUpdatedNotification } | { "method": "turn/plan/updated", "params": TurnPlanUpdatedNotification } | { "method": "item/started", "params": ItemStartedNotification } | { "method": "item/autoApprovalReview/started", "params": ItemGuardianApprovalReviewStartedNotification } | { "method": "item/autoApprovalReview/completed", "params": ItemGuardianApprovalReviewCompletedNotification } | { "method": "item/completed", "params": ItemCompletedNotification } | { "method": "rawResponseItem/completed", "params": RawResponseItemCompletedNotification } | { "method": "item/agentMessage/delta", "params": AgentMessageDeltaNotification } | { "method": "item/plan/delta", "params": PlanDeltaNotification } | { "method": "command/exec/outputDelta", "params": CommandExecOutputDeltaNotification } | { "method": "item/commandExecution/outputDelta", "params": CommandExecutionOutputDeltaNotification } | { "method": "item/commandExecution/terminalInteraction", "params": TerminalInteractionNotification } | { "method": "item/fileChange/outputDelta", "params": FileChangeOutputDeltaNotification } | { "method": "item/fileChange/patchUpdated", "params": FileChangePatchUpdatedNotification } | { "method": "serverRequest/resolved", "params": ServerRequestResolvedNotification } | { "method": "item/mcpToolCall/progress", "params": McpToolCallProgressNotification } | { "method": "mcpServer/oauthLogin/completed", "params": McpServerOauthLoginCompletedNotification } | { "method": "mcpServer/startupStatus/updated", "params": McpServerStatusUpdatedNotification } | { "method": "account/updated", "params": AccountUpdatedNotification } | { "method": "account/rateLimits/updated", "params": AccountRateLimitsUpdatedNotification } | { "method": "fs/changed", "params": FsChangedNotification } | { "method": "item/reasoning/summaryTextDelta", "params": ReasoningSummaryTextDeltaNotification } | { "method": "item/reasoning/summaryPartAdded", "params": ReasoningSummaryPartAddedNotification } | { "method": "item/reasoning/textDelta", "params": ReasoningTextDeltaNotification } | { "method": "thread/compacted", "params": ContextCompactedNotification } | { "method": "model/rerouted", "params": ModelReroutedNotification } | { "method": "warning", "params": WarningNotification } | { "method": "guardianWarning", "params": GuardianWarningNotification } | { "method": "deprecationNotice", "params": DeprecationNoticeNotification } | { "method": "configWarning", "params": ConfigWarningNotification } | { "method": "thread/epiphany/stateUpdated", "params": ThreadEpiphanyStateUpdatedNotification } | { "method": "thread/epiphany/jobsUpdated", "params": ThreadEpiphanyJobsUpdatedNotification } | { "method": "fuzzyFileSearch/sessionUpdated", "params": FuzzyFileSearchSessionUpdatedNotification } | { "method": "fuzzyFileSearch/sessionCompleted", "params": FuzzyFileSearchSessionCompletedNotification } | { "method": "thread/realtime/started", "params": ThreadRealtimeStartedNotification } | { "method": "thread/realtime/itemAdded", "params": ThreadRealtimeItemAddedNotification } | { "method": "thread/realtime/transcript/delta", "params": ThreadRealtimeTranscriptDeltaNotification } | { "method": "thread/realtime/transcript/done", "params": ThreadRealtimeTranscriptDoneNotification } | { "method": "thread/realtime/outputAudio/delta", "params": ThreadRealtimeOutputAudioDeltaNotification } | { "method": "thread/realtime/sdp", "params": ThreadRealtimeSdpNotification } | { "method": "thread/realtime/error", "params": ThreadRealtimeErrorNotification } | { "method": "thread/realtime/closed", "params": ThreadRealtimeClosedNotification } | { "method": "windows/worldWritableWarning", "params": WindowsWorldWritableWarningNotification } | { "method": "windowsSandbox/setupCompleted", "params": WindowsSandboxSetupCompletedNotification } | { "method": "account/login/completed", "params": AccountLoginCompletedNotification }; diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/SkillsChangedNotification.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/SkillsChangedNotification.ts deleted file mode 100644 index 23ed93a5..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/SkillsChangedNotification.ts +++ /dev/null @@ -1,11 +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. - -/** - * Notification emitted when watched local skill files change. - * - * Treat this as an invalidation signal and re-run `skills/list` with the - * client's current parameters when refreshed skill metadata is needed. - */ -export type SkillsChangedNotification = Record; diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteParams.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteParams.ts deleted file mode 100644 index 39192e07..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteParams.ts +++ /dev/null @@ -1,14 +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"; - -export type SkillsConfigWriteParams = { -/** - * Path-based selector. - */ -path?: AbsolutePathBuf | null, -/** - * Name-based selector. - */ -name?: string | null, enabled: boolean, }; diff --git a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteResponse.ts b/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteResponse.ts deleted file mode 100644 index c0e8ef7c..00000000 --- a/vendor/codex/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteResponse.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 SkillsConfigWriteResponse = { effectiveEnabled: boolean, }; 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 d638016c..7b91bfa4 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 @@ -251,9 +251,6 @@ export type { SkillInterface } from "./SkillInterface"; export type { SkillMetadata } from "./SkillMetadata"; export type { SkillScope } from "./SkillScope"; export type { SkillToolDependency } from "./SkillToolDependency"; -export type { SkillsChangedNotification } from "./SkillsChangedNotification"; -export type { SkillsConfigWriteParams } from "./SkillsConfigWriteParams"; -export type { SkillsConfigWriteResponse } from "./SkillsConfigWriteResponse"; export type { SkillsListEntry } from "./SkillsListEntry"; export type { SkillsListExtraRootsForCwd } from "./SkillsListExtraRootsForCwd"; export type { SkillsListParams } from "./SkillsListParams"; diff --git a/vendor/codex/codex-rs/app-server-protocol/src/protocol/common.rs b/vendor/codex/codex-rs/app-server-protocol/src/protocol/common.rs index 28ed92f6..19ccefeb 100644 --- a/vendor/codex/codex-rs/app-server-protocol/src/protocol/common.rs +++ b/vendor/codex/codex-rs/app-server-protocol/src/protocol/common.rs @@ -487,10 +487,6 @@ client_request_definitions! { params: v2::FsUnwatchParams, response: v2::FsUnwatchResponse, }, - SkillsConfigWrite => "skills/config/write" { - params: v2::SkillsConfigWriteParams, - response: v2::SkillsConfigWriteResponse, - }, TurnStart => "turn/start" { params: v2::TurnStartParams, inspect_params: true, @@ -1075,7 +1071,6 @@ server_notification_definitions! { ThreadArchived => "thread/archived" (v2::ThreadArchivedNotification), ThreadUnarchived => "thread/unarchived" (v2::ThreadUnarchivedNotification), ThreadClosed => "thread/closed" (v2::ThreadClosedNotification), - SkillsChanged => "skills/changed" (v2::SkillsChangedNotification), ThreadNameUpdated => "thread/name/updated" (v2::ThreadNameUpdatedNotification), ThreadTokenUsageUpdated => "thread/tokenUsage/updated" (v2::ThreadTokenUsageUpdatedNotification), TurnStarted => "turn/started" (v2::TurnStartedNotification), 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 98ffd41c..5e1f9ea7 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 @@ -5585,26 +5585,6 @@ pub struct SkillsListEntry { pub errors: Vec, } -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct SkillsConfigWriteParams { - /// Path-based selector. - #[ts(optional = nullable)] - pub path: Option, - /// Name-based selector. - #[ts(optional = nullable)] - pub name: Option, - pub enabled: bool, -} - -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -pub struct SkillsConfigWriteResponse { - pub effective_enabled: bool, -} - impl From for SkillMetadata { fn from(value: CoreSkillMetadata) -> Self { Self { @@ -7317,15 +7297,6 @@ pub struct ThreadClosedNotification { pub thread_id: String, } -#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] -#[serde(rename_all = "camelCase")] -#[ts(export_to = "v2/")] -/// Notification emitted when watched local skill files change. -/// -/// Treat this as an invalidation signal and re-run `skills/list` with the -/// client's current parameters when refreshed skill metadata is needed. -pub struct SkillsChangedNotification {} - #[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)] #[serde(rename_all = "camelCase")] #[ts(export_to = "v2/")] diff --git a/vendor/codex/codex-rs/app-server/README.md b/vendor/codex/codex-rs/app-server/README.md index 81a8b4d6..14de33d5 100644 --- a/vendor/codex/codex-rs/app-server/README.md +++ b/vendor/codex/codex-rs/app-server/README.md @@ -200,11 +200,9 @@ Experimental Epiphany retrieval: - `experimentalFeature/enablement/set` — patch the in-memory process-wide runtime feature enablement for supported feature keys. For each feature, precedence is: cloud requirements > --enable > config.toml > experimentalFeature/enablement/set (new) > code default. - `collaborationMode/list` — list available collaboration mode presets (experimental, no pagination). This response omits built-in developer instructions; clients should either pass `settings.developer_instructions: null` when setting a mode to use Codex's built-in instructions, or provide their own instructions explicitly. - `skills/list` — list skills for one or more `cwd` values (optional `forceReload`). -- `skills/changed` — notification emitted when watched local skill files change. - `device/key/create` — create or load a controller-local device signing key for an account/client binding. This local-key API is available only over local transports such as stdio and in-process; remote transports reject it. Hardware-backed providers are the target protection class; an OS-protected non-extractable fallback is allowed only with `protectionPolicy: "allow_os_protected_nonextractable"` and returns the reported `protectionClass`. - `device/key/public` — return a device key's SPKI DER public key as base64 plus its `algorithm` and `protectionClass`. - `device/key/sign` — sign one of the accepted structured payload variants with a controller-local device key. The only accepted payload today is `remoteControlClientConnection`, which binds a server-issued `/client` websocket challenge to the enrolled controller device without signing the bearer token itself; this is intentionally not an arbitrary-byte signing API. -- `skills/config/write` — write user-level skill config by name or absolute path. - `mcpServer/oauth/login` — start an OAuth login for a configured MCP server; returns an `authorization_url` and later emits `mcpServer/oauthLogin/completed` once the browser flow finishes. - `tool/requestUserInput` — prompt the user with 1–3 short questions for a tool call and return their answers (experimental). - `config/mcpServer/reload` — reload MCP server config from disk and queue a refresh for loaded threads (applied on each thread's next active turn); returns `{}`. Use this after editing `config.toml` without restarting the server. @@ -1273,8 +1271,7 @@ $skill-creator Add a new skill for triaging flaky CI and include step-by-step us Use `skills/list` to fetch the available skills (optionally scoped by `cwds`, with `forceReload`). You can also add `perCwdExtraUserRoots` to scan additional absolute paths as `user` scope for specific `cwd` entries. Entries whose `cwd` is not present in `cwds` are ignored. -`skills/list` might reuse a cached skills result per `cwd`; setting `forceReload` to `true` refreshes the result from disk. -The server also emits `skills/changed` notifications when watched local skill files change. Treat this as an invalidation signal and re-run `skills/list` with your current params when needed. +`skills/list` returns the current compatibility skill projection for each requested `cwd`. ```json { "method": "skills/list", "id": 25, "params": { @@ -1310,41 +1307,6 @@ The server also emits `skills/changed` notifications when watched local skill fi } } ``` -```json -{ - "method": "skills/changed", - "params": {} -} -``` - -To enable or disable a skill by absolute path: - -```json -{ - "method": "skills/config/write", - "id": 26, - "params": { - "path": "/Users/alice/.codex/skills/skill-creator/SKILL.md", - "name": null, - "enabled": false - } -} -``` - -To enable or disable a skill by name: - -```json -{ - "method": "skills/config/write", - "id": 27, - "params": { - "path": null, - "name": "github:yeet", - "enabled": false - } -} -``` - ## Auth endpoints The JSON-RPC auth/account surface exposes request/response methods plus server-initiated notifications (no `id`). Use these to determine auth state, start or cancel logins, logout, and inspect ChatGPT rate limits. diff --git a/vendor/codex/codex-rs/app-server/src/bespoke_event_handling.rs b/vendor/codex/codex-rs/app-server/src/bespoke_event_handling.rs index 21516e37..0420fd94 100644 --- a/vendor/codex/codex-rs/app-server/src/bespoke_event_handling.rs +++ b/vendor/codex/codex-rs/app-server/src/bespoke_event_handling.rs @@ -77,7 +77,6 @@ use codex_app_server_protocol::ReasoningTextDeltaNotification; use codex_app_server_protocol::RequestId; use codex_app_server_protocol::ServerNotification; use codex_app_server_protocol::ServerRequestPayload; -use codex_app_server_protocol::SkillsChangedNotification; use codex_app_server_protocol::TerminalInteractionNotification; use codex_app_server_protocol::ThreadItem; use codex_app_server_protocol::ThreadNameUpdatedNotification; @@ -256,15 +255,6 @@ pub(crate) async fn apply_bespoke_event_handling( .await; } } - EventMsg::SkillsUpdateAvailable => { - if let ApiVersion::V2 = api_version { - outgoing - .send_server_notification(ServerNotification::SkillsChanged( - SkillsChangedNotification {}, - )) - .await; - } - } EventMsg::McpStartupUpdate(update) => { if let ApiVersion::V2 = api_version { let (status, error) = match update.status { diff --git a/vendor/codex/codex-rs/app-server/src/codex_message_processor.rs b/vendor/codex/codex-rs/app-server/src/codex_message_processor.rs index 8ced5fd5..103dfd4a 100644 --- a/vendor/codex/codex-rs/app-server/src/codex_message_processor.rs +++ b/vendor/codex/codex-rs/app-server/src/codex_message_processor.rs @@ -113,7 +113,6 @@ use codex_app_server_protocol::SendAddCreditsNudgeEmailParams; use codex_app_server_protocol::SendAddCreditsNudgeEmailResponse; use codex_app_server_protocol::ServerNotification; use codex_app_server_protocol::ServerRequestResolvedNotification; -use codex_app_server_protocol::SkillsConfigWriteParams; use codex_app_server_protocol::SkillsListParams; use codex_app_server_protocol::SkillsListResponse; use codex_app_server_protocol::SortDirection; @@ -998,10 +997,6 @@ impl CodexMessageProcessor { self.skills_list(to_connection_request_id(request_id), params) .await; } - ClientRequest::SkillsConfigWrite { request_id, params } => { - self.skills_config_write(to_connection_request_id(request_id), params) - .await; - } ClientRequest::TurnStart { request_id, params } => { self.turn_start( to_connection_request_id(request_id), @@ -6156,18 +6151,6 @@ impl CodexMessageProcessor { self.outgoing.send_error(request_id, error).await; } - async fn send_codex_product_surface_disabled( - &self, - request_id: ConnectionRequestId, - method: &str, - ) { - self.send_invalid_request_error( - request_id, - format!("{method} is disabled in Epiphany's vestigial Codex organ"), - ) - .await; - } - async fn wait_for_thread_shutdown(thread: &Arc) -> ThreadShutdownResult { match tokio::time::timeout(Duration::from_secs(10), thread.shutdown_and_wait()).await { Ok(Ok(())) => ThreadShutdownResult::Complete, @@ -6325,15 +6308,6 @@ impl CodexMessageProcessor { .await; } - async fn skills_config_write( - &self, - request_id: ConnectionRequestId, - _params: SkillsConfigWriteParams, - ) { - self.send_codex_product_surface_disabled(request_id, "skills/config/write") - .await; - } - async fn turn_start( &self, request_id: ConnectionRequestId, diff --git a/vendor/codex/codex-rs/core/src/session/turn.rs b/vendor/codex/codex-rs/core/src/session/turn.rs index ddf56fb2..daa58e3d 100644 --- a/vendor/codex/codex-rs/core/src/session/turn.rs +++ b/vendor/codex/codex-rs/core/src/session/turn.rs @@ -1152,7 +1152,6 @@ pub(super) fn realtime_text_for_event(msg: &EventMsg) -> Option { | EventMsg::McpListToolsResponse(_) | EventMsg::ListSkillsResponse(_) | EventMsg::RealtimeConversationListVoicesResponse(_) - | EventMsg::SkillsUpdateAvailable | EventMsg::PlanUpdate(_) | EventMsg::TurnAborted(_) | EventMsg::ShutdownComplete diff --git a/vendor/codex/codex-rs/core/tests/suite/client.rs b/vendor/codex/codex-rs/core/tests/suite/client.rs index 0784c9ff..170bf657 100644 --- a/vendor/codex/codex-rs/core/tests/suite/client.rs +++ b/vendor/codex/codex-rs/core/tests/suite/client.rs @@ -45,7 +45,6 @@ use codex_protocol::protocol::SessionMeta; use codex_protocol::protocol::SessionMetaLine; use codex_protocol::protocol::SessionSource; use codex_protocol::user_input::UserInput; -use core_test_support::PathBufExt; use core_test_support::load_default_config_for_test; use core_test_support::responses::ResponsesRequest; use core_test_support::responses::ev_completed; @@ -62,7 +61,6 @@ use core_test_support::skip_if_no_network; use core_test_support::test_codex::TestCodex; use core_test_support::test_codex::test_codex; use core_test_support::wait_for_event; -use dunce::canonicalize as normalize_path; use futures::StreamExt; use pretty_assertions::assert_eq; use serde_json::json; @@ -1251,74 +1249,6 @@ async fn omits_environment_context_when_configured_off() { ); } -#[tokio::test(flavor = "multi_thread", worker_threads = 2)] -async fn skills_append_to_developer_message() { - skip_if_no_network!(); - let server = MockServer::start().await; - - let resp_mock = mount_sse_once( - &server, - sse(vec![ev_response_created("resp1"), ev_completed("resp1")]), - ) - .await; - - let codex_home = Arc::new(TempDir::new().unwrap()); - let skill_dir = codex_home.path().join("skills/demo"); - std::fs::create_dir_all(&skill_dir).expect("create skill dir"); - std::fs::write( - skill_dir.join("SKILL.md"), - "---\nname: demo\ndescription: build charts\n---\n\n# body\n", - ) - .expect("write skill"); - - let codex_home_path = codex_home.path().to_path_buf(); - let mut builder = test_codex() - .with_home(codex_home.clone()) - .with_auth(CodexAuth::from_api_key("Test API Key")) - .with_config(move |config| { - config.cwd = codex_home_path.abs(); - }); - let codex = builder - .build(&server) - .await - .expect("create new conversation") - .codex; - - codex - .submit(Op::UserInput { - environments: None, - items: vec![UserInput::Text { - text: "hello".into(), - text_elements: Vec::new(), - }], - final_output_json_schema: None, - responsesapi_client_metadata: None, - }) - .await - .unwrap(); - - wait_for_event(&codex, |ev| matches!(ev, EventMsg::TurnComplete(_))).await; - - let request = resp_mock.single_request(); - let developer_messages = request.message_input_texts("developer"); - let developer_text = developer_messages.join("\n\n"); - assert!( - developer_text.contains("## Skills"), - "expected skills section present: {developer_messages:?}" - ); - assert!( - developer_text.contains("demo: build charts"), - "expected skill summary: {developer_messages:?}" - ); - let expected_path = normalize_path(skill_dir.join("SKILL.md")).unwrap(); - let expected_path_str = expected_path.to_string_lossy().replace('\\', "/"); - assert!( - developer_text.contains(&expected_path_str), - "expected path {expected_path_str} in developer message: {developer_messages:?}" - ); - let _codex_home_guard = codex_home; -} - #[tokio::test(flavor = "multi_thread", worker_threads = 2)] async fn includes_configured_effort_in_request() -> anyhow::Result<()> { skip_if_no_network!(Ok(())); diff --git a/vendor/codex/codex-rs/core/tests/suite/live_reload.rs b/vendor/codex/codex-rs/core/tests/suite/live_reload.rs deleted file mode 100644 index cfafdea3..00000000 --- a/vendor/codex/codex-rs/core/tests/suite/live_reload.rs +++ /dev/null @@ -1,153 +0,0 @@ -#![allow(clippy::expect_used, clippy::unwrap_used)] - -use std::fs; -use std::path::Path; -use std::path::PathBuf; -use std::time::Duration; - -use anyhow::Result; -use codex_config::config_toml::ProjectConfig; -use codex_protocol::config_types::TrustLevel; -use codex_protocol::protocol::AskForApproval; -use codex_protocol::protocol::EventMsg; -use codex_protocol::protocol::Op; -use codex_protocol::protocol::SandboxPolicy; -use codex_protocol::user_input::UserInput; -use core_test_support::responses; -use core_test_support::responses::ResponsesRequest; -use core_test_support::responses::mount_sse_sequence; -use core_test_support::responses::start_mock_server; -use core_test_support::test_codex::TestCodex; -use core_test_support::test_codex::test_codex; -use core_test_support::wait_for_event; -use tokio::time::timeout; - -fn enable_trusted_project(config: &mut codex_core::config::Config) { - config.active_project = ProjectConfig { - trust_level: Some(TrustLevel::Trusted), - }; -} - -fn write_skill(home: &Path, name: &str, description: &str, body: &str) -> PathBuf { - let skill_dir = home.join("skills").join(name); - fs::create_dir_all(&skill_dir).expect("create skill dir"); - let contents = format!("---\nname: {name}\ndescription: {description}\n---\n\n{body}\n"); - let path = skill_dir.join("SKILL.md"); - fs::write(&path, contents).expect("write skill"); - path -} - -fn contains_skill_body(request: &ResponsesRequest, skill_body: &str) -> bool { - request - .message_input_texts("user") - .iter() - .any(|text| text.contains(skill_body) && text.contains("")) -} - -async fn submit_skill_turn(test: &TestCodex, skill_path: PathBuf, prompt: &str) -> Result<()> { - let session_model = test.session_configured.model.clone(); - test.codex - .submit(Op::UserTurn { - environments: None, - items: vec![ - UserInput::Text { - text: prompt.to_string(), - text_elements: Vec::new(), - }, - UserInput::Skill { - name: "demo".to_string(), - path: skill_path, - }, - ], - final_output_json_schema: None, - cwd: test.cwd_path().to_path_buf(), - approval_policy: AskForApproval::Never, - approvals_reviewer: None, - sandbox_policy: SandboxPolicy::DangerFullAccess, - model: session_model, - effort: None, - summary: None, - service_tier: None, - collaboration_mode: None, - personality: None, - }) - .await?; - - wait_for_event(test.codex.as_ref(), |event| { - matches!(event, EventMsg::TurnComplete(_)) - }) - .await; - Ok(()) -} - -#[tokio::test(flavor = "multi_thread", worker_threads = 2)] -async fn live_skills_reload_refreshes_skill_cache_after_skill_change() -> Result<()> { - let server = start_mock_server().await; - let responses = mount_sse_sequence( - &server, - vec![ - responses::sse(vec![responses::ev_completed("resp-1")]), - responses::sse(vec![responses::ev_completed("resp-2")]), - ], - ) - .await; - - let skill_v1 = "skill body v1"; - let skill_v2 = "skill body v2"; - let mut builder = test_codex() - .with_pre_build_hook(move |home| { - write_skill(home, "demo", "demo skill", skill_v1); - }) - .with_config(|config| { - enable_trusted_project(config); - }); - let test = builder.build(&server).await?; - - let skill_path = dunce::canonicalize(test.codex_home_path().join("skills/demo/SKILL.md"))?; - - submit_skill_turn(&test, skill_path.clone(), "please use $demo").await?; - let first_request = responses - .requests() - .first() - .cloned() - .expect("first request captured"); - assert!( - contains_skill_body(&first_request, skill_v1), - "expected initial skill body in request" - ); - - write_skill(test.codex_home_path(), "demo", "demo skill", skill_v2); - - let saw_skills_update = timeout(Duration::from_secs(5), async { - loop { - match test.codex.next_event().await { - Ok(event) => { - if matches!(event.msg, EventMsg::SkillsUpdateAvailable) { - break; - } - } - Err(err) => panic!("event stream ended unexpectedly: {err}"), - } - } - }) - .await; - - if saw_skills_update.is_err() { - // Some environments do not reliably surface file watcher events for - // skill changes. Clear the cache explicitly so we can still validate - // that the updated skill body is injected on the next turn. - test.thread_manager.skills_manager().clear_cache(); - } - - submit_skill_turn(&test, skill_path.clone(), "please use $demo again").await?; - let last_request = responses - .last_request() - .expect("request captured after skill update"); - - assert!( - contains_skill_body(&last_request, skill_v2), - "expected updated skill body after reload" - ); - - Ok(()) -} diff --git a/vendor/codex/codex-rs/core/tests/suite/mod.rs b/vendor/codex/codex-rs/core/tests/suite/mod.rs index e569368b..73e18725 100644 --- a/vendor/codex/codex-rs/core/tests/suite/mod.rs +++ b/vendor/codex/codex-rs/core/tests/suite/mod.rs @@ -51,7 +51,6 @@ mod items; mod js_repl; mod json_result; mod live_cli; -mod live_reload; mod memories; mod model_overrides; mod model_switching; diff --git a/vendor/codex/codex-rs/mcp-server/src/codex_tool_runner.rs b/vendor/codex/codex-rs/mcp-server/src/codex_tool_runner.rs index 039aab66..e0ed2d17 100644 --- a/vendor/codex/codex-rs/mcp-server/src/codex_tool_runner.rs +++ b/vendor/codex/codex-rs/mcp-server/src/codex_tool_runner.rs @@ -371,7 +371,6 @@ async fn run_codex_tool_session_inner( | EventMsg::AgentMessageContentDelta(_) | EventMsg::ReasoningContentDelta(_) | EventMsg::ReasoningRawContentDelta(_) - | EventMsg::SkillsUpdateAvailable | EventMsg::UndoStarted(_) | EventMsg::UndoCompleted(_) | EventMsg::ExitedReviewMode(_) diff --git a/vendor/codex/codex-rs/protocol/src/protocol.rs b/vendor/codex/codex-rs/protocol/src/protocol.rs index 981a2dbd..10141719 100644 --- a/vendor/codex/codex-rs/protocol/src/protocol.rs +++ b/vendor/codex/codex-rs/protocol/src/protocol.rs @@ -1674,9 +1674,6 @@ pub enum EventMsg { /// List of voices supported by realtime conversation streams. RealtimeConversationListVoicesResponse(RealtimeConversationListVoicesResponseEvent), - /// Notification that skill data may have been updated and clients may want to reload. - SkillsUpdateAvailable, - PlanUpdate(UpdatePlanArgs), TurnAborted(TurnAbortedEvent), diff --git a/vendor/codex/codex-rs/rollout/src/policy.rs b/vendor/codex/codex-rs/rollout/src/policy.rs index cca18b40..cfc234de 100644 --- a/vendor/codex/codex-rs/rollout/src/policy.rs +++ b/vendor/codex/codex-rs/rollout/src/policy.rs @@ -177,7 +177,6 @@ fn event_msg_persistence_mode(ev: &EventMsg) -> Option { | EventMsg::PlanDelta(_) | EventMsg::ReasoningContentDelta(_) | EventMsg::ReasoningRawContentDelta(_) - | EventMsg::SkillsUpdateAvailable | EventMsg::CollabAgentSpawnBegin(_) | EventMsg::CollabAgentInteractionBegin(_) | EventMsg::CollabWaitingBegin(_) diff --git a/vendor/codex/codex-rs/tui/src/app/app_server_adapter.rs b/vendor/codex/codex-rs/tui/src/app/app_server_adapter.rs index 602504e2..b0f79b4a 100644 --- a/vendor/codex/codex-rs/tui/src/app/app_server_adapter.rs +++ b/vendor/codex/codex-rs/tui/src/app/app_server_adapter.rs @@ -418,8 +418,7 @@ fn server_notification_thread_target( } ServerNotification::Warning(notification) => notification.thread_id.as_deref(), ServerNotification::GuardianWarning(notification) => Some(notification.thread_id.as_str()), - ServerNotification::SkillsChanged(_) - | ServerNotification::McpServerStatusUpdated(_) + ServerNotification::McpServerStatusUpdated(_) | ServerNotification::McpServerOauthLoginCompleted(_) | ServerNotification::AccountUpdated(_) | ServerNotification::AccountRateLimitsUpdated(_) diff --git a/vendor/codex/codex-rs/tui/src/app/tests.rs b/vendor/codex/codex-rs/tui/src/app/tests.rs index b527402a..ac6b49d3 100644 --- a/vendor/codex/codex-rs/tui/src/app/tests.rs +++ b/vendor/codex/codex-rs/tui/src/app/tests.rs @@ -3390,9 +3390,10 @@ async fn active_non_primary_shutdown_target_returns_none_for_non_shutdown_event( app.primary_thread_id = Some(ThreadId::new()); assert_eq!( - app.active_non_primary_shutdown_target(&ServerNotification::SkillsChanged( - codex_app_server_protocol::SkillsChangedNotification {}, - )), + app.active_non_primary_shutdown_target(&ServerNotification::Warning(WarningNotification { + thread_id: None, + message: "test warning".to_string(), + },)), None ); Ok(()) diff --git a/vendor/codex/codex-rs/tui/src/chatwidget.rs b/vendor/codex/codex-rs/tui/src/chatwidget.rs index 38e34d70..f7823d9f 100644 --- a/vendor/codex/codex-rs/tui/src/chatwidget.rs +++ b/vendor/codex/codex-rs/tui/src/chatwidget.rs @@ -6436,9 +6436,6 @@ impl ChatWidget { ); } } - ServerNotification::SkillsChanged(_) => { - self.refresh_skills_for_current_cwd(/*force_reload*/ true); - } ServerNotification::ModelRerouted(_) => {} ServerNotification::Warning(notification) => self.on_warning(notification.message), ServerNotification::GuardianWarning(notification) => { @@ -7018,9 +7015,6 @@ impl ChatWidget { EventMsg::GetHistoryEntryResponse(ev) => self.handle_history_entry_response(ev), EventMsg::McpListToolsResponse(ev) => self.on_list_mcp_tools(ev), EventMsg::ListSkillsResponse(ev) => self.on_list_skills(ev), - EventMsg::SkillsUpdateAvailable => { - self.refresh_skills_for_current_cwd(/*force_reload*/ true); - } EventMsg::ShutdownComplete => self.on_shutdown_complete(), EventMsg::TurnDiff(TurnDiffEvent { unified_diff }) => self.on_turn_diff(unified_diff), EventMsg::DeprecationNotice(ev) => self.on_deprecation_notice(ev),