codex-python 0.2.10__tar.gz → 0.2.12__tar.gz

{codex_python-0.2.10 → codex_python-0.2.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-python
-Version: 0.2.10
+Version: 0.2.12
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.13
@@ -104,7 +104,7 @@ Common tasks
 - Generate protocol types from upstream: `make gen-protocol`
 
 Protocol types
-- `make gen-protocol` generates TS types (via Codex or cargo) into `.generated/ts` and then writes Pydantic models to `codex/protocol/types.py`.
+- `make gen-protocol` generates TS types and a JSON Schema, then writes Pydantic v2 models to `codex/protocol/types.py`. The process runs entirely from the native helper in this repo; no manual scripts needed.
 - Generated models use `model_config = ConfigDict(extra='allow')` and place it at the end of each class.
 
 Releasing

{codex_python-0.2.10 → codex_python-0.2.12}/README.md

@@ -85,7 +85,7 @@ Common tasks
 - Generate protocol types from upstream: `make gen-protocol`
 
 Protocol types
-- `make gen-protocol` generates TS types (via Codex or cargo) into `.generated/ts` and then writes Pydantic models to `codex/protocol/types.py`.
+- `make gen-protocol` generates TS types and a JSON Schema, then writes Pydantic v2 models to `codex/protocol/types.py`. The process runs entirely from the native helper in this repo; no manual scripts needed.
 - Generated models use `model_config = ConfigDict(extra='allow')` and place it at the end of each class.
 
 Releasing

{codex_python-0.2.10 → codex_python-0.2.12}/codex/__init__.py

@@ -31,4 +31,4 @@ __all__ = [
 ]
 
 # Package version. Kept in sync with Cargo.toml via CI before builds.
-__version__ = "0.2.10"
+__version__ = "0.2.12"

codex_python-0.2.12/codex/config.py

@@ -0,0 +1,242 @@
+from __future__ import annotations
+
+from enum import Enum
+from typing import Any, cast
+
+from pydantic import AliasChoices, BaseModel, ConfigDict, Field
+
+
+class ApprovalPolicy(str, Enum):
+    """Approval policy for executing shell commands.
+
+    Matches Rust enum `AskForApproval` (serde kebab-case):
+    - "untrusted": auto-approve safe read-only commands, ask otherwise
+    - "on-failure": sandbox by default; ask only if the sandboxed run fails
+    - "on-request": model decides (default)
+    - "never": never ask the user
+    """
+
+    UNTRUSTED = "untrusted"
+    ON_FAILURE = "on-failure"
+    ON_REQUEST = "on-request"
+    NEVER = "never"
+
+
+class SandboxMode(str, Enum):
+    """High-level sandbox mode override.
+
+    Matches Rust enum `SandboxMode` (serde kebab-case):
+    - "read-only"
+    - "workspace-write"
+    - "danger-full-access"
+    """
+
+    READ_ONLY = "read-only"
+    WORKSPACE_WRITE = "workspace-write"
+    DANGER_FULL_ACCESS = "danger-full-access"
+
+
+class HistoryPersistence(str, Enum):
+    SAVE_ALL = "save-all"
+    NONE = "none"
+
+
+class HistoryConfig(BaseModel):
+    persistence: HistoryPersistence | None = None
+    max_bytes: int | None = None
+
+    model_config = ConfigDict(extra="allow")
+
+
+class SandboxWorkspaceWrite(BaseModel):
+    writable_roots: list[str] | None = None
+    network_access: bool | None = None
+    exclude_tmpdir_env_var: bool | None = None
+    exclude_slash_tmp: bool | None = None
+
+    model_config = ConfigDict(extra="allow")
+
+
+class McpServerConfig(BaseModel):
+    command: str
+    args: list[str] | None = None
+    env: dict[str, str] | None = None
+    startup_timeout_ms: int | None = None
+
+    model_config = ConfigDict(extra="allow")
+
+
+class WireApi(str, Enum):
+    CHAT = "chat"
+    RESPONSES = "responses"
+
+
+class ModelProviderConfig(BaseModel):
+    name: str | None = None
+    base_url: str | None = None
+    env_key: str | None = None
+    wire_api: WireApi | None = None
+    query_params: dict[str, str] | None = None
+    http_headers: dict[str, str] | None = None
+    env_http_headers: dict[str, str] | None = None
+    request_max_retries: int | None = None
+    stream_max_retries: int | None = None
+    stream_idle_timeout_ms: int | None = None
+
+    model_config = ConfigDict(extra="allow")
+
+
+class FileOpener(str, Enum):
+    VSCODE = "vscode"
+    VSCODE_INSIDERS = "vscode-insiders"
+    WINDSURF = "windsurf"
+    CURSOR = "cursor"
+    NONE = "none"
+
+
+class ReasoningEffort(str, Enum):
+    MINIMAL = "minimal"
+    LOW = "low"
+    MEDIUM = "medium"
+    HIGH = "high"
+
+
+class ReasoningSummary(str, Enum):
+    AUTO = "auto"
+    CONCISE = "concise"
+    DETAILED = "detailed"
+    NONE = "none"
+
+
+class ReasoningSummaryFormat(str, Enum):
+    NONE = "none"
+    EXPERIMENTAL = "experimental"
+
+
+class Verbosity(str, Enum):
+    LOW = "low"
+    MEDIUM = "medium"
+    HIGH = "high"
+
+
+class ToolsConfig(BaseModel):
+    # Accept either "web_search" or legacy alias "web_search_request" on input
+    web_search: bool | None = Field(
+        default=None, validation_alias=AliasChoices("web_search", "web_search_request")
+    )
+    # Also expose view_image knob (defaults handled in Rust)
+    view_image: bool | None = None
+
+    model_config = ConfigDict(extra="allow")
+
+
+class ProfileConfig(BaseModel):
+    model: str | None = None
+    model_provider: str | None = None
+    approval_policy: ApprovalPolicy | None = None
+    model_reasoning_effort: ReasoningEffort | None = None
+    model_reasoning_summary: ReasoningSummary | None = None
+    model_verbosity: Verbosity | None = None
+    chatgpt_base_url: str | None = None
+    experimental_instructions_file: str | None = None
+
+    model_config = ConfigDict(extra="allow")
+
+
+class ProjectConfig(BaseModel):
+    trust_level: str | None = Field(
+        default=None, description='Only "trusted" is recognized by the core.'
+    )
+
+    model_config = ConfigDict(extra="allow")
+
+
+class PreferredAuthMethod(str, Enum):
+    CHATGPT = "chatgpt"
+    APIKEY = "apikey"
+
+
+class CodexConfig(BaseModel):
+    """Configuration overrides for Codex.
+
+    This mirrors `codex_core::config::ConfigOverrides` and is intentionally
+    conservative: only values present (not None) are passed to the native core.
+    """
+
+    # Model selection
+    model: str | None = Field(default=None, description="Model slug, e.g. 'gpt-5' or 'o3'.")
+    model_provider: str | None = Field(
+        default=None, description="Provider key from config, e.g. 'openai'."
+    )
+
+    # Safety/Execution
+    approval_policy: ApprovalPolicy | None = Field(default=None)
+    sandbox_mode: SandboxMode | None = Field(default=None)
+    sandbox_workspace_write: SandboxWorkspaceWrite | None = None
+
+    # Environment
+    cwd: str | None = Field(default=None, description="Working directory for the session.")
+    config_profile: str | None = Field(
+        default=None, description="Config profile key to use (from profiles.*)."
+    )
+    codex_linux_sandbox_exe: str | None = Field(
+        default=None, description="Absolute path to codex-linux-sandbox (Linux only)."
+    )
+
+    # UX / features
+    base_instructions: str | None = Field(default=None, description="Override base instructions.")
+    include_plan_tool: bool | None = Field(default=None)
+    include_apply_patch_tool: bool | None = Field(default=None)
+    include_view_image_tool: bool | None = Field(default=None)
+    show_raw_agent_reasoning: bool | None = Field(default=None)
+
+    # Model/runtime tuning
+    model_context_window: int | None = None
+    model_max_output_tokens: int | None = None
+    model_reasoning_effort: ReasoningEffort | None = None
+    model_reasoning_summary: ReasoningSummary | None = None
+    model_verbosity: Verbosity | None = None
+    model_supports_reasoning_summaries: bool | None = None
+    model_reasoning_summary_format: ReasoningSummaryFormat | None = None
+
+    # Auth/UI options
+    hide_agent_reasoning: bool | None = None
+    chatgpt_base_url: str | None = None
+    preferred_auth_method: PreferredAuthMethod | None = None
+    file_opener: FileOpener | None = None
+
+    # Config file composed sections
+    history: HistoryConfig | None = None
+    tui: dict[str, Any] | None = None
+    notify: list[str] | None = None
+    instructions: str | None = Field(
+        default=None,
+        description="Ignored by core; prefer AGENTS.md or experimental_instructions_file.",
+    )
+    mcp_servers: dict[str, McpServerConfig] | None = None
+    model_providers: dict[str, ModelProviderConfig] | None = None
+    project_doc_max_bytes: int | None = None
+    profile: str | None = None
+    profiles: dict[str, ProfileConfig] | None = None
+    tools: ToolsConfig | None = None
+    projects: dict[str, ProjectConfig] | None = None
+
+    # Experimental / internal
+    experimental_resume: str | None = None
+    experimental_instructions_file: str | None = None
+    experimental_use_exec_command_tool: bool | None = None
+    responses_originator_header_internal_override: str | None = None
+    disable_response_storage: bool | None = Field(
+        default=None, description="Accepted in some clients; ignored by core."
+    )
+
+    def to_dict(self) -> dict[str, Any]:
+        """Return overrides as a plain dict with None values removed.
+
+        Enum fields are emitted as their string values.
+        """
+        return cast(dict[str, Any], self.model_dump(exclude_none=True))
+
+    # Pydantic v2 config. `use_enum_values=True` ensures enums dump as strings.
+    # Place at end of class, extra='allow' per style.
+    model_config = ConfigDict(extra="allow", validate_assignment=True, use_enum_values=True)

codex_python-0.2.12/codex/protocol/_base_model.py

@@ -0,0 +1,8 @@
+from __future__ import annotations
+
+from pydantic import BaseModel
+from pydantic.config import ConfigDict
+
+
+class BaseModelWithExtras(BaseModel):
+    model_config = ConfigDict(extra="allow")