@weavecode/weave 0.1.2 → 0.1.4

package/node_modules/@weavecode/harness/dist/codex/config-catalog.generated.js

@@ -0,0 +1 @@
+export const CODEX_CONFIG_GROUPS=["Model","Approvals & sandbox","Profiles","MCP servers","Plugins & marketplaces","Projects & docs","Hooks","Features","TUI","Shell & execution","Tools","Agents & automation","Skills & memories","Apps & integrations","Auth & network","Updates & telemetry","General"],CODEX_CONFIG_KEYS=[{key:"model",group:"Model",description:"Optional override of model selection.",scope:"any",type:"String"},{key:"model_auto_compact_token_limit",group:"Model",description:"Token usage threshold triggering auto-compaction of conversation history.",scope:"any",type:"Integer"},{key:"model_auto_compact_token_limit_scope",group:"Model",description:"Controls whether the auto-compaction limit applies to the full context or only to tokens after the carried prefix in the current compaction window.",scope:"any",type:"String",options:["total","body_after_prefix"]},{key:"model_catalog_json",group:"Model",description:"Optional path to a JSON model catalog (applied on startup only). Per-thread config overrides are accepted but do not reapply this (no-ops).",scope:"any",type:"String"},{key:"model_context_window",group:"Model",description:"Size of the context window for the model, in tokens.",scope:"any",type:"Integer"},{key:"model_instructions_file",group:"Model",description:"Optional path to a file containing model instructions that will override the built-in instructions for the selected model. Users are STRONGLY DISCOURAGED from using this field, as deviating from the instructions sanctioned by Codex will likely degrade model performance.",scope:"any",type:"String"},{key:"model_post_turn_compact_threshold_percent",group:"Model",description:"Percentage of the usable context window that triggers compaction after a final response. Existing auto-compaction limits still apply. Omitted or zero disables turn-end compaction; valid values are 0\u2013100.",scope:"any",type:"Integer"},{key:"model_provider",group:"Model",description:"Provider to use from the model_providers map.",scope:"user",type:"String"},{key:"model_providers",group:"Model",description:"User-defined provider entries that extend the built-in list. Built-in IDs cannot be overridden.",scope:"user",type:"Object",shape:"map",fields:[{name:"auth",type:"Object",description:"Command-backed bearer-token configuration for this provider."},{name:"aws",type:"Object",description:"AWS SigV4 auth configuration for this provider."},{name:"base_url",type:"String",description:"Base URL for the provider's OpenAI-compatible API."},{name:"capabilities",type:"Object",description:"Optional API capability overrides for a custom Responses-compatible provider. Unspecified capabilities retain their existing provider defaults."},{name:"env_http_headers",type:"Object",description:"Optional HTTP headers to include in requests to this provider where the (key, value) pairs are the header name and _environment variable_ whose value should be used. If the environment variable is not set, or the value is empty, the header will not be included in the request."},{name:"env_key",type:"String",description:"Environment variable that stores the user's API key for this provider."},{name:"env_key_instructions",type:"String",description:"Optional instructions to help the user get a valid value for the variable and set it."},{name:"experimental_bearer_token",type:"String",description:"Value to use with Authorization: Bearer <token> header. Use of this config is discouraged in favor of env_key for security reasons, but this may be necessary when using this programmatically."},{name:"gateway_oauth",type:"Object",description:"Secondary OAuth credentials required by the provider's gateway."},{name:"http_headers",type:"Object",description:"Additional HTTP headers to include in requests to this provider where the (key, value) pairs are the header name and value."},{name:"model_catalog_url",type:"String",description:"Optional full URL for a Codex-native model catalog. When unset, OpenAI discovery uses the Codex backend unless base_url overrides the inference endpoint."},{name:"name",type:"String",description:"Friendly display name."},{name:"query_params",type:"Object",description:"Optional query parameters to append to the base URL."},{name:"request_max_retries",type:"Integer",description:"Maximum number of times to retry a failed HTTP request to this provider."},{name:"requires_openai_auth",type:"Boolean",description:"Does this provider require an OpenAI API key or ChatGPT login token? If true, the user is presented with a login screen on first run, and credentials are stored using the backend selected by cli_auth_credentials_store. If false (the default), the login screen is skipped\u2026"},{name:"stream_idle_timeout_ms",type:"Integer",description:"Idle timeout (in milliseconds) to wait for activity on a streaming response before treating the connection as lost."},{name:"stream_max_retries",type:"Integer",description:"Number of times to retry reconnecting a dropped streaming response before failing."},{name:"supports_standalone_web_search",type:"Boolean",description:"Whether this provider supports the standalone web-search endpoint."},{name:"supports_websockets",type:"Boolean",description:"Whether this provider supports the Responses API WebSocket transport."},{name:"websocket_connect_timeout_ms",type:"Integer",description:"Maximum time (in milliseconds) to wait for a websocket connection attempt before treating it as failed."},{name:"wire_api",type:"String",options:["responses"],description:"Which wire protocol this provider expects."}]},{key:"model_reasoning_effort",group:"Model",description:"A non-empty reasoning effort value advertised by the model.",scope:"any",type:"String"},{key:"model_reasoning_summary",group:"Model",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",scope:"any",type:"String",options:["auto","concise","detailed","none"]},{key:"model_verbosity",group:"Model",description:"Optional verbosity control for GPT-5 models (Responses API text.verbosity).",scope:"any",type:"String",options:["low","medium","high"]},{key:"oss_provider",group:"Model",description:'Preferred OSS provider for local models, e.g. "lmstudio" or "ollama".',scope:"any",type:"String"},{key:"plan_mode_reasoning_effort",group:"Model",description:"A non-empty reasoning effort value advertised by the model.",scope:"any",type:"String"},{key:"review_model",group:"Model",description:"Review model override used by the /review feature.",scope:"any",type:"String"},{key:"service_tier",group:"Model",description:"Optional explicit service tier request id for new turns (for example default, priority, or flex; legacy fast also works).",scope:"any",type:"String"},{key:"approval_policy",group:"Approvals & sandbox",description:"Default approval policy for executing commands.",scope:"any",type:"String",options:["on-request","never"]},{key:"approvals_reviewer",group:"Approvals & sandbox",description:"Configures who approval requests are routed to for review once they have been escalated. This does not disable separate safety checks such as ARC.",scope:"any",type:"String",options:["user","auto_review","guardian_subagent"]},{key:"default_permissions",group:"Approvals & sandbox",description:"Default permissions profile to apply. Names starting with : refer to built-in profiles; other names are resolved from the [permissions] table.",scope:"any",type:"String"},{key:"permissions",group:"Approvals & sandbox",description:"Named permissions profiles.",scope:"any",type:"Object"},{key:"sandbox_mode",group:"Approvals & sandbox",description:"Sandbox mode to use.",scope:"any",type:"String",options:["read-only","workspace-write","danger-full-access"]},{key:"sandbox_workspace_write.exclude_slash_tmp",group:"Approvals & sandbox",default:"false",description:"Sandbox configuration to apply if sandbox is WorkspaceWrite.",scope:"any",type:"Boolean"},{key:"sandbox_workspace_write.exclude_tmpdir_env_var",group:"Approvals & sandbox",default:"false",description:"Sandbox configuration to apply if sandbox is WorkspaceWrite.",scope:"any",type:"Boolean"},{key:"sandbox_workspace_write.network_access",group:"Approvals & sandbox",default:"false",description:"Sandbox configuration to apply if sandbox is WorkspaceWrite.",scope:"any",type:"Boolean"},{key:"sandbox_workspace_write.writable_roots",group:"Approvals & sandbox",description:"Sandbox configuration to apply if sandbox is WorkspaceWrite.",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"profile",group:"Profiles",description:"Profile to use from the profiles map.",scope:"user",type:"String"},{key:"profiles",group:"Profiles",description:"Named profiles to facilitate switching between different configurations.",scope:"user",type:"Object",shape:"map",fields:[{name:"analytics",type:"Object",description:"Analytics settings loaded from config.toml. Fields are optional so we can apply defaults."},{name:"approval_policy",type:"String",options:["on-request","never"],description:"Determines the conditions under which the user is consulted to approve running the command proposed by Codex."},{name:"approvals_reviewer",type:"String",options:["user","auto_review","guardian_subagent"],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 denyin\u2026"},{name:"chatgpt_base_url",type:"String"},{name:"experimental_compact_prompt_file",type:"String",description:"A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem). IMPORTANT: When deserializing an AbsolutePathBuf, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set\u2026"},{name:"experimental_use_unified_exec_tool",type:"Boolean"},{name:"features",type:"Object",description:"Optional feature toggles scoped to this profile."},{name:"include_apps_instructions",type:"Boolean"},{name:"include_collaboration_mode_instructions",type:"Boolean"},{name:"include_environment_context",type:"Boolean"},{name:"include_environment_context_time",type:"Boolean"},{name:"include_permissions_instructions",type:"Boolean"},{name:"model",type:"String"},{name:"model_catalog_json",type:"String",description:"Optional path to a JSON model catalog (applied on startup only)."},{name:"model_instructions_file",type:"String",description:"Optional path to a file containing model instructions."},{name:"model_provider",type:"String",description:"The key in the model_providers map identifying the [ModelProviderInfo] to use."},{name:"model_reasoning_effort",type:"String",description:"A non-empty reasoning effort value advertised by the model."},{name:"model_reasoning_summary",type:"String",options:["auto","concise","detailed","none"],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"},{name:"model_verbosity",type:"String",options:["low","medium","high"],description:"Controls output length/detail on GPT-5 models via the Responses API. Serialized with lowercase values to match the OpenAI API."},{name:"oss_provider",type:"String"},{name:"personality",type:"String",options:["none","friendly","pragmatic"],description:"Deprecated: friendly and pragmatic no longer select a style."},{name:"plan_mode_reasoning_effort",type:"String",description:"A non-empty reasoning effort value advertised by the model."},{name:"sandbox_mode",type:"String",options:["read-only","workspace-write","danger-full-access"]},{name:"service_tier",type:"String",description:"Optional explicit service tier request id for new turns (for example default, priority, or flex; legacy fast also works)."},{name:"tools",type:"Object"},{name:"tui",type:"Object",description:"TUI settings scoped to this profile."},{name:"web_search",type:"String",options:["disabled","cached","indexed","live"]},{name:"windows",type:"Object"}]},{key:"mcp_enterprise_managed_auth.idp.client_id",group:"MCP servers",description:"Public OAuth client registered with that enterprise IdP.",scope:"any",type:"String"},{key:"mcp_enterprise_managed_auth.idp.issuer",group:"MCP servers",description:"Issuer used for enterprise OAuth discovery and identity validation.",scope:"any",type:"String"},{key:"mcp_oauth_callback_port",group:"MCP servers",description:"Optional fixed port for the local HTTP callback server used during MCP OAuth login. When unset, Codex will bind to an ephemeral port chosen by the OS.",scope:"any",type:"Integer"},{key:"mcp_oauth_callback_url",group:"MCP servers",description:"Optional redirect URI to use during MCP OAuth login. When set, this URI is used in the OAuth authorization request instead of the local listener address. The local callback listener still binds to 127.0.0.1 (using mcp_oauth_callback_port when provided).",scope:"any",type:"String"},{key:"mcp_oauth_credentials_store",group:"MCP servers",description:"Preferred backend for storing MCP OAuth credentials. keyring: Use an OS-specific keyring service. https://github.com/openai/codex/blob/main/codex-rs/rmcp-client/src/oauth.rs#L2 file: Use a file in the Codex home directory. auto (default): Use the OS-specific keyring service if available, otherwise use a file.",scope:"any",type:"String",options:["auto","file","keyring"]},{key:"mcp_optional_startup_grace_ms",group:"MCP servers",description:"Milliseconds to wait for optional MCP servers while building the initial tool catalog. Defaults to 1000. Set to 0 to disable the shared grace and wait for each server's configured startup_timeout_sec instead.",scope:"any",type:"Integer"},{key:"mcp_servers",group:"MCP servers",description:"Definition for MCP servers that Codex can reach out to for tool calls.",scope:"any",type:"Object",shape:"map",fields:[{name:"args",type:"Array of String"},{name:"auth",type:"String",options:["oauth","chatgpt","ema_auth"],description:"Authentication flow for an HTTP MCP server. Explicit credentials take precedence for OAuth and ChatGPT; EMA rejects alternate credentials and fallback."},{name:"bearer_token_env_var",type:"String"},{name:"command",type:"String"},{name:"cwd",type:"String"},{name:"default_tools_approval_mode",type:"String",options:["auto","prompt","writes","approve"]},{name:"disabled_tools",type:"Array of String"},{name:"enabled",type:"Boolean"},{name:"enabled_tools",type:"Array of String"},{name:"env",type:"Object"},{name:"env_http_headers",type:"Object"},{name:"env_vars",type:"Array of String"},{name:"environment_id",type:"String"},{name:"http_headers",type:"Object"},{name:"http_headers_helper",type:"String"},{name:"name",type:"String",description:"Legacy display-name field accepted for backward compatibility."},{name:"oauth",type:"Object",description:"Client settings for MCP OAuth login or enterprise token exchange."},{name:"oauth_resource",type:"String"},{name:"omit_tools_from",type:"Array of String"},{name:"required",type:"Boolean"},{name:"scopes",type:"Array of String"},{name:"startup_readiness",type:"String",options:["connection","catalog"],description:"Whether startup requires a live connection or can use a valid cached tool catalog."},{name:"startup_timeout_ms",type:"Integer"},{name:"startup_timeout_sec",type:"Number"},{name:"supports_parallel_tool_calls",type:"Boolean"},{name:"tool_input_schema_max_bytes",type:"Integer",description:"UTF-8 byte threshold for compacting each ordinary MCP tool input schema. Defaults to 5,000 bytes. Code Mode also uses an explicitly configured limit when rendering each tool's input type. Larger limits preserve more parameter descriptions."},{name:"tool_timeout_sec",type:"Number"},{name:"tools",type:"Object"},{name:"url",type:"String"}]},{key:"marketplaces",group:"Plugins & marketplaces",description:"User-level marketplace entries keyed by marketplace name.",scope:"any",type:"Object",shape:"map",fields:[{name:"last_revision",type:"String",description:"Git revision Codex last successfully activated for this marketplace."},{name:"last_updated",type:"String",description:"Last time Codex successfully added or refreshed this marketplace."},{name:"ref",type:"String",description:"Git ref to check out when source_type is git."},{name:"source",type:"String",description:"Source location used when the marketplace was added."},{name:"source_type",type:"String",options:["git","local"],description:"Source kind used to install this marketplace."},{name:"sparse_paths",type:"Array of String",description:"Sparse checkout paths used when source_type is git."}]},{key:"plugins",group:"Plugins & marketplaces",description:"Default and per-plugin settings keyed by exact <plugin>@<marketplace> IDs.",scope:"any",type:"Object",shape:"map",fields:[{name:"auto_provision",type:"Boolean",description:"Provisioning metadata. Omission does not request provisioning. Only applies with remote_plugin_id and Plugin Service availability to the requesting user at provisioning time. Effective enablement, trusted provisioning policy, and authentication and authorization restrictions still apply\u2026"},{name:"enabled",type:"Boolean",description:"Explicit activation override. Omission inherits the installed-plugin default."},{name:"mcp_servers",type:"Object",description:"Per-MCP-server policy overlays for MCP servers contributed by this plugin."},{name:"release_id",type:"String",description:"Release identifier used to pin the remote plugin to a specific release. Omission leaves release selection unchanged. Core stores this metadata without selecting or fetching a release."},{name:"remote_plugin_id",type:"String",description:"Stable, unique identifier of a ChatGPT-hosted remote plugin. Availability to the requesting user is determined by Plugin Service at provisioning time."}]},{key:"plugins._default.enabled",group:"Plugins & marketplaces",default:"true",description:"Defaults for installed plugin activation. Omission preserves source enablement. Explicit plugin enablement settings override this default, but cannot enable an installation disabled by its source.",scope:"any",type:"Boolean"},{key:"project_doc_fallback_filenames",group:"Projects & docs",description:"Ordered list of fallback filenames to look for when AGENTS.md is missing.",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"project_doc_max_bytes",group:"Projects & docs",default:"32768",description:"Maximum total bytes of project instruction content across all selected environments.",scope:"any",type:"Integer"},{key:"project_root_markers",group:"Projects & docs",description:'Markers used to detect the project root when searching parent directories for .codex folders. Defaults to [".git"] when unset.',scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"projects",group:"Projects & docs",description:"",scope:"any",type:"Object",shape:"map",fields:[{name:"trust_level",type:"String",options:["trusted","untrusted"],description:"Represents the trust level for a project directory. This determines the approval policy and sandbox mode applied."}]},{key:"hooks.Interrupt",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PermissionRequest",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PostCompact",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PostModelRequest",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PostToolUse",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PreCompact",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PreModelRequest",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PreToolUse",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.SessionEnd",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.SessionStart",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.state",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Object",shape:"map",fields:[{name:"enabled",type:"Boolean"},{name:"trusted_content_hash",type:"String",description:"Approved plugin contents; kept separate for declaration-only clients."},{name:"trusted_hash",type:"String"}]},{key:"hooks.Stop",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.SubagentStart",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.SubagentStop",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.UserPromptSubmit",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"features.agent_message_board",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.analytics_plan_history",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.api_key_cyber_access_programs",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.api_key_model_discovery",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.app_server_websocket_compression",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.apply_patch_freeform",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.apply_patch_preserve_line_endings",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.apply_patch_streaming_events",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.apps",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.apps_mcp_path_override",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.async_compaction",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.auth_elicitation",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.background_paginated_rollout_migration",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.bedrock_setup_wizard",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.browser_annotation_api",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.browser_use",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.browser_use_external",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.browser_use_full_cdp_access",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.chronicle",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.cli_daybreak",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_buffered_exec",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_host",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_host_grpc",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_interrupt",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_only",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_only_strict_3p_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_prewarm",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_tool_description_first",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_tool_search",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.codex_apps_mcp_2026_07_28",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.codex_git_commit",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.codex_hooks",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.collab",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.collaboration_modes",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.compaction_image_budget",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.computer_use",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.concurrent_reasoning_summaries",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.connectors",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.content_item_kinds",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.context_management",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.credential_masking",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.current_time_reminder",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.cwd_relative_turn_diffs",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.daemon_auto_start",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.default_mode_request_user_input",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.defer_mailbox_preemption",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.deferred_executor",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.deferred_tool_world_state",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.elevated_windows_sandbox",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.enable_experimental_windows_sandbox",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.enable_fanout",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.enable_mcp_apps",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.enable_request_compression",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.exec_permission_approvals",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.executed_tool_call_metadata",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.executor_capability_discovery",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.executor_capability_discovery_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.experimental_use_unified_exec_tool",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.experimental_windows_sandbox",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.external_agent_memory_import",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.external_migration",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.fast_mode",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.goals",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_approval",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_conversation_history_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_enhanced_node_repl_transcripts",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_ext",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_node_repl_transcript_images",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_reuse_parent_compaction",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_root_handoff_context",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_trust_orchestrator_connectors",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardianv2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardianv2_decisions_comparison",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.hooks",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.image_detail_original",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.image_generation",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.image_resize_notice",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.imagegenext",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.in_app_browser",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.in_app_chat",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.in_app_dictation",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.in_app_local_automation",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.in_app_updates",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.in_app_voice",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.incremental_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.instant_interrupt",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.item_ids",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.js_repl",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.js_repl_tools_only",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.local_thread_store_compression",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.local_thread_store_shared_compression",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.login_shell_package_path",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.mcp_2026_07_28",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.mcp_oauth_refresh_coordination",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.mcp_tool_list_changed",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.memories",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.memory_tool",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.mentions_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.model_catalog_in_context",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.multi_agent",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.multi_agent_mode",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.multi_agent_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.multi_agent_v2_dynamic_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.multi_env_copy_file",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.network_proxy",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.non_prefixed_mcp_tool_names",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.nonfatal_clock_read_errors",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.omit_app_server_notification_media",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.output_token_replay",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.personality",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.plugin_hooks",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.plugin_sharing",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.plugins",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.powershell_shell_version",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.prefer_mxc",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.prevent_idle_sleep",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.psp",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.realtime_conversation",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.reasoning_effort_override",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.recommended_plugins",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.remote_compaction_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.remote_control",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.remote_models",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.remote_plugin",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.request_permissions",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.request_permissions_tool",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.request_rule",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.resize_all_images",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.respect_system_proxy",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.responses_websockets",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.responses_websockets_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.retain_client_developer_messages",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.retain_client_tool_outputs",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.rollout_budget",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.runtime_agent_instances",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.runtime_metrics",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.search_tool",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.secret_auth_storage",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.send_async_message",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.send_message_to_user_async",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.shell_snapshot",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.shell_snapshot_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.shell_tool",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.shell_zsh_fork",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.skill_env_var_dependency_prompt",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.skill_mcp_dependency_install",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.skill_search",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.skip_host_skill_discovery",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.sleep_tool",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.sqlite",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.stable_environment_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.standalone_web_search",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.steer",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.step_model_switching",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.subagent_default_context_limits",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.subagent_thread_environments",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.system_proxy_fallback",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.telepathy",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.terminal_resize_reflow",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.terminal_visualization_instructions",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.token_budget",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.tool_call_mcp_elicitation",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.tool_registry.error_on_tool_collisions",group:"Features",description:"Fail the turn when multiple tools share the same effective name.",scope:"any",type:"Boolean"},{key:"features.tool_registry.turn_metadata_includes_tool_info",group:"Features",description:"Include authoritative tool information in per-turn request metadata.",scope:"any",type:"Boolean"},{key:"features.tool_search",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.tool_search_always_defer_mcp_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.tool_suggest",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.transcript_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.tui_app_server",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.ultrafast_mode",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.unavailable_dummy_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.unbounded_connection_retries",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.undo",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.unified_exec",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.unified_exec_tty",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.unified_exec_zsh_fork",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.unified_image_budget",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.use_agent_identity",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.use_legacy_landlock",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.use_linux_sandbox_bwrap",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.use_xaa",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.view_image",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.wake_on_agent_messages",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.web_search",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.web_search_cached",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.web_search_request",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.windows_sandbox_service",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.workspace_dependencies",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.workspace_owner_usage_nudge",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.worktrees",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.write_stdin_approval",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"tui.agents_overview_grouping",group:"TUI",description:"Last selected grouping in Agent Command Center.",scope:"any",type:"String",options:["project","status","model"]},{key:"tui.alternate_screen",group:"TUI",description:"Controls whether the TUI uses the terminal's alternate screen buffer. - auto (default): Use alternate screen. - always: Always use alternate screen. - never: Never use alternate screen (inline mode only, preserves scrollback).",scope:"any",type:"String",options:["auto","always","never"]},{key:"tui.animations",group:"TUI",default:"true",description:"Enable animations (welcome screen, shimmer effects, spinners). Defaults to true.",scope:"any",type:"Boolean"},{key:"tui.auto_recap",group:"TUI",default:"true",description:"Generate automatic conversation recaps when the terminal is unfocused. Defaults to true. Disabling this leaves /recap available on demand.",scope:"any",type:"Boolean"},{key:"tui.copy_on_select",group:"TUI",description:"Copy selected transcript, footer, or composer text when the mouse button is released. Defaults to auto: enabled except in direct terminals known to forward their native copy shortcut (Ghostty 1.2+, Kitty on macOS, Windows Terminal, and VS Code on Windows). Unknown terminals, Ghostty without a recognized version\u2026",scope:"any",type:"String",options:["auto","always","never"]},{key:"tui.copy_on_select_clear_selection",group:"TUI",default:"false",description:"Deselect read-only transcript or footer text after Copy on select confirms delivery. Editable composer selections remain visible. Defaults to false and has no effect when Copy on select is off.",scope:"any",type:"Boolean"},{key:"tui.disable_paste_burst",group:"TUI",description:"When true, disables burst-paste detection for typed input entirely. All characters are inserted as they are received, and no buffering or placeholder replacement will occur for fast keypress bursts. Overrides the legacy top-level disable_paste_burst setting. Defaults to false.",scope:"any",type:"Boolean"},{key:"tui.effects.effort",group:"TUI",default:"true",description:"Animate reasoning-effort changes in the composer and footer.",scope:"any",type:"Boolean"},{key:"tui.effects.progress",group:"TUI",default:"true",description:"Animate activity bullets and loading spinners.",scope:"any",type:"Boolean"},{key:"tui.effects.shimmer",group:"TUI",default:"true",description:"Shimmer status and loading text.",scope:"any",type:"Boolean"},{key:"tui.effects.starfield",group:"TUI",default:"true",description:"Animate the composer starfield.",scope:"any",type:"Boolean"},{key:"tui.effects.title",group:"TUI",default:"true",description:"Blink the terminal-title indicator when user action is required.",scope:"any",type:"Boolean"},{key:"tui.effects.welcome",group:"TUI",default:"true",description:"Animate the welcome artwork.",scope:"any",type:"Boolean"},{key:"tui.fullscreen_transcript",group:"TUI",default:"true",description:"Own the fullscreen transcript, including scrolling, selection, and search. Defaults to true; alternate-screen restrictions take precedence.",scope:"any",type:"Boolean"},{key:"tui.keymap",group:"TUI",description:"Keybinding overrides for the TUI. This supports rebinding selected actions globally and by context. Context bindings take precedence over global bindings.",scope:"any",type:"Object"},{key:"tui.model_availability_nux",group:"TUI",description:"Startup tooltip availability NUX state persisted by the TUI.",scope:"any",type:"Object",shape:"map",valueType:"Integer"},{key:"tui.mouse_scroll_speed",group:"TUI",description:"Mouse wheel speed multiplier for transcript scrolling, based on one row per event. Defaults to 1.0. Positive fractional values slow scrolling; values above 1.0 speed it up.",scope:"any",type:"Number"},{key:"tui.notification_condition",group:"TUI",description:"Controls whether TUI notifications are delivered only when the terminal is unfocused or regardless of focus. Defaults to unfocused.",scope:"any",type:"String",options:["unfocused","always"]},{key:"tui.notification_method",group:"TUI",description:"Notification method to use for terminal notifications. Defaults to auto.",scope:"any",type:"String",options:["auto","osc9","bel"]},{key:"tui.notifications",group:"TUI",description:"Enable desktop notifications from the TUI. Defaults to true.",scope:"any",type:"Boolean"},{key:"tui.pet",group:"TUI",description:"Pet id to preselect in the terminal pet picker. Custom pet ids resolve against CODEX_HOME/pets/<pet-id>/pet.json.",scope:"any",type:"String"},{key:"tui.pet_anchor",group:"TUI",description:"Where the terminal pet should anchor vertically. Defaults to composer, which follows the current TUI composer viewport.",scope:"any",type:"String",options:["composer","screen-bottom"]},{key:"tui.presets",group:"TUI",description:"Saved inputs keyed by a single digit (0 through 9).",scope:"any",type:"Object",shape:"map",fields:[{name:"input",type:"String",description:"Plain-text input, limited to 8,000 UTF-8 bytes."},{name:"label",type:"String",description:"Optional short name for the picker and shortcut hints."}]},{key:"tui.question_esc_back",group:"TUI",default:"true",description:"Escape returns from async questions to the composer, preserving the answer draft.",scope:"any",type:"Boolean"},{key:"tui.raw_output_mode",group:"TUI",default:"false",description:"Start the TUI in raw scrollback mode for copy-friendly transcript output. Defaults to false.",scope:"any",type:"Boolean"},{key:"tui.rendering.lists",group:"TUI",default:"true",description:"Render Markdown bullets and task-list markers as Unicode symbols.",scope:"any",type:"Boolean"},{key:"tui.rendering.math",group:"TUI",default:"true",description:"Render math expressions using Unicode notation.",scope:"any",type:"Boolean"},{key:"tui.rendering.mermaid",group:"TUI",default:"true",description:"Render Mermaid code blocks as diagrams.",scope:"any",type:"Boolean"},{key:"tui.rendering.tables",group:"TUI",default:"true",description:"Render pipe tables, including tables inside Markdown fences.",scope:"any",type:"Boolean"},{key:"tui.resume_cwd",group:"TUI",description:"Working directory to use when resuming or forking a session. When unset, prompt if the current and session directories differ.",scope:"any",type:"String",options:["current","session"]},{key:"tui.right_click_paste",group:"TUI",description:"Right-click text paste fallback. Defaults to auto (Windows/WSL/Linux). on also enables macOS; neither mode reads over SSH or in recognized VS Code terminals. This controls the fullscreen fallback, not the terminal's own paste binding.",scope:"any",type:"String",options:["auto","on","off"]},{key:"tui.screen_reader_detection_done",group:"TUI",description:"Records the one-time screen-reader detection attempt. Either value skips detection.",scope:"any",type:"Boolean"},{key:"tui.session_picker_view",group:"TUI",description:"Preferred layout for resume/fork session picker results.",scope:"any",type:"String",options:["comfortable","dense"]},{key:"tui.show_server_version_notice",group:"TUI",default:"true",description:"Show informational notices about connected app server version differences. Defaults to true; this does not control compatibility errors or version status.",scope:"any",type:"Boolean"},{key:"tui.show_tooltips",group:"TUI",default:"true",description:"Show startup tooltips in the TUI welcome screen. Defaults to true.",scope:"any",type:"Boolean"},{key:"tui.status_line",group:"TUI",description:"Ordered list of status line item identifiers. When set, the TUI renders the selected items as the status line. When unset, the TUI defaults to: model-with-reasoning, current-dir, and thread-name.",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"tui.status_line_use_colors",group:"TUI",default:"true",description:"Color status line items with colors derived from the active syntax theme. Defaults to true.",scope:"any",type:"Boolean"},{key:"tui.terminal_resize_reflow_max_rows",group:"TUI",description:"Trim terminal resize-reflow replay to the most recent rendered terminal rows when the transcript exceeds this cap. Omit to use Codex's terminal-specific default. Set to 0 to keep all rendered rows.",scope:"any",type:"Integer"},{key:"tui.terminal_title",group:"TUI",description:"Ordered list of terminal title item identifiers. When set, the TUI renders the selected items into the terminal window/tab title. When unset, the TUI defaults to: activity, thread-name, and project-name. The activity item spins while working and shows an action-required message when blocked on the user.",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"tui.theme",group:"TUI",description:"Syntax highlighting theme name (kebab-case). When set, overrides automatic light/dark theme detection. Use /theme in the TUI or see $CODEX_HOME/themes for custom themes.",scope:"any",type:"String"},{key:"tui.vim_mode_default",group:"TUI",default:"false",description:"Start the composer in Vim mode (Normal) by default. Defaults to false.",scope:"any",type:"Boolean"},{key:"allow_login_shell",group:"Shell & execution",description:"Whether the model may request a login shell for shell-based tools. Default to true If true, the model may request a login shell (login = true), and omitting login defaults to using a login shell. If false, the model can never use a login shell: login = true requests are rejected\u2026",scope:"any",type:"Boolean"},{key:"background_terminal_max_timeout",group:"Shell & execution",description:"Maximum poll window for background terminal output (write_stdin), in milliseconds. Default: 300000 (5 minutes).",scope:"any",type:"Integer"},{key:"experimental_use_unified_exec_tool",group:"Shell & execution",description:"",scope:"any",type:"Boolean"},{key:"shell_environment_policy.exclude",group:"Shell & execution",description:"Legacy list of regular expressions to exclude.",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"shell_environment_policy.experimental_use_profile",group:"Shell & execution",description:"Policy for building the env when spawning a process via shell-like tools.",scope:"any",type:"Boolean"},{key:"shell_environment_policy.filters",group:"Shell & execution",description:"Pattern actions used by the canonical table representation. Ordinary config keeps accepting the legacy arrays above during the migration. Requirements will accept only this keyed form, keeping array compatibility isolated so the legacy fields can be deprecated later\u2026",scope:"any",type:"Object",shape:"map",valueType:"String",valueOptions:["include","exclude"]},{key:"shell_environment_policy.ignore_default_excludes",group:"Shell & execution",description:"Policy for building the env when spawning a process via shell-like tools.",scope:"any",type:"Boolean"},{key:"shell_environment_policy.include_only",group:"Shell & execution",description:"Legacy list of regular expressions to include.",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"shell_environment_policy.inherit",group:"Shell & execution",description:"Policy for building the env when spawning a process via shell-like tools.",scope:"any",type:"String",options:["core","all","none"]},{key:"shell_environment_policy.set",group:"Shell & execution",description:"Policy for building the env when spawning a process via shell-like tools.",scope:"any",type:"Object",shape:"map",valueType:"String"},{key:"browser_use.allow_history_access",group:"Tools",description:"",scope:"any",type:"Boolean"},{key:"browser_use.default_origin_policy.access",group:"Tools",description:"",scope:"any",type:"String",options:["allow","deny"]},{key:"browser_use.default_origin_policy.downloads",group:"Tools",description:"",scope:"any",type:"String",options:["allow","deny"]},{key:"browser_use.default_origin_policy.full_cdp_access",group:"Tools",description:"",scope:"any",type:"String",options:["allow","deny"]},{key:"browser_use.default_origin_policy.uploads",group:"Tools",description:"",scope:"any",type:"String",options:["allow","deny"]},{key:"browser_use.origins",group:"Tools",description:"",scope:"any",type:"Object",shape:"map",fields:[{name:"access",type:"String",options:["allow","deny"]},{name:"downloads",type:"String",options:["allow","deny"]},{name:"full_cdp_access",type:"String",options:["allow","deny"]},{name:"uploads",type:"String",options:["allow","deny"]}]},{key:"computer_use.default_app_access",group:"Tools",description:"",scope:"any",type:"String",options:["allow","deny"]},{key:"computer_use.macos.bundle_ids",group:"Tools",description:"",scope:"any",type:"Object",shape:"map",valueType:"String",valueOptions:["allow","deny"]},{key:"computer_use.windows.aumids",group:"Tools",description:"",scope:"any",type:"Object",shape:"map",valueType:"String",valueOptions:["allow","deny"]},{key:"computer_use.windows.exes",group:"Tools",description:"",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"access",type:"String",options:["allow","deny"]},{name:"binary_name",type:"String"},{name:"product_name",type:"String"},{name:"publisher_name",type:"String"}]},{key:"tool_output_token_limit",group:"Tools",description:"Token budget applied when storing tool/function outputs in the context manager.",scope:"any",type:"Integer"},{key:"tool_suggest.disabled_tools",group:"Tools",description:"Additional discoverable tools that can be suggested for installation.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"id",type:"String"},{name:"type",type:"String",options:["connector","plugin"]}]},{key:"tool_suggest.discoverables",group:"Tools",description:"Additional discoverable tools that can be suggested for installation.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"id",type:"String"},{name:"type",type:"String",options:["connector","plugin"]}]},{key:"tools.experimental_request_user_input.enabled",group:"Tools",default:"true",description:"Nested tools section for feature toggles",scope:"any",type:"Boolean"},{key:"tools.update_plan.enabled",group:"Tools",default:"false",description:"Nested tools section for feature toggles",scope:"any",type:"Boolean"},{key:"tools.web_search.allowed_domains",group:"Tools",description:"Nested tools section for feature toggles",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"tools.web_search.context_size",group:"Tools",description:"Nested tools section for feature toggles",scope:"any",type:"String",options:["low","medium","high"]},{key:"tools.web_search.location.city",group:"Tools",description:"Nested tools section for feature toggles",scope:"any",type:"String"},{key:"tools.web_search.location.country",group:"Tools",description:"Nested tools section for feature toggles",scope:"any",type:"String"},{key:"tools.web_search.location.region",group:"Tools",description:"Nested tools section for feature toggles",scope:"any",type:"String"},{key:"tools.web_search.location.timezone",group:"Tools",description:"Nested tools section for feature toggles",scope:"any",type:"String"},{key:"web_search",group:"Tools",description:"Controls the web search tool mode: disabled, cached, indexed, or live.",scope:"any",type:"String",options:["disabled","cached","indexed","live"]},{key:"agents",group:"Agents & automation",description:"Agent-related settings (thread limits, etc.).",scope:"any",type:"Object",shape:"map",fields:[{name:"config_file",type:"String",description:"Path to a role-specific config layer. Relative paths are resolved relative to the config.toml that defines them."},{name:"description",type:"String",description:"Human-facing role documentation used in spawn tool guidance. Required unless supplied by the referenced agent role file."},{name:"nickname_candidates",type:"Array of String",description:"Candidate nicknames for agents spawned with this role."}]},{key:"agents.default_subagent_model",group:"Agents & automation",description:"Default model for spawned subagents when the spawn call does not select one.",scope:"any",type:"String"},{key:"agents.default_subagent_reasoning_effort",group:"Agents & automation",description:"Default reasoning effort for spawned subagents when the spawn call does not select one.",scope:"any",type:"String"},{key:"agents.enabled",group:"Agents & automation",description:"Whether multi-agent tools are enabled. Defaults to true. An enabled features.multi_agent_v2 setting takes precedence.",scope:"any",type:"Boolean"},{key:"agents.interrupt_message",group:"Agents & automation",description:"Whether to record a model-visible message when an agent turn is interrupted. Defaults to true.",scope:"any",type:"Boolean"},{key:"agents.max_concurrent_threads_per_session",group:"Agents & automation",description:"Maximum number of spawned agent threads that can be open concurrently per session. When unset, the selected multi-agent backend uses its default.",scope:"any",type:"Integer"},{key:"agents.max_depth",group:"Agents & automation",description:"Maximum nesting depth for V1 agent threads. Ignored by V2.",scope:"any",type:"Integer"},{key:"auto_review.circuit_break_action",group:"Agents & automation",description:"Controls whether circuit-breaker interruptions include a structured error. Strict mode writes structured errors that older clients may not recognize when reading shared history. Defaults to default.",scope:"any",type:"String",options:["default","strict"]},{key:"auto_review.conversation_history_max_output_tokens",group:"Agents & automation",description:"Maximum estimated tokens per Guardian history-tool response, before the standard serialization allowance. Defaults to 4,000; stricter parent tool limits still apply.",scope:"any",type:"Integer"},{key:"auto_review.experimental_conversation_history_prompt",group:"Agents & automation",description:"Experimental replacement for the history-retrieval instructions when history tools and Apps are enabled. Omitted or blank values use the built-in prompt.",scope:"any",type:"String"},{key:"auto_review.experimental_policy_template",group:"Agents & automation",description:"Experimental full Guardian prompt template containing the tenant policy placeholder.",scope:"any",type:"String"},{key:"auto_review.extra_policy",group:"Agents & automation",description:"Additional policy text inserted into the Guardian template's {{ extra_policy }} slot.",scope:"any",type:"String"},{key:"auto_review.policy",group:"Agents & automation",description:"Additional policy instructions inserted into the guardian prompt.",scope:"any",type:"String"},{key:"goals.max_goal_token_budget",group:"Agents & automation",description:"Maximum token budget allowed for a goal and default budget for new goals.",scope:"any",type:"Integer"},{key:"memories.consolidation_model",group:"Agents & automation",description:"Model used for memory consolidation.",scope:"any",type:"String"},{key:"memories.dedicated_tools",group:"Agents & automation",description:"When true, expose dedicated memory tools through the extension tool surface.",scope:"any",type:"Boolean"},{key:"memories.disable_on_external_context",group:"Agents & automation",description:'When true, external context sources mark the thread memory_mode as "polluted".',scope:"any",type:"Boolean"},{key:"memories.dual_write",group:"Agents & automation",description:"Generate both versions while v1 is selected; v2 runs alone after cutover.",scope:"any",type:"Boolean"},{key:"memories.extract_model",group:"Agents & automation",description:"Model used for thread summarisation.",scope:"any",type:"String"},{key:"memories.generate_memories",group:"Agents & automation",description:'When false, newly created threads are stored with memory_mode = "disabled" in the state DB.',scope:"any",type:"Boolean"},{key:"memories.max_raw_memories_for_consolidation",group:"Agents & automation",description:"Maximum number of recent raw memories retained for global consolidation.",scope:"any",type:"Integer"},{key:"memories.max_rollout_age_days",group:"Agents & automation",description:"Maximum age of the threads used for memories.",scope:"any",type:"Integer"},{key:"memories.max_rollouts_per_startup",group:"Agents & automation",description:"Maximum number of rollout candidates processed per pass.",scope:"any",type:"Integer"},{key:"memories.max_unused_days",group:"Agents & automation",description:"Maximum number of days since a memory was last used before it becomes ineligible for phase 2 selection.",scope:"any",type:"Integer"},{key:"memories.min_rate_limit_remaining_percent",group:"Agents & automation",description:"Minimum remaining percentage required in Codex rate-limit windows before memory startup runs.",scope:"any",type:"Integer"},{key:"memories.min_rollout_idle_hours",group:"Agents & automation",description:"Minimum idle time between last thread activity and memory creation (hours). > 12h recommended.",scope:"any",type:"Integer"},{key:"memories.use_memories",group:"Agents & automation",description:"When false, skip injecting memory usage instructions into developer prompts.",scope:"any",type:"Boolean"},{key:"memories.version",group:"Agents & automation",description:"Selects the memory pipeline; v1 remains the default.",scope:"any",type:"String",options:["v1","v2"]},{key:"orchestrator.mcp.enabled",group:"Agents & automation",description:"Optional enablement of a configured feature.",scope:"any",type:"Boolean"},{key:"orchestrator.skills.enabled",group:"Agents & automation",description:"Legacy no-op setting retained for compatibility. Use cloud.skills to configure cloud skills.",scope:"any",type:"Boolean"},{key:"skills.bundled.enabled",group:"Skills & memories",default:"true",description:"User-level skill config entries keyed by SKILL.md path.",scope:"any",type:"Boolean"},{key:"skills.config",group:"Skills & memories",description:"User-level skill config entries keyed by SKILL.md path.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"enabled",type:"Boolean"},{name:"name",type:"String",description:"Name-based selector."},{name:"path",type:"String",description:"Path-based selector."}]},{key:"skills.include_instructions",group:"Skills & memories",description:"Whether turns receive the automatic skills instructions block.",scope:"any",type:"Boolean"},{key:"skills.max_context_tokens",group:"Skills & memories",description:"Maximum tokens used by the available-skills catalog. Defaults to 2% of the model context window and is capped at 10,000 tokens when set.",scope:"any",type:"Integer"},{key:"apps",group:"Apps & integrations",description:"Settings for app-specific controls.",scope:"any",type:"Object",shape:"map",fields:[{name:"approvals_reviewer",type:"String",options:["user","auto_review","guardian_subagent"],description:"Reviewer for approval prompts from this app, overriding the thread default."},{name:"default_tools_approval_mode",type:"String",options:["auto","prompt","writes","approve"],description:"Approval mode for tools in this app unless a tool override exists."},{name:"default_tools_enabled",type:"Boolean",description:"Whether tools are enabled by default for this app."},{name:"destructive_enabled",type:"Boolean",description:"Whether tools with destructive_hint = true are allowed for this app."},{name:"enabled",type:"Boolean",description:"When false, Codex does not surface this app."},{name:"links",type:"Object",description:"Per-account approval settings keyed by link ID."},{name:"omit_tools_from",type:"Array of String",description:"Model-facing surfaces from which this connector's tools must be omitted, in addition to any server-level omissions. None leaves lower-priority configuration unchanged; an empty list clears connector-level omissions."},{name:"open_world_enabled",type:"Boolean",description:"Whether tools with open_world_hint = true are allowed for this app."},{name:"tools",type:"Object",description:"Per-tool settings for this app."}]},{key:"apps._default.approvals_reviewer",group:"Apps & integrations",description:"Reviewer for approval prompts unless overridden by per-app settings.",scope:"any",type:"String",options:["user","auto_review","guardian_subagent"]},{key:"apps._default.default_tools_approval_mode",group:"Apps & integrations",description:"Approval mode for tools unless overridden by per-app or per-tool settings.",scope:"any",type:"String",options:["auto","prompt","writes","approve"]},{key:"apps._default.destructive_enabled",group:"Apps & integrations",description:"Whether tools with destructive_hint = true are allowed by default.",scope:"any",type:"Boolean"},{key:"apps._default.enabled",group:"Apps & integrations",default:"true",description:"When false, apps are disabled unless overridden by per-app settings.",scope:"any",type:"Boolean"},{key:"apps._default.open_world_enabled",group:"Apps & integrations",description:"Whether tools with open_world_hint = true are allowed by default.",scope:"any",type:"Boolean"},{key:"audio.microphone",group:"Apps & integrations",description:"Machine-local realtime audio device preferences used by realtime voice.",scope:"any",type:"String"},{key:"audio.microphone_channel",group:"Apps & integrations",description:"One-based microphone channels to mix; unset mixes all input channels.",scope:"any",type:"Integer"},{key:"audio.speaker",group:"Apps & integrations",description:"Machine-local realtime audio device preferences used by realtime voice.",scope:"any",type:"String"},{key:"daybreak",group:"Apps & integrations",description:"Default Daybreak preference for new threads and non-interactive turns.",scope:"any",type:"Boolean"},{key:"desktop",group:"Apps & integrations",description:"Opaque desktop settings stored alongside the rest of config.toml.",scope:"any",type:"Object"},{key:"ghost_snapshot.disable_warnings",group:"Apps & integrations",description:"Legacy no-op setting retained for compatibility.",scope:"any",type:"Boolean"},{key:"ghost_snapshot.ignore_large_untracked_dirs",group:"Apps & integrations",description:"Legacy no-op setting retained for compatibility.",scope:"any",type:"Integer"},{key:"ghost_snapshot.ignore_large_untracked_files",group:"Apps & integrations",description:"Legacy no-op setting retained for compatibility.",scope:"any",type:"Integer"},{key:"realtime.transport",group:"Apps & integrations",description:"Experimental / do not use. Realtime websocket session selection. version controls v1/v2 and type controls conversational/transcription.",scope:"any",type:"String",options:["webrtc","websocket"]},{key:"realtime.type",group:"Apps & integrations",description:"Experimental / do not use. Realtime websocket session selection. version controls v1/v2 and type controls conversational/transcription.",scope:"any",type:"String",options:["conversational","transcription"]},{key:"realtime.version",group:"Apps & integrations",description:"Experimental / do not use. Realtime websocket session selection. version controls v1/v2 and type controls conversational/transcription.",scope:"any",type:"String",options:["v1","v2","v3"]},{key:"realtime.voice",group:"Apps & integrations",description:"Experimental / do not use. Realtime websocket session selection. version controls v1/v2 and type controls conversational/transcription.",scope:"any",type:"String",options:["alloy","arbor","ash","aube","ballad","breeze","bubbie","cedar","coral","cove","echo","ember","haetsal","hanul","himari","juniper","leher","maple","marin","miko","neer","porto","rindo","rio","rivage","sage","selva","shimmer","sol","sonna","spruce","tinta","vale","verse","viola"]},{key:"chatgpt_base_url",group:"Auth & network",description:"Base URL for requests to ChatGPT (as opposed to the OpenAI API).",scope:"user",type:"String"},{key:"cli_auth_credentials_store",group:"Auth & network",description:"Preferred backend for storing CLI auth credentials. file (default): Use a file in the Codex home directory. keyring: Use an OS-specific keyring service. auto: Use the keyring if available, otherwise use a file.",scope:"any",type:"String",options:["file","keyring","auto","ephemeral"]},{key:"forced_chatgpt_workspace_id",group:"Auth & network",description:"When set, restricts ChatGPT login to one or more workspace identifiers.",scope:"any",type:"String"},{key:"forced_login_method",group:"Auth & network",description:"When set, restricts the login mechanism users may use.",scope:"any",type:"String",options:["chatgpt","api"]},{key:"openai_base_url",group:"Auth & network",description:"Base URL override for the built-in openai model provider.",scope:"user",type:"String"},{key:"analytics.enabled",group:"Updates & telemetry",description:'When false, disables OpenAI analytics across Codex product surfaces in this profile. Custom OTLP metrics exporters remain enabled; set otel.metrics_exporter = "none" to disable them.',scope:"any",type:"Boolean"},{key:"check_for_update_on_startup",group:"Updates & telemetry",description:"When true, checks for Codex updates on startup and surfaces update prompts. Set to false only if your Codex updates are centrally managed. Defaults to true.",scope:"any",type:"Boolean"},{key:"cloud.skills.enabled",group:"Updates & telemetry",description:"Cloud skills are permitted by default; the host must supply a cloud provider.",scope:"any",type:"Boolean"},{key:"feedback.enabled",group:"Updates & telemetry",description:"When false, disables the feedback flow across Codex product surfaces.",scope:"any",type:"Boolean"},{key:"allow_symlinked_codex_home",group:"General",description:"Allow macOS sandbox writable roots at or beneath CODEX_HOME to traverse symlinks. Read only from the host's user config at startup; defaults to false. This grants no write access by itself, but trusts symlink targets even if they change between commands or lie outside CODEX_HOME\u2026",scope:"any",type:"Boolean"},{key:"apps_mcp_product_sku",group:"General",description:"Optional product SKU forwarded on host-owned Codex Apps MCP requests.",scope:"user",type:"String"},{key:"compact_prompt",group:"General",description:"Compact prompt used for history compaction.",scope:"any",type:"String"},{key:"developer_instructions",group:"General",description:"Developer instructions inserted as a developer role message.",scope:"any",type:"String"},{key:"disable_paste_burst",group:"General",description:"Legacy fallback for tui.disable_paste_burst. Prefer the setting under [tui].",scope:"any",type:"Boolean"},{key:"experimental_compact_prompt_file",group:"General",description:"A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem). IMPORTANT: When deserializing an AbsolutePathBuf, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set\u2026",scope:"any",type:"String"},{key:"experimental_realtime_start_instructions",group:"General",description:"Experimental / do not use. Replaces the built-in realtime start instructions inserted into developer messages when realtime becomes active.",scope:"any",type:"String"},{key:"experimental_realtime_webrtc_call_base_url",group:"General",description:"Experimental / do not use. Overrides only the WebRTC realtime call creation base URL. This is separate from experimental_realtime_ws_base_url because WebRTC call creation is HTTP, while sideband control is websocket.",scope:"user",type:"String"},{key:"experimental_realtime_ws_backend_prompt",group:"General",description:"Experimental / do not use. Overrides only the realtime conversation websocket transport instructions (the Op::RealtimeConversation /ws session.update instructions) without changing normal prompts.",scope:"any",type:"String"},{key:"experimental_realtime_ws_base_url",group:"General",description:"Experimental / do not use. Overrides only the realtime conversation websocket transport base URL (the Op::RealtimeConversation /v1/realtime connection) without changing normal provider HTTP requests.",scope:"user",type:"String"},{key:"experimental_realtime_ws_model",group:"General",description:"Experimental / do not use. Selects the realtime websocket model/snapshot used for the Op::RealtimeConversation connection.",scope:"any",type:"String"},{key:"experimental_realtime_ws_startup_context",group:"General",description:"Experimental / do not use. Replaces the synthesized realtime startup context appended to websocket session instructions. An empty string disables startup context injection entirely.",scope:"any",type:"String"},{key:"experimental_thread_store",group:"General",description:"Experimental / do not use. Selects the thread store implementation.",scope:"any",type:"Object"},{key:"file_opener",group:"General",description:"Optional URI-based file opener. If set, citations to files in the model output will be hyperlinked using the specified URI scheme.",scope:"any",type:"String",options:["vscode","vscode-insiders","windsurf","cursor","none"]},{key:"hide_agent_reasoning",group:"General",default:"false",description:"When set to true, AgentReasoning events will be hidden from the UI/output. Defaults to false.",scope:"any",type:"Boolean"},{key:"history.max_bytes",group:"General",description:"If set, the maximum size of the history file in bytes. The oldest entries are dropped once the file exceeds this limit.",scope:"any",type:"Integer"},{key:"history.persistence",group:"General",description:"If true, history entries will not be written to disk.",scope:"any",type:"String",options:["save-all","none"]},{key:"include_apps_instructions",group:"General",description:"Whether to inject the <apps_instructions> developer block.",scope:"any",type:"Boolean"},{key:"include_collaboration_mode_instructions",group:"General",description:"Whether to inject the <collaboration_mode> developer block.",scope:"any",type:"Boolean"},{key:"include_environment_context",group:"General",description:"Whether to inject the <environment_context> user block.",scope:"any",type:"Boolean"},{key:"include_environment_context_time",group:"General",description:"Whether environment context includes the current date and timezone.",scope:"any",type:"Boolean"},{key:"include_permissions_instructions",group:"General",description:"Whether to inject the <permissions instructions> developer block.",scope:"any",type:"Boolean"},{key:"instructions",group:"General",description:"System instructions.",scope:"any",type:"String"},{key:"log_dir",group:"General",description:"Directory where Codex writes log files. Setting this value explicitly also enables the TUI text log in this directory. Defaults to $CODEX_HOME/log.",scope:"any",type:"String"},{key:"notice",group:"General",description:"Collection of in-product notices (different from notifications) See [crate::types::Notice] for more details",scope:"any",type:"Object"},{key:"notify",group:"General",description:"Optional external command to spawn for end-user notifications.",scope:"user",type:"Array of String",shape:"array",valueType:"String"},{key:"otel.environment",group:"General",description:"Mark traces with environment (dev, staging, prod, test). Defaults to dev.",scope:"user",type:"String"},{key:"otel.exporter",group:"General",description:"Optional log exporter",scope:"user",type:"String",options:["none","statsig"]},{key:"otel.log_agent_responses",group:"General",description:"Opt in to logging final main-agent and spawned-subagent responses to an OTLP log exporter. Defaults to false. Response text can be sensitive and is capped at 64 KiB.",scope:"user",type:"Boolean"},{key:"otel.log_guardian_assessments",group:"General",description:"Opt in to logging completed Guardian assessments to an OTLP log exporter. Defaults to false. Rationales can be sensitive and are capped at 64 KiB.",scope:"user",type:"Boolean"},{key:"otel.log_user_prompt",group:"General",description:"Log user prompt in traces",scope:"user",type:"Boolean"},{key:"otel.metrics_exporter",group:"General",description:"Metrics exporter. Defaults to statsig, which follows analytics.enabled. Custom OTLP exporters are independent of analytics.enabled; none disables metrics export.",scope:"user",type:"String",options:["none","statsig"]},{key:"otel.span_attributes",group:"General",description:"Attributes to add to every exported trace span.",scope:"user",type:"Object",shape:"map",valueType:"String"},{key:"otel.tool_result.max_bytes",group:"General",default:"2048",description:"Maximum UTF-8 bytes before the truncation notice. Defaults to 2048.",scope:"user",type:"Integer"},{key:"otel.trace_exporter",group:"General",description:"Optional trace exporter",scope:"user",type:"String",options:["none","statsig"]},{key:"otel.tracestate",group:"General",description:"Semicolon-separated key:value fields to upsert into W3C tracestate members.",scope:"user",type:"Object",shape:"map",valueType:"Object"},{key:"personality",group:"General",description:"Deprecated: friendly and pragmatic no longer select a style.",scope:"any",type:"String",options:["none","friendly","pragmatic"]},{key:"responses_api_metadata",group:"General",description:"Bounded, product-owned metadata attached to every Responses API request.",scope:"user",type:"Object",shape:"map",valueType:"String"},{key:"show_raw_agent_reasoning",group:"General",description:"When set to true, AgentReasoningRawContentEvent events will be shown in the UI/output. Defaults to false.",scope:"any",type:"Boolean"},{key:"sqlite_home",group:"General",description:"Directory where Codex stores the SQLite state DB. Defaults to $CODEX_SQLITE_HOME when set. Otherwise uses $CODEX_HOME.",scope:"any",type:"String"},{key:"suppress_unstable_features_warning",group:"General",description:"Suppress warnings about unstable (under development) features.",scope:"any",type:"Boolean"},{key:"thread_unload_delay_secs",group:"General",description:"Seconds a thread must have no subscribers and no activity before app-server unloads it. Defaults to 1800 (30 minutes); zero unloads immediately. Resolved when each thread is loaded; request config overrides apply per thread.",scope:"any",type:"Integer"},{key:"windows.allow_mxc",group:"General",description:"False blocks both explicit MXC configuration and automatic selection.",scope:"any",type:"Boolean"},{key:"windows.sandbox",group:"General",description:"Windows-specific configuration.",scope:"any",type:"String",options:["elevated","unelevated","mxc"]}];

package/node_modules/@weavecode/harness/dist/codex/config.d.ts

@@ -0,0 +1,12 @@
+import type { ConfigSurface } from '../driver.js';
+/**
+ * 预写文件夹信任（init 时替用户答掉 codex 首开的「是否信任该文件夹」）：
+ * `~/.codex/config.toml` 的 `[projects.'<dir>'] trust_level = "trusted"`。
+ *
+ * 键形是 codex 自己的归一（本机 0.164 实测）：win32 = 全小写 + 反斜杠、
+ * literal string；posix = 原样。已有 `projects` 节时先按「忽略大小写与分隔符
+ * 等值」找既有键沿用其键形——codex 打开过的项目它自己已经写过一份，weave
+ * 再造一份异形键宿主不认。行级编辑保用户注释；损坏抛 `CodexTomlCorruptError`。
+ */
+export declare function ensureTrustAccepted(projectPath: string): Promise<void>;
+export declare const CODEX_CONFIG: ConfigSurface;

package/node_modules/@weavecode/harness/dist/codex/config.js

@@ -0,0 +1,3 @@
+import d from"node:fs/promises";import{homedir as k}from"node:os";import f from"node:path";import{parse as m}from"smol-toml";import{CODEX_CONFIG_GROUPS as S,CODEX_CONFIG_KEYS as b}from"./config-catalog.generated.js";import{codexHome as g}from"./home.js";import{CodexTomlCorruptError as y,setTomlValueInText as x}from"./toml.js";const A=[{id:"user",profiles:!0},{id:"project",profiles:!1}];function h(e,t){switch(e){case"user":return f.join(g(t.homedir),"config.toml");case"project":return f.join(t.projectPath??"",".codex","config.toml");default:return""}}function _(e){return e==="project"?b.filter(t=>t.scope!=="user"):b}function $(e){return new Set(_(e).map(t=>t.key.split(".")[0]))}function p(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function C(e){const t=[],r=e.mcp_servers;return p(r)&&"weave"in r&&t.push("mcp_servers.weave"),t}function F(e,t){let r=e.trim();return r==="~"?t:((r.startsWith("~/")||r.startsWith("~\\"))&&(r=f.join(t,r.slice(2))),f.isAbsolute(r)?r:f.join(g(t),r))}async function T(e){const t=e.values.model_catalog_json;if(typeof t!="string"||!t.trim())return{models:[],baseUrl:"",credential:"none"};const r=F(t,e.homedir??k());let o;try{o=await d.readFile(r,"utf-8")}catch{throw new Error(`model_catalog_json \u6307\u5411\u7684\u6587\u4EF6\u8BFB\u4E0D\u5230\uFF1A${r}`)}let s;try{s=JSON.parse(o)}catch{throw new Error(`model_catalog_json \u4E0D\u662F\u5408\u6CD5 JSON\uFF1A${r}`)}const i=p(s)?s.models:null;if(!Array.isArray(i))throw new Error("model catalog \u7F3A models \u6570\u7EC4");const a=[];for(const n of i)!p(n)||typeof n.slug!="string"||a.push({id:n.slug,...typeof n.display_name=="string"?{name:n.display_name}:{},...typeof n.description=="string"?{createdAt:n.description}:{}});return{models:a,baseUrl:"",credential:"none"}}export async function ensureTrustAccepted(e){const t=f.join(g(),"config.toml");let r="";try{r=await d.readFile(t,"utf-8")}catch{}let o;try{o=m(r)}catch(u){throw new y(`${t} is not valid TOML \u2014 refusing to write: ${u instanceof Error?u.message:String(u)}`)}const s=f.resolve(e),i=p(o.projects)?o.projects:{},a=(u,O)=>process.platform==="win32"?u.toLowerCase().replaceAll("/","\\")===O.toLowerCase().replaceAll("/","\\"):u===O,l=Object.keys(i).find(u=>a(u,s))??L(s),c=x(r,["projects",l,"trust_level"],"trusted");c!==r&&(await d.mkdir(f.dirname(t),{recursive:!0}),await d.writeFile(t,c,"utf-8"))}function L(e){return process.platform==="win32"?e.toLowerCase():e}export const CODEX_CONFIG={harness:"codex",files(e){return A.map(t=>({id:t.id,profiles:t.profiles,path:r=>h(t.id,r)}))},catalog(e){const t=_(e);return{groups:S.filter(r=>t.some(o=>o.group===r)),keys:t,envVars:[]}},async read(e,t){const r=h(e,t);let o;try{o=await d.readFile(r,"utf-8")}catch{return{}}let s;try{s=m(o)}catch(n){throw new y(`${r} is not valid TOML \u2014 refusing to read: ${n instanceof Error?n.message:String(n)}`)}if(!p(s))return{};const i=$(e),a={};for(const n of i)n in s&&(a[n]=s[n]);return a},async write(e,t,r){const o=h(e,t);let s="";try{s=await d.readFile(o,"utf-8")}catch{}let i;try{i=m(s)}catch(c){throw new y(`${o} is not valid TOML \u2014 refusing to write: ${c instanceof Error?c.message:String(c)}`)}const a=$(e),n={...i};for(const c of Object.keys(i))a.has(c)&&!(c in r)&&delete n[c];for(const[c,u]of Object.entries(r))a.has(c.split(".")[0])&&(n[c]=u);const l=E(n);await d.mkdir(f.dirname(o),{recursive:!0}),await d.writeFile(o,l,"utf-8")},managedKeys:C,managedEntries(){return[]},models:T,rawFormat:"toml",parseRaw(e){const t=m(e);if(!p(t))throw new Error("\u9876\u5C42\u5FC5\u987B\u662F\u8868");return t},serializeRaw(e){return E(e)}};function E(e){const t=[],r=(o,s)=>{const i=[],a=[];for(const[n,l]of Object.entries(s))p(l)&&!N(l)?a.push([n,l]):i.push(`${w(n)} = ${j(l)}`);o.length>0&&(i.length>0||a.length===0)&&(t.length>0&&t.push(""),t.push(`[${o.map(w).join(".")}]`)),t.push(...i);for(const[n,l]of a)r([...o,n],l)};return r([],e),t.length>0?`${t.join(`
+`)}
+`:""}function N(e){return Object.keys(e).length===0}function w(e){return/^[A-Za-z0-9_-]+$/.test(e)?e:JSON.stringify(e)}function j(e){return e==null?'""':typeof e=="boolean"?e?"true":"false":typeof e=="number"?Number.isFinite(e)?String(e):'""':typeof e=="string"?K(e):Array.isArray(e)?`[${e.map(j).join(", ")}]`:`{ ${Object.entries(e).filter(([,r])=>r!==void 0).map(([r,o])=>`${w(r)} = ${j(o)}`).join(", ")} }`}function K(e){const t=e.includes("\\"),r=!e.includes("'")&&!/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f\n]/.test(e);return t&&r?`'${e}'`:JSON.stringify(e)}

package/node_modules/@weavecode/harness/dist/codex/detect.js

@@ -1 +1 @@
-import{existsSync as s}from"node:fs";import n from"node:path";const o=[".codex","AGENTS.md"];function t(e){return o.some(r=>s(n.join(e,r)))}export const CODEX_DETECTOR={markers:o,present:t,detect:e=>({harness:"codex",present:t(e)})};
+import{existsSync as n}from"node:fs";import s from"node:path";const t=[".codex","AGENTS.md"];function o(e){return t.some(r=>n(s.join(e,r)))}export const CODEX_DETECTOR={markers:t,present:o,detect:e=>({harness:"codex",present:o(e)})};

package/node_modules/@weavecode/harness/dist/codex/event-source.d.ts

@@ -1,3 +1,69 @@
+import { type Harness } from '@weavecode/core';
 import type { EventSource } from '../driver.js';
-/** Codex 一期不注册事件（B0 闸门）；事件面待调研锁定后随批 4b 及之后迁入。 */
-export declare const CODEX_EVENT_SOURCE: EventSource | null;
+/** 规范名 → codex 线名（`hooks.json` 声明用；上表的逆，别处不再手抄一份线名表）。 */
+export declare const CANONICAL_TO_WIRE: Readonly<Record<string, string>>;
+/** 一条 rollout 行（`type` + `payload`；`ordinal` 是同 thread 的序号，跨 resume 文件连续）。 */
+export interface CodexLine {
+    timestamp?: string;
+    ordinal?: number;
+    type?: string;
+    payload?: Record<string, unknown>;
+}
+/** rollout 日志源产出的一条上报：行本体 + 边读边算出的旁路事实（本轮最终 assistant 消息）。 */
+export interface CodexReport {
+    eventType: string;
+    sessionId?: string;
+    cwd?: string;
+    payload: {
+        line: CodexLine;
+        lastAgentMessage?: string | null;
+    };
+}
+/** hook 上报体（结构对齐 server `hooks/types.ts` 的 HookReport；本包仅依赖 core，按结构自持）。 */
+export interface CodexHookReport {
+    source: Harness;
+    eventType: string;
+    sessionId?: string | null;
+    cwd?: string;
+    /** codex hook stdin 的原始 JSON。 */
+    payload: string;
+}
+/** 归一化后的入库行（结构对齐 server `repositories/hook-events.ts` 的 HookEventInput）。 */
+export interface CodexHookEventInput {
+    projectId: number;
+    source: Harness;
+    eventType: string;
+    sessionId?: string;
+    payload: string;
+}
+/** `session_meta` 里的会话身份与工作目录（日志源判白名单与归一化共用这一份解析）。 */
+export declare function metaOfLine(line: CodexLine): {
+    sessionId: string;
+    cwd: string | null;
+} | null;
+/**
+ * 用户输入的正文。**跨版本两种落点**：≤0.150 是 `event_msg:user_message.message`，
+ * 0.163 换成 `event_msg:item_completed.item.type='UserMessage'` 的 content（同文件
+ * 不会两者都有，实测 53 个文件按版本排他）。`response_item:message(role=user)` 是
+ * 转录镜像、不是事件流，不采（采了会与上面重复一条）。
+ */
+export declare function promptOfLine(line: CodexLine): string | null;
+/**
+ * 一个 rollout 文件的行 →事件转换器（**顺带维护本轮缓存**：codex 的 agent 消息
+ * 不带 turn_id，只得按行序分轮——任务开始 / 用户输入清空，`task_complete` 取走）。
+ *
+ * 白名单是卷控的第一道闸：本机 8.5 万行里 `response_item` 4.3 万、`AgentMessage`
+ * 4.1 万，进 dashboard 的只有下面这几类。`world_state` / `turn_context` /
+ * `token_count` / `thread_settings_applied` 一律不落库。
+ */
+export declare class CodexTurnBuffer {
+    private last;
+    report(line: CodexLine): CodexReport | null;
+}
+export declare class CodexEventSource implements EventSource {
+    readonly source: "codex";
+    readonly events: readonly ["SessionStart", "UserPromptSubmit", "Stop", "TurnAborted", "PostToolUse", "SessionEnd", "PreCompact", "PostCompact", "SubagentStart", "SubagentStop", "PermissionRequest"];
+    normalize(report: unknown, projectId: number): CodexHookEventInput;
+}
+/** 事件接入实例（driver events 槽消费；normalize 无状态，单例安全）。 */
+export declare const CODEX_EVENT_SOURCE: CodexEventSource;

package/node_modules/@weavecode/harness/dist/codex/event-source.js

@@ -1 +1,2 @@
-export const CODEX_EVENT_SOURCE=null;
+import{HARNESS_EVENTS as _}from"@weavecode/core";import{capFields as l}from"../shared/json-cap.js";import{CLAUDE_EVENT_SOURCE as g}from"../claude/event-source.js";const u={Interrupt:"TurnAborted"};export const CANONICAL_TO_WIRE=Object.fromEntries(Object.entries(u).map(([n,t])=>[t,n]));export function metaOfLine(n){if(n.type!=="session_meta")return null;const t=n.payload??{};return typeof t.session_id!="string"||!t.session_id?null:{sessionId:t.session_id,cwd:typeof t.cwd=="string"&&t.cwd?t.cwd:null}}function i(n){return Array.isArray(n)&&n.map(e=>{const o=e;return(typeof o?.type=="string"?o.type.toLowerCase():"")==="text"&&typeof o.text=="string"?o.text:""}).filter(Boolean).join(`
+`)||null}export function promptOfLine(n){const t=n.payload??{};if(t.type==="user_message")return typeof t.message=="string"&&t.message?t.message:null;if(t.type!=="item_completed")return null;const e=t.item;return e?.type!=="UserMessage"?null:i(e.content)}function p(n){const t=n.payload??{};if(t.type!=="item_completed")return null;const e=t.item;if(!e||typeof e!="object")return null;const o=e.type;return typeof o=="string"?{type:o,item:e}:null}export class CodexTurnBuffer{last=null;report(t){const e=t.payload??{},o=typeof e.type=="string"?e.type:null,s=p(t);if(o==="agent_message")return typeof e.message=="string"&&e.message&&(this.last=e.message),null;if(s?.type==="AgentMessage"){const r=i(s.item.content);return r&&(this.last=r),null}if(promptOfLine(t)!==null)return this.last=null,{eventType:"UserPromptSubmit",payload:{line:t}};if(t.type==="session_meta")return{eventType:"SessionStart",payload:{line:t}};if(o==="task_started")return this.last=null,null;if(o==="task_complete"){const r=this.last;return this.last=null,{eventType:"Stop",payload:{line:t,lastAgentMessage:r}}}return o==="turn_aborted"?{eventType:"TurnAborted",payload:{line:t}}:o==="exec_command_end"||o==="patch_apply_end"?{eventType:"PostToolUse",payload:{line:t}}:s?.type==="CommandExecution"||s?.type==="FileChange"||s?.type==="McpToolCall"?{eventType:"PostToolUse",payload:{line:t}}:null}}function c(n){return Array.isArray(n)?n.filter(t=>typeof t=="string").join(" "):typeof n=="string"?n:null}function x(n){const t=n.payload??{};if(t.type==="exec_command_end")return{toolName:"exec_command",toolInput:{command:c(t.command),cwd:t.cwd??null},toolResponse:{exit_code:t.exit_code??null,status:t.status??null}};if(t.type==="patch_apply_end"){const o=t.changes&&typeof t.changes=="object"?t.changes:{};return{toolName:"apply_patch",toolInput:{paths:Object.keys(o)},toolResponse:{success:t.success??null}}}const e=p(n);if(e?.type==="CommandExecution")return{toolName:"exec_command",toolInput:{command:c(e.item.command),cwd:e.item.cwd??null},toolResponse:{exit_code:e.item.exit_code??null,status:e.item.status??null}};if(e?.type==="FileChange"){const o=e.item.changes&&typeof e.item.changes=="object"?e.item.changes:{};return{toolName:"apply_patch",toolInput:{paths:Object.keys(o)},toolResponse:{status:e.item.status??null}}}return e?.type==="McpToolCall"?{toolName:typeof e.item.name=="string"?e.item.name:"mcp_tool_call",toolInput:e.item.arguments??null,toolResponse:e.item.result??e.item.status??null}:{toolName:null,toolInput:null,toolResponse:null}}function T(n,t){return typeof n.last_agent_message=="string"&&n.last_agent_message?n.last_agent_message:t??null}function h(n){const t=n.error;if(typeof t=="string"&&t)return t;if(t&&typeof t=="object"){const e=t.message;if(typeof e=="string"&&e)return e}return null}export class CodexEventSource{source="codex";events=_.codex;normalize(t,e){const o=t??{};return typeof o.payload=="string"?O(o,e):w(o,e)}}function O(n,t){const e=n.eventType||"unknown",o=u[e]??e;return{...g.normalize({...n,eventType:o},t),source:"codex"}}function w(n,t){const e=n.payload?.line??{},o=e.payload??{},s=n.eventType||"unknown",r={};if(s==="UserPromptSubmit")r.prompt=promptOfLine(e)??"";else if(s==="Stop"){r.last_assistant_message=T(o,n.payload?.lastAgentMessage);const a=h(o);a&&(r.error=a)}else s==="TurnAborted"?(r.reason=o.reason??null,r.duration_ms=o.duration_ms??null):s==="SessionStart"&&(r.source="rollout");e.ordinal!==void 0&&(r.seq=e.ordinal);const{toolName:m,toolInput:f,toolResponse:y}=x(e),d={eventType:s,toolName:m,toolInput:l(f),toolResponse:l(y),cwd:n.cwd??null,raw:l({...r,turn_id:o.turn_id??null,call_id:o.call_id??null})};return{projectId:t,source:"codex",eventType:s,sessionId:n.sessionId,payload:JSON.stringify(d)}}export const CODEX_EVENT_SOURCE=new CodexEventSource;

package/node_modules/@weavecode/harness/dist/codex/home.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 宿主的配置根（`CODEX_HOME` 缺省 `~/.codex`）——rollout 落盘根与 hooks.json 都在
+ * 它下面，两处共用这一份解析。给了 `home` 就只认它：测试注入主目录时必须绕开本机
+ * 真实的 `CODEX_HOME`，否则写到用户目录里。
+ */
+export declare function codexHome(home?: string): string;

package/node_modules/@weavecode/harness/dist/codex/home.js

@@ -0,0 +1 @@
+import{homedir as n}from"node:os";import r from"node:path";export function codexHome(e){if(e)return r.join(e,".codex");const o=process.env.CODEX_HOME;return o&&o.trim()?r.resolve(o):r.join(n(),".codex")}

package/node_modules/@weavecode/harness/dist/codex/images.d.ts

@@ -0,0 +1,2 @@
+import type { ImagesSurface } from '../driver.js';
+export declare const CODEX_IMAGES: ImagesSurface;

package/node_modules/@weavecode/harness/dist/codex/images.js

@@ -0,0 +1 @@
+import{createReadStream as f}from"node:fs";import{createInterface as u}from"node:readline";const m=new Set(["image/png","image/jpeg","image/gif","image/webp"]),p=10*1024*1024,l=/^data:([^;,]+);base64,(.*)$/s;function y(e){if(!Array.isArray(e))return[];const t=[];for(const i of e){if(!i||typeof i!="object")continue;const o=i;if(o.type!=="image")continue;const n=typeof o.image_url=="string"?o.image_url:null;if(!n)continue;const c=l.exec(n);if(!c)continue;const r=c[1];if(!m.has(r))continue;const s=Buffer.from(c[2],"base64");s.length===0||s.length>p||t.push({mediaType:r,bytes:s})}return t}function g(e){return Array.isArray(e)?e.map(t=>t&&typeof t=="object"&&t.type==="text"?String(t.text??""):"").join(""):""}export const CODEX_IMAGES={async sessionImages({transcriptPath:e}){if(!e)return null;const t=[],i=u({input:f(e,{encoding:"utf8"}),crlfDelay:1/0});try{for await(const o of i){if(!o.includes('"type":"image"'))continue;const n=JSON.parse(o);if(n.type!=="event_msg")continue;const c=n.payload;if(c?.type!=="item_completed")continue;const r=c.item;if(r?.type!=="UserMessage")continue;const s=r.content,a=y(s);a.length!==0&&t.push({text:g(s),at:typeof n.timestamp=="string"?n.timestamp:null,images:a})}}catch{return null}finally{i.close()}return t}};

package/node_modules/@weavecode/harness/dist/codex/index.d.ts

@@ -1,13 +1,35 @@
 import type { HarnessDriver } from '../driver.js';
 export { CODEX_DETECTOR } from './detect.js';
 export { CODEX_PLUGIN_STATE } from './plugin-state.js';
+export { CODEX_IMAGES } from './images.js';
+export { CODEX_NARRATION } from './narration.js';
 export { CODEX_MESSAGING } from './messaging.js';
+export { CODEX_QUESTIONS } from './questions.js';
+export { CODEX_RESUME } from './resume.js';
+export { CODEX_EVENT_SOURCE, CodexEventSource, CodexTurnBuffer } from './event-source.js';
+export { CODEX_LOG_SOURCE, CodexLogSource } from './rollout.js';
+export { CODEX_CAPTURE } from './capture.js';
+export { codexInterruptMarkerAt } from './transcript.js';
+export { CODEX_PLUGINS, createCodexPluginSurface, CODEX_MARKETPLACE } from './plugins.js';
+export { CODEX_CONFIG, ensureTrustAccepted as ensureCodexTrustAccepted } from './config.js';
+export { CODEX_PROVISION, codexProvisionCheck } from './provision.js';
 export * from './mcp.js';
 export * from './toml.js';
+export { CODEX_COMMANDS } from './commands.js';
+export { CODEX_LIVENESS, codexLivenessById, codexThreadLockDir, CODEX_LOCK_GRACE_MS, type LockProbe, } from './liveness.js';
+export { CODEX_TITLES, codexSessionTitleOf, codexSetSessionTitle } from './titles.js';
 /**
  * Codex 接入模块的驱动：批 4a 补 assets 槽、批 5 补 detect、P2 补 pluginState
- * （config.toml 启用态）、session-orchestration 批 1 补 messaging（显式不支持面）——
- * init 槽不在此（由 cli init/wiring 携带）；events/resume/plugins 无对等物（❌，
- * 永不注册，同 codex/resume.ts 的 unsupported 先例——Codex 无插件安装/市场机制）。
+ * （config.toml 启用态）、session-orchestration 批 1 补 messaging（显式不支持面）、
+ * 起会话补 resume、**采集补 capture + events**（codex 0.163 的 hooks 引擎装
+ * `<CODEX_HOME>/hooks.json`，见 `capture.ts`）、logs 降为兜底（hooks 未被信任
+ * 时仍能看到存量会话）、**plugins 补安装/市场面**（`codex plugin add` /
+ * `marketplace`，见 `plugins.ts`）、**config 补配置面**（config.toml 词表 +
+ * TOML 读写，见 `config.ts`）、**provision 补安装形态检查**（桌面端/CLI 双面孔
+ * 的版本漂移警告，见 `provision.ts`）、**images 补入站图**（rollout 的
+ * UserMessage 条目，见 `images.ts`）、**questions 补阻塞式交互**（审批对话框
+ * 的 PermissionRequest hook 采集 + 稳定键位作答，见 `questions.ts`）、**titles 补
+ * 会话标题读写**（session_index 读 + thread/name/set 写，见 `titles.ts`）——init
+ * 槽不在此（由 cli init/wiring 携带）。
  */
 export declare const CODEX_DRIVER: HarnessDriver;

package/node_modules/@weavecode/harness/dist/codex/index.js

@@ -1 +1 @@
-import{CODEX_ASSETS as o}from"./assets.js";import{CODEX_DETECTOR as t}from"./detect.js";import{CODEX_MESSAGING as e}from"./messaging.js";import{CODEX_PLUGIN_STATE as r}from"./plugin-state.js";export{CODEX_DETECTOR}from"./detect.js";export{CODEX_PLUGIN_STATE}from"./plugin-state.js";export{CODEX_MESSAGING}from"./messaging.js";export*from"./mcp.js";export*from"./toml.js";export const CODEX_DRIVER={id:"codex",displayName:"Codex",capabilities:["assets","detect","pluginState","messaging"],assets:o,detect:t,pluginState:r,messaging:e};
+import{CODEX_ASSETS as o}from"./assets.js";import{CODEX_CAPTURE as r}from"./capture.js";import{CODEX_CONFIG as e}from"./config.js";import{CODEX_DETECTOR as E}from"./detect.js";import{CODEX_EVENT_SOURCE as t}from"./event-source.js";import{CODEX_IMAGES as m}from"./images.js";import{CODEX_NARRATION as C}from"./narration.js";import{CODEX_MESSAGING as O}from"./messaging.js";import{CODEX_PLUGINS as i}from"./plugins.js";import{CODEX_PLUGIN_STATE as p}from"./plugin-state.js";import{CODEX_PROVISION as s}from"./provision.js";import{CODEX_QUESTIONS as _}from"./questions.js";import{CODEX_RESUME as f}from"./resume.js";import{CODEX_LOG_SOURCE as D}from"./rollout.js";import{CODEX_COMMANDS as S}from"./commands.js";import{CODEX_LIVENESS as X}from"./liveness.js";import{CODEX_TITLES as n}from"./titles.js";export{CODEX_DETECTOR}from"./detect.js";export{CODEX_PLUGIN_STATE}from"./plugin-state.js";export{CODEX_IMAGES}from"./images.js";export{CODEX_NARRATION}from"./narration.js";export{CODEX_MESSAGING}from"./messaging.js";export{CODEX_QUESTIONS}from"./questions.js";export{CODEX_RESUME}from"./resume.js";export{CODEX_EVENT_SOURCE,CodexEventSource,CodexTurnBuffer}from"./event-source.js";export{CODEX_LOG_SOURCE,CodexLogSource}from"./rollout.js";export{CODEX_CAPTURE}from"./capture.js";export{codexInterruptMarkerAt}from"./transcript.js";export{CODEX_PLUGINS,createCodexPluginSurface,CODEX_MARKETPLACE}from"./plugins.js";export{CODEX_CONFIG,ensureTrustAccepted as ensureCodexTrustAccepted}from"./config.js";export{CODEX_PROVISION,codexProvisionCheck}from"./provision.js";export*from"./mcp.js";export*from"./toml.js";export{CODEX_COMMANDS}from"./commands.js";export{CODEX_LIVENESS,codexLivenessById,codexThreadLockDir,CODEX_LOCK_GRACE_MS}from"./liveness.js";export{CODEX_TITLES,codexSessionTitleOf,codexSetSessionTitle}from"./titles.js";export const CODEX_DRIVER={id:"codex",displayName:"Codex",capabilities:["assets","detect","plugins","pluginState","messaging","resume","events","capture","logs","config","commands","provision","liveness","images","narration","questions"],assets:o,detect:E,plugins:i,pluginState:p,messaging:O,resume:f,events:t,capture:r,logs:D,config:e,commands:S,provision:s,liveness:X,images:m,narration:C,questions:_,titles:n};

package/node_modules/@weavecode/harness/dist/codex/liveness.d.ts

@@ -0,0 +1,38 @@
+import type { LivenessSurface } from '../driver.js';
+/**
+ * codex 会话存活判定：codex 没有进程注册表，但每个活跃 thread 在
+ * `<CODEX_HOME>/thread-writer-locks/<sessionId>.lock` 持一把**独占**写锁
+ * （先于 rollout 创建、全程持有——实测跨回合与长空闲不释放、正常关闭即删、
+ * 崩溃后句柄由内核释放但文件残留）——HELD = 活。
+ * node 的 libuv 恒以全共享打开文件探不到独占锁，批量探测经 PowerShell 一枪
+ * （`[IO.File]::Open` 以 None 共享开，IOException = HELD；~0.7s/轮，2026-10-26 实测）。
+ * `.coordination.lock` 等非 UUID 命名不是 thread 锁，跳过。
+ *
+ * 失去 HELD（FREE/文件消失）**不当场判死**：锁的释放瞬间（正在关闭、queue
+ * 命令触碰）不该让在途消息落定——宽限窗（`CODEX_LOCK_GRACE_MS`）内不输出
+ * （当未知），过窗才输出 false。宽限锚点 = 最后一次见到 HELD 的时刻；daemon
+ * 重启后状态清零，用 FREE 锁文件的 mtime 兜底（0 字节文件 mtime ≈ 创建时刻
+ * ≤ 死亡时刻，宽限只会长不会短）。与 claude 注册表的豁免窗同构。
+ */
+/** 失去 HELD 后的宽限窗：期内当未知，过窗才判死。 */
+export declare const CODEX_LOCK_GRACE_MS = 90000;
+/** 锁目录（`home` 注入供测试；缺省 `codexHome()`）。 */
+export declare function codexThreadLockDir(home?: string): string;
+/**
+ * 批量锁探针的注入口（测试注入假实现）；缺省 spawn PowerShell 一枪探全部，
+ * 回 HELD 的锁名集合。探针失败（超时/spawn 不出）回空集——只损失 true
+ * （当未知），绝不产生错误的「死」。
+ */
+export type LockProbe = (lockNames: readonly string[]) => Promise<Set<string>>;
+/**
+ * codex 存活图：目录里全部 thread 锁 → 一枪探针 → 合成宽限三态。
+ * HELD → true（刷新锚点）；失去 HELD → 宽限期内不输出（当未知）、过窗 false；
+ * 从没见过的 FREE 锁用 mtime 当锚点（重启后崩溃残留立即可判）。
+ * 探针失败回空 map（全不判，不许误判死）。
+ */
+export declare function codexLivenessById(home?: string, now?: number): Promise<Map<string, boolean>>;
+/**
+ * codex 的存活面：锁探针异步批量（spawn 一枪）+ 宽限窗状态在本模块——
+ * 消费方要同步 map，由装配层缓存（server 的判活装配按 15s 一拍刷新）。
+ */
+export declare const CODEX_LIVENESS: LivenessSurface;

package/node_modules/@weavecode/harness/dist/codex/liveness.js

@@ -0,0 +1 @@
+import{readdirSync as f,statSync as m}from"node:fs";import u from"node:path";import{codexHome as w}from"./home.js";export const CODEX_LOCK_GRACE_MS=9e4;const h=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\.lock$/i;export function codexThreadLockDir(o){return u.join(w(o),"thread-writer-locks")}async function S(o,a){const{spawn:r}=await import("node:child_process"),i=t=>t.replace(/'/g,"''"),s=["$results = @()",...o.map(t=>{const p=u.win32.join(a,t);return`try { [void][IO.File]::Open('${i(p)}','Open','ReadWrite','None') } catch [IO.IOException] { $results += '${i(t)}' }`}),'$results -join "`n"'].join("; ");return new Promise(t=>{let p="";const c=r("powershell",["-NoProfile","-NonInteractive","-Command",s],{windowsHide:!0,stdio:["ignore","pipe","pipe"]}),e=setTimeout(()=>{c.kill("SIGKILL"),t(new Set)},5e3);c.stdout?.on("data",n=>p+=n.toString()),c.on("error",()=>{clearTimeout(e),t(new Set)}),c.on("close",()=>{clearTimeout(e),t(new Set(p.split(/\r?\n/).map(n=>n.trim()).filter(Boolean)))})})}async function y(){return new Set}const d=new Map;export async function codexLivenessById(o,a=Date.now()){const r=codexThreadLockDir(o);let i;try{i=f(r)}catch{return new Map}const s=i.filter(e=>h.test(e)),p=await(s.length===0?async()=>new Set:process.platform==="win32"?e=>S(e,r):()=>y())(s),c=new Map;for(const e of s){const n=e.replace(/\.lock$/i,"");if(p.has(e)){d.set(n,a),c.set(n,!0);continue}let l=d.get(n);if(l===void 0){try{l=m(u.join(r,e)).mtimeMs}catch{continue}d.set(n,l)}a-l>=CODEX_LOCK_GRACE_MS&&c.set(n,!1)}return c}export const CODEX_LIVENESS={harness:"codex",alive(o){return codexLivenessById().then(a=>{if(!o)return a;const r=new Map;for(const i of o){const s=a.get(i);s!==void 0&&r.set(i,s)}return r})}};

package/node_modules/@weavecode/harness/dist/codex/mcp.d.ts

@@ -4,8 +4,8 @@ import type { McpServerConfig } from '../driver.js';
  * 这一形是 codex 自己的知识，调用方只传名字与 `McpServerConfig`。
  */
 /** Read the `mcp_servers` map from config.toml text (empty when absent or
- * unparseable). stdio servers only — entries without a `command` (e.g. remote
- * url servers) are skipped. */
+ * unparseable). Entries with neither `url` (Streamable HTTP) nor `command`
+ * (stdio) are skipped. */
 export declare function readCodexMcpFromText(text: string): Record<string, McpServerConfig>;
 /** Insert or replace an `[mcp_servers.<name>]` entry in config.toml text,
  * preserving everything else. Merge-validated: if preserving user-added keys

package/node_modules/@weavecode/harness/dist/codex/mcp.js

@@ -1 +1 @@
-import{readFile as p,writeFile as w,access as S,mkdir as M}from"node:fs/promises";import $ from"node:path";import{parse as m}from"smol-toml";import{CodexTomlCorruptError as l,parseSectionEntries as h,removeTomlSection as b,renderTomlHeader as j,renderTomlKey as A,renderTomlString as y,sameKey as d,splitTomlSections as v,upsertTomlSection as x}from"./toml.js";export function readCodexMcpFromText(r){let e;try{e=m(r)}catch{return{}}const n=e.mcp_servers;if(!n||typeof n!="object"||Array.isArray(n))return{};const t={};for(const[s,o]of Object.entries(n)){const i=C(o);i&&(t[s]=i)}return t}function C(r){if(!r||typeof r!="object"||Array.isArray(r))return null;const e=r;if(typeof e.command!="string")return null;const n={command:e.command};if(Array.isArray(e.args)){const t=e.args.filter(s=>typeof s=="string");t.length>0&&(n.args=t)}if(e.env&&typeof e.env=="object"&&!Array.isArray(e.env)){const t={};for(const[s,o]of Object.entries(e.env))typeof o=="string"&&(t[s]=o);Object.keys(t).length>0&&(n.env=t)}return n}function T(r,e,n,t,s){const o=[`command = ${y(e.command)}`];if(e.args&&e.args.length>0&&o.push(`args = [${e.args.map(y).join(", ")}]`),s&&n){const a=new Set(["command","args","env"]);for(const[c,u]of h(n.lines.slice(1)))a.has(c)||o.push(u)}const i=Object.entries(e.env??{}),f=s&&t?h(t.lines.slice(1)).filter(([a])=>!(a in(e.env??{}))):[];if(i.length>0||f.length>0){o.push(""),o.push(j([...r,"env"]));for(const[a,c]of i)o.push(`${A(a)} = ${y(c)}`);for(const[,a]of f)o.push(a)}return o}export function upsertCodexMcpInText(r,e,n){const t=["mcp_servers",e],s=_(r);if(s)throw s;const o=v(r),i=o.find(c=>d(c.key,t)),f=o.find(c=>d(c.key,[...t,"env"])),a=x(r,t,T(t,n,i,f,!0));try{return m(a),a}catch{const c=x(r,t,T(t,n,i,f,!1));try{return m(c),c}catch(u){throw new l(`unable to produce valid TOML for [mcp_servers.${e}]: ${u instanceof Error?u.message:String(u)}`)}}}export function removeCodexMcpFromText(r,e){return b(r,["mcp_servers",e])}function _(r){return v(r)[0].lines.find(e=>/^\s*mcp_servers\s*=/.test(e))?new l('~/.codex/config.toml defines "mcp_servers" as an inline value \u2014 weave only manages the [mcp_servers.<name>] section form'):null}async function E(r){try{return await p(r,"utf-8")}catch{return""}}async function g(r){try{return await S(r),!0}catch{return!1}}export async function readCodexMcpServers(r){return await g(r)?readCodexMcpFromText(await p(r,"utf-8")):{}}export async function codexMcpExists(r,e){return await g(e)?O(await p(e,"utf-8"),["mcp_servers",r]):!1}function O(r,e){return v(r).some(n=>d(n.key,e))}export async function writeCodexMcpServer(r,e,n){const t=await E(n);if(t.trim()!=="")try{m(t)}catch(s){throw new l(`${n} is not valid TOML \u2014 refusing to write: ${s instanceof Error?s.message:String(s)}`)}await M($.dirname(n),{recursive:!0}),await w(n,upsertCodexMcpInText(t,r,e),"utf-8")}export async function removeCodexMcpServer(r,e){if(!await g(e))return!1;const n=await p(e,"utf-8");try{m(n)}catch(o){throw new l(`${e} is not valid TOML \u2014 refusing to write: ${o instanceof Error?o.message:String(o)}`)}const{text:t,removed:s}=removeCodexMcpFromText(n,r);return s&&await w(e,t,"utf-8"),s}
+import{readFile as d,writeFile as g,access as T,mkdir as k}from"node:fs/promises";import $ from"node:path";import{parse as m}from"smol-toml";import{CodexTomlCorruptError as v,parseSectionEntries as w,removeTomlSection as M,renderTomlHeader as S,renderTomlKey as x,renderTomlString as f,sameKey as y,splitTomlSections as l,upsertTomlSection as _}from"./toml.js";export function readCodexMcpFromText(r){let e;try{e=m(r)}catch{return{}}const n=e.mcp_servers;if(!n||typeof n!="object"||Array.isArray(n))return{};const t={};for(const[o,s]of Object.entries(n)){const c=E(s);c&&(t[o]=c)}return t}function j(r){if(!r||typeof r!="object"||Array.isArray(r))return;const e={};for(const[n,t]of Object.entries(r))typeof t=="string"&&(e[n]=t);return Object.keys(e).length>0?e:void 0}function E(r){if(!r||typeof r!="object"||Array.isArray(r))return null;const e=r;if(typeof e.url=="string"){const t={url:e.url},o=j(e.http_headers);return o&&(t.headers=o),typeof e.bearer_token_env_var=="string"&&(t.bearerTokenEnvVar=e.bearer_token_env_var),t}if(typeof e.command!="string")return null;const n={command:e.command};if(Array.isArray(e.args)){const t=e.args.filter(o=>typeof o=="string");t.length>0&&(n.args=t)}if(e.env&&typeof e.env=="object"&&!Array.isArray(e.env)){const t={};for(const[o,s]of Object.entries(e.env))typeof s=="string"&&(t[o]=s);Object.keys(t).length>0&&(n.env=t)}return n}function b(r,e,n,t,o){const s=[];if("command"in e)s.push(`command = ${f(e.command)}`),e.args&&e.args.length>0&&s.push(`args = [${e.args.map(f).join(", ")}]`);else{s.push(`url = ${f(e.url)}`),e.bearerTokenEnvVar&&s.push(`bearer_token_env_var = ${f(e.bearerTokenEnvVar)}`);const a=Object.entries(e.headers??{});a.length>0&&s.push(`http_headers = { ${a.map(([i,u])=>`${x(i)} = ${f(u)}`).join(", ")} }`)}if(o&&n){const a=new Set(["command","args","env","url","http_headers","bearer_token_env_var"]);for(const[i,u]of w(n.lines.slice(1)))a.has(i)||s.push(u)}const c=Object.entries("env"in e?e.env??{}:{}),p=o&&t?w(t.lines.slice(1)).filter(([a])=>!(a in("env"in e?e.env??{}:{}))):[];if(c.length>0||p.length>0){s.push(""),s.push(S([...r,"env"]));for(const[a,i]of c)s.push(`${x(a)} = ${f(i)}`);for(const[,a]of p)s.push(a)}return s}export function upsertCodexMcpInText(r,e,n){const t=["mcp_servers",e],o=A(r);if(o)throw o;const s=l(r),c=s.find(i=>y(i.key,t)),p=s.find(i=>y(i.key,[...t,"env"])),a=_(r,t,b(t,n,c,p,!0));try{return m(a),a}catch{const i=_(r,t,b(t,n,c,p,!1));try{return m(i),i}catch(u){throw new v(`unable to produce valid TOML for [mcp_servers.${e}]: ${u instanceof Error?u.message:String(u)}`)}}}export function removeCodexMcpFromText(r,e){return M(r,["mcp_servers",e])}function A(r){return l(r)[0].lines.find(t=>/^\s*mcp_servers\s*=/.test(t))?new v('~/.codex/config.toml defines "mcp_servers" as an inline value \u2014 weave only manages the [mcp_servers.<name>] section form'):null}async function O(r){try{return await d(r,"utf-8")}catch{return""}}async function h(r){try{return await T(r),!0}catch{return!1}}export async function readCodexMcpServers(r){return await h(r)?readCodexMcpFromText(await d(r,"utf-8")):{}}export async function codexMcpExists(r,e){return await h(e)?C(await d(e,"utf-8"),["mcp_servers",r]):!1}function C(r,e){return l(r).some(n=>y(n.key,e))}export async function writeCodexMcpServer(r,e,n){const t=await O(n);if(t.trim()!=="")try{m(t)}catch(o){throw new v(`${n} is not valid TOML \u2014 refusing to write: ${o instanceof Error?o.message:String(o)}`)}await k($.dirname(n),{recursive:!0}),await g(n,upsertCodexMcpInText(t,r,e),"utf-8")}export async function removeCodexMcpServer(r,e){if(!await h(e))return!1;const n=await d(e,"utf-8");try{m(n)}catch(s){throw new v(`${e} is not valid TOML \u2014 refusing to write: ${s instanceof Error?s.message:String(s)}`)}const{text:t,removed:o}=removeCodexMcpFromText(n,r);return o&&await g(e,t,"utf-8"),o}

package/node_modules/@weavecode/harness/dist/codex/messaging.d.ts

@@ -1,8 +1,26 @@
-import type { MessagingSurface } from '../driver.js';
+import type { AttachSpec, MessagingSurface, QueuedPromptSpec } from '../driver.js';
 /**
- * Codex 消息能力面：**显式不支持面**（全通道 null + 原因，不是槽位缺席——
- * 缺席无法渲染「为什么置灰」）。prompt 例外走层②：无原生 peer 消息，但终端
- * send-text 兜底可用时路由侧点亮（矩阵口径 = 原生 || 终端兜底）。B0 调研
- * （BACKLOG §10-6）落地后在本文件逐通道点亮，编排层零改动。
+ * codex 的宿主排队投递：`codex queue --thread <UUID> --message <TEXT>` 经
+ * app-server 的 `thread/queue/add` 写进目标会话自己的队列——活会话 <1s 注入、
+ * 没开的会话下次 resume 自动领走。它在宿主眼里就是一条普通 user 回合
+ * （**没有带外来源位**，见 docs/DECISIONS.md 2026-10-21），故手动面也走它。
+ * 不收图（CLI 硬拒 `--images`）——带图消息由投递层优先走终端。
+ */
+export declare const CODEX_QUEUED_PROMPT: QueuedPromptSpec;
+/**
+ * codex 的附件面：普通文件与图片都收。宿主没有文件附件形态——提示词里一条
+ * 绝对路径，模型自己读（读得到读不到由用户的 codex 沙箱/工具配置决定，weave
+ * 不替它判断）。图片同走路径：`view_image` 工具默认开启（features 表 Stable +
+ * default_enabled，0.164 实测本机 rollout 有真实调用），模型拿路径自己看图；
+ * 终端通道里用户粘贴图片路径时宿主也会当场转成图附件（`handle_paste_image_path`），
+ * 但那是「粘贴事件」才认，weave 投递的路径就是一段正文——两种形态模型都接得住。
+ * queue 通道硬拒 `--images`（CLI 形参），路径文本不受影响。
+ */
+export declare const CODEX_ATTACH: AttachSpec;
+/**
+ * Codex 消息能力面：**显式不支持面**（不支持通道 null + 原因，不是槽位缺席——
+ * 缺席无法渲染「为什么置灰」）。prompt 走宿主队列（`codex queue`，见上）+ 终端
+ * send-text 兜底；无原生 peer 消息（中继）。B0 调研（BACKLOG §10-6）落地后在
+ * 本文件逐通道点亮，编排层零改动。
  */
 export declare const CODEX_MESSAGING: MessagingSurface;