One of the following:
class None { type }

The session talks to CCA without selecting or provisioning an execution environment.

type: :none

The type of the object. Always none.

class OpenAIHosted { id, capability_directories, files, 7 more }

An environment hosted by OpenAI.

id: String

The public ID of the environment.

minLength0
capability_directories: Array[String]

Directories that contain capabilities exposed to the agent.

minItems0
maxItems2000
files: Array[HostedEnvironmentFile]

Files available in the environment, excluding their contents.

minItems0
maxItems50
One of the following:
class HostedEnvironmentFileID { id, file_id, path, 2 more }

A file copied from the OpenAI Files API.

id: String

The session-scoped ID of the file in the execution environment.

minLength0
file_id: String

The ID of the uploaded file.

minLength0
path: String

The file’s absolute path inside the environment.

minLength0
size_bytes: Integer

The decoded file size in bytes.

formatint64
minimum0
type: :file_id

The type of the object. Always file_id.

class Inline { id, path, size_bytes, type }

A file supplied inline when the session was created.

id: String

The session-scoped ID of the file in the execution environment.

minLength0
path: String

The file’s absolute path inside the environment.

minLength0
size_bytes: Integer

The decoded file size in bytes.

formatint64
minimum0
type: :inline

The type of the object. Always inline.

network: Network{ access, allowed_domains}

The effective network access policy for the environment.

access: :enabled | :disabled | :restricted

The environment’s network access mode.

One of the following:
:enabled

Allows unrestricted network access.

:disabled

Disables network access.

:restricted

Applies the configured domain restrictions.

allowed_domains: Array[String]

Domains the environment may access when network access is restricted.

minItems0
maxItems2000
packages: Packages{ npm, python, system_}

Packages installed in the environment.

npm: Array[String]

npm packages installed globally in the environment.

minItems0
maxItems16384
python: Array[String]

Python packages installed in the environment.

minItems0
maxItems16384
system_: Array[String]

System packages installed in the environment.

minItems0
maxItems16384
plugins: Array[HostedPlugin { description, name, type } ]

Plugins installed in the environment, excluding their archive contents.

minItems0
maxItems2000
description: String

The installed plugin description.

minLength0
name: String

The installed plugin name.

minLength0
type: :inline

The type of the object. Always inline.

skills: Array[HostedSkill]

Skills installed in the environment, excluding their archive contents.

minItems0
maxItems2000
One of the following:
class HostedSkillReference { description, name, skill_id, 2 more }

A skill installed from the Skills API.

description: String

The installed skill description.

minLength0
name: String

The installed skill name.

minLength0
skill_id: String

The referenced skill ID.

minLength0
type: :skill_reference

The type of the object. Always skill_reference.

version: String

The concrete skill version installed for this session.

minLength0
class Inline { description, name, type }

A skill installed from an inline ZIP archive.

description: String

The installed skill description.

minLength0
name: String

The installed skill name.

minLength0
type: :inline

The type of the object. Always inline.

type: :openai_hosted

The type of the object. Always openai_hosted.

container_size: :small | :medium | :large

The effective CPU and memory tier, or null when unknown or outside the public tiers.

One of the following:
:small
:medium
:large
desktop: Desktop{ enabled}

The effective desktop configuration.

enabled: bool

Whether the environment provisions a desktop and browser proxy.

class SelfHosted { id, capability_directories, remote_url, 2 more }

An environment hosted by the application.

id: String

The public ID of the environment.

minLength0
capability_directories: Array[String]

Directories that contain capabilities exposed to the agent.

minItems0
maxItems2000
remote_url: String

Pass this URL unchanged to codex exec-server --remote when connecting this environment.

minLength0
type: :self_hosted

The type of the object. Always self_hosted.

workspace_directory: String

The absolute project directory inside the environment. Defaults to /workspace.

minLength0