Files
codex/codex-rs/app-server-protocol/schema/json/v2/AppsInstalledResponse.json
Matthew Zeng a238b753af Add an API for reading installed app runtime state (#33843)
## What changed

- Add `app/installed` to return each connector observed in the committed runtime tool snapshot, including its runtime name and effective `enabled` and `callable` state.
- Support evaluating thread-specific configuration with `threadId` and refreshing the hosted connector tool snapshot with `forceRefresh`.
- Preserve observed connector identities as disabled when global or workspace policy disables Apps, and retain the previous snapshot when a refresh fails.

## Testing

- Cover cached and forced reads, policy and configuration filtering, thread-specific configuration, snapshot refresh failures, and protocol serialization.

GitOrigin-RevId: f697b6fb501b7d329a169e947a1c1607806222fe
2026-07-17 15:23:35 +00:00

48 lines
1.3 KiB
JSON
Generated

{
"$schema": "http://json-schema.org/draft-07/schema#",
"definitions": {
"InstalledApp": {
"description": "Installed connector runtime state.",
"properties": {
"callable": {
"description": "Whether the connector is enabled and has a non-synthetic, model-visible tool allowed by effective MCP and app/tool policy in the committed runtime snapshot.",
"type": "boolean"
},
"enabled": {
"description": "Effective enabled state after applying global, workspace, local, and managed configuration at read time.",
"type": "boolean"
},
"id": {
"type": "string"
},
"runtimeName": {
"description": "Best-effort name carried by the runtime tool catalog. Canonical app metadata remains owned by `app/read`.",
"type": [
"string",
"null"
]
}
},
"required": [
"callable",
"enabled",
"id"
],
"type": "object"
}
},
"description": "The installed connectors in one committed runtime snapshot.",
"properties": {
"apps": {
"items": {
"$ref": "#/definitions/InstalledApp"
},
"type": "array"
}
},
"required": [
"apps"
],
"title": "AppsInstalledResponse",
"type": "object"
}