codex-sdk-python 0.101.0__tar.gz → 0.104.0__tar.gz

{codex_sdk_python-0.101.0 → codex_sdk_python-0.104.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: codex-sdk-python
-Version: 0.101.0
+Version: 0.104.0
 Summary: Python SDK for the Codex CLI agent with async threads, streaming events, and structured outputs
 Keywords: codex,sdk,python,api,cli,agent,async,streaming
 Author: Vectorfy Co
@@ -44,7 +44,7 @@ Embed the Codex agent in Python workflows. This SDK wraps the bundled `codex` CL
       <td><strong>Lifecycle</strong></td>
       <td>
         <a href="#ci-cd"><img src="https://img.shields.io/badge/CI%2FCD-Active-16a34a?style=flat&logo=githubactions&logoColor=white" alt="CI/CD badge" /></a>
-        <img src="https://img.shields.io/badge/Release-0.101.0-6b7280?style=flat&logo=pypi&logoColor=white" alt="Release 0.101.0 badge" />
+        <img src="https://img.shields.io/badge/Release-0.104.0-6b7280?style=flat&logo=pypi&logoColor=white" alt="Release 0.104.0 badge" />
         <a href="#license"><img src="https://img.shields.io/badge/License-Apache--2.0-0f766e?style=flat&logo=apache&logoColor=white" alt="License badge" /></a>
       </td>
     </tr>
@@ -366,8 +366,21 @@ for payload shapes and event semantics.
 Note: some endpoints and fields are gated behind an experimental capability; set
 `AppServerOptions(experimental_api_enabled=True)` to opt in.
 
-`thread_list` supports `archived`, `sort_key`, and `source_kinds` filters, and `config_read` accepts an optional `cwd`
-to compute the effective layered config for a specific working directory.
+`thread_list` supports `archived`, `sort_key`, and `source_kinds` filters (unchanged), and now also accepts `cwd`
+for scoped thread queries. `config_read` accepts an optional `cwd` to compute effective layered config for a specific
+working directory.
+
+`skills_remote_read` supports `cwds`, `enabled`, `hazelnut_scope`, and `product_surface` filters. `model_list` accepts
+an optional `include_hidden` flag.
+
+```python
+threads = await app.thread_list(archived=False, sort_key="updatedAt", source_kinds=["local"], cwd=".")
+config = await app.config_read(include_layers=True, cwd=".")
+skills = await app.skills_remote_read(
+    cwds=["."], enabled=True, hazelnut_scope="user", product_surface="codex_desktop"
+)
+models = await app.model_list(limit=20, include_hidden=False)
+```
 
 ### Observability (OTEL) and notify
 

{codex_sdk_python-0.101.0 → codex_sdk_python-0.104.0}/README.md

@@ -8,7 +8,7 @@ Embed the Codex agent in Python workflows. This SDK wraps the bundled `codex` CL
       <td><strong>Lifecycle</strong></td>
       <td>
         <a href="#ci-cd"><img src="https://img.shields.io/badge/CI%2FCD-Active-16a34a?style=flat&logo=githubactions&logoColor=white" alt="CI/CD badge" /></a>
-        <img src="https://img.shields.io/badge/Release-0.101.0-6b7280?style=flat&logo=pypi&logoColor=white" alt="Release 0.101.0 badge" />
+        <img src="https://img.shields.io/badge/Release-0.104.0-6b7280?style=flat&logo=pypi&logoColor=white" alt="Release 0.104.0 badge" />
         <a href="#license"><img src="https://img.shields.io/badge/License-Apache--2.0-0f766e?style=flat&logo=apache&logoColor=white" alt="License badge" /></a>
       </td>
     </tr>
@@ -330,8 +330,21 @@ for payload shapes and event semantics.
 Note: some endpoints and fields are gated behind an experimental capability; set
 `AppServerOptions(experimental_api_enabled=True)` to opt in.
 
-`thread_list` supports `archived`, `sort_key`, and `source_kinds` filters, and `config_read` accepts an optional `cwd`
-to compute the effective layered config for a specific working directory.
+`thread_list` supports `archived`, `sort_key`, and `source_kinds` filters (unchanged), and now also accepts `cwd`
+for scoped thread queries. `config_read` accepts an optional `cwd` to compute effective layered config for a specific
+working directory.
+
+`skills_remote_read` supports `cwds`, `enabled`, `hazelnut_scope`, and `product_surface` filters. `model_list` accepts
+an optional `include_hidden` flag.
+
+```python
+threads = await app.thread_list(archived=False, sort_key="updatedAt", source_kinds=["local"], cwd=".")
+config = await app.config_read(include_layers=True, cwd=".")
+skills = await app.skills_remote_read(
+    cwds=["."], enabled=True, hazelnut_scope="user", product_surface="codex_desktop"
+)
+models = await app.model_list(limit=20, include_hidden=False)
+```
 
 ### Observability (OTEL) and notify
 

{codex_sdk_python-0.101.0 → codex_sdk_python-0.104.0}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["uv_build>=0.9.21,<0.10.0"]
+requires = ["uv_build>=0.9.21,<0.11.0"]
 build-backend = "uv_build"
 
 [project]
 name = "codex-sdk-python"
-version = "0.101.0"
+version = "0.104.0"
 description = "Python SDK for the Codex CLI agent with async threads, streaming events, and structured outputs"
 readme = "README.md"
 license = {text = "Apache-2.0"}

{codex_sdk_python-0.101.0 → codex_sdk_python-0.104.0}/src/codex_sdk/__init__.py

@@ -15,6 +15,8 @@ from .app_server import (
     AppServerRequest,
     AppServerTurnSession,
     AppServerUserInput,
+    SkillsRemoteReadRequest,
+    SkillsRemoteWriteRequest,
 )
 from .codex import Codex
 from .events import (
@@ -77,7 +79,7 @@ from .thread import (
     Turn,
 )
 
-__version__ = "0.101.0"
+__version__ = "0.104.0"
 
 __all__ = [
     "AbortController",
@@ -92,6 +94,8 @@ __all__ = [
     "ApprovalDecisions",
     "AppServerInput",
     "AppServerUserInput",
+    "SkillsRemoteReadRequest",
+    "SkillsRemoteWriteRequest",
     "Thread",
     "ThreadHooks",
     "Input",

{codex_sdk_python-0.101.0 → codex_sdk_python-0.104.0}/src/codex_sdk/app_server.py

@@ -558,6 +558,7 @@ class AppServerClient:
         model_providers: Optional[Sequence[str]] = None,
         source_kinds: Optional[Sequence[str]] = None,
         archived: Optional[bool] = None,
+        cwd: Optional[Union[str, Path]] = None,
     ) -> Dict[str, Any]:
         """
         Retrieve a page of threads from the app-server with optional filtering and sorting.
@@ -570,6 +571,7 @@ class AppServerClient:
             source_kinds: Filter threads by one or more source kinds.
             archived: If set, restrict results to archived (`True`) or unarchived (`False`)
                 threads.
+            cwd: Optional working directory scope for server-side filtering.
 
         Returns:
             The raw response dictionary returned by the app-server for the `thread/list`
@@ -588,6 +590,8 @@ class AppServerClient:
             params["source_kinds"] = list(source_kinds)
         if archived is not None:
             params["archived"] = archived
+        if cwd is not None:
+            params["cwd"] = str(cwd)
         return await self._request_dict("thread/list", _coerce_keys(params) or None)
 
     async def thread_read(
@@ -769,26 +773,54 @@ class AppServerClient:
         return await self._request_dict("skills/list", _coerce_keys(payload))
 
     async def skills_remote_read(
-        self, *, params: Optional[Mapping[str, Any]] = None
+        self,
+        *,
+        cwds: Optional[Sequence[Union[str, Path]]] = None,
+        enabled: Optional[bool] = None,
+        hazelnut_scope: Optional[str] = None,
+        product_surface: Optional[str] = None,
+        params: Optional["SkillsRemoteReadRequest"] = None,
     ) -> Dict[str, Any]:
         """
         Read remote skills metadata from the app server.
 
         Args:
-            params: Optional request payload.
+            cwds: Optional workspace roots to scope the remote skill listing.
+            enabled: Optional filter for enabled/disabled remote skills.
+            hazelnut_scope: Optional Hazelnut scope identifier.
+            product_surface: Optional product surface identifier.
+            params: Optional raw request payload for protocol-forward fields.
 
         Returns:
             result (Dict[str, Any]): The app-server response payload for the `skills/remote/read` request.
         """
-        payload = _coerce_keys(dict(params)) if params is not None else {}
-        return await self._request_dict("skills/remote/read", payload)
+        payload: Dict[str, Any] = {}
+        if params is not None:
+            _validate_alias_conflicts(
+                params,
+                (
+                    ("hazelnut_scope", "hazelnutScope"),
+                    ("product_surface", "productSurface"),
+                ),
+                context="SkillsRemoteReadRequest",
+            )
+            payload.update(dict(params))
+        if cwds is not None:
+            payload["cwds"] = [str(path) for path in cwds]
+        if enabled is not None:
+            payload["enabled"] = enabled
+        if hazelnut_scope is not None:
+            payload["hazelnut_scope"] = hazelnut_scope
+        if product_surface is not None:
+            payload["product_surface"] = product_surface
+        return await self._request_dict("skills/remote/read", _coerce_keys(payload))
 
     async def skills_remote_write(
         self,
         *,
         hazelnut_id: Optional[str] = None,
         is_preload: Optional[bool] = None,
-        params: Optional[Mapping[str, Any]] = None,
+        params: Optional["SkillsRemoteWriteRequest"] = None,
     ) -> Dict[str, Any]:
         """
         Start a remote skill write operation.
@@ -803,12 +835,20 @@ class AppServerClient:
         """
         payload: Dict[str, Any] = {}
         if params is not None:
-            payload.update(_coerce_keys(dict(params)))
+            _validate_alias_conflicts(
+                params,
+                (
+                    ("hazelnut_id", "hazelnutId"),
+                    ("is_preload", "isPreload"),
+                ),
+                context="SkillsRemoteWriteRequest",
+            )
+            payload.update(dict(params))
         if hazelnut_id is not None:
             payload["hazelnut_id"] = hazelnut_id
         if is_preload is not None:
             payload["is_preload"] = is_preload
-        return await self._request_dict("skills/remote/write", payload)
+        return await self._request_dict("skills/remote/write", _coerce_keys(payload))
 
     async def skills_config_write(
         self,
@@ -924,7 +964,11 @@ class AppServerClient:
         return await self._request_dict("turn/steer", _coerce_keys(payload))
 
     async def model_list(
-        self, *, cursor: Optional[str] = None, limit: Optional[int] = None
+        self,
+        *,
+        cursor: Optional[str] = None,
+        limit: Optional[int] = None,
+        include_hidden: Optional[bool] = None,
     ) -> Dict[str, Any]:
         """List models available to the app-server."""
         params: Dict[str, Any] = {}
@@ -932,7 +976,9 @@ class AppServerClient:
             params["cursor"] = cursor
         if limit is not None:
             params["limit"] = limit
-        return await self._request_dict("model/list", params or None)
+        if include_hidden is not None:
+            params["include_hidden"] = include_hidden
+        return await self._request_dict("model/list", _coerce_keys(params) or None)
 
     async def app_list(
         self, *, cursor: Optional[str] = None, limit: Optional[int] = None
@@ -1309,6 +1355,26 @@ class SkillsConfigWriteRequest(TypedDict, total=False):
     mode: str
 
 
+class SkillsRemoteReadRequest(TypedDict, total=False):
+    """Typed payload for `skills/remote/read` requests."""
+
+    cwds: List[str]
+    enabled: bool
+    hazelnut_scope: str
+    hazelnutScope: str
+    product_surface: str
+    productSurface: str
+
+
+class SkillsRemoteWriteRequest(TypedDict, total=False):
+    """Typed payload for `skills/remote/write` requests."""
+
+    hazelnut_id: str
+    hazelnutId: str
+    is_preload: bool
+    isPreload: bool
+
+
 class ItemToolCallRequest(TypedDict, total=False):
     """Typed payload for `item/tool/call` requests."""
 
@@ -1392,6 +1458,21 @@ def _coerce_keys(params: Mapping[str, Any]) -> Dict[str, Any]:
     return coerced
 
 
+def _validate_alias_conflicts(
+    params: Mapping[str, Any],
+    alias_pairs: Sequence[tuple[str, str]],
+    *,
+    context: str,
+) -> None:
+    """Reject payloads that provide both snake_case and camelCase aliases."""
+    for snake_case_key, camel_case_key in alias_pairs:
+        if snake_case_key in params and camel_case_key in params:
+            raise CodexError(
+                f"{context} received both '{snake_case_key}' and "
+                f"'{camel_case_key}'. Provide only one key variant."
+            )
+
+
 def _snake_to_camel(value: str) -> str:
     """Convert snake_case strings to lowerCamelCase."""
     parts = value.split("_")