codex-sdk-python 0.81.0__py3-none-any.whl

codex_sdk/__init__.py

@@ -0,0 +1,140 @@
+"""
+Codex SDK for Python
+
+Embed the Codex agent in your Python workflows and applications.
+"""
+
+from .abort import AbortController, AbortSignal
+from .app_server import (
+    ApprovalDecisions,
+    AppServerClient,
+    AppServerClientInfo,
+    AppServerInput,
+    AppServerNotification,
+    AppServerOptions,
+    AppServerRequest,
+    AppServerTurnSession,
+    AppServerUserInput,
+)
+from .codex import Codex
+from .events import (
+    ItemCompletedEvent,
+    ItemStartedEvent,
+    ItemUpdatedEvent,
+    ThreadError,
+    ThreadErrorEvent,
+    ThreadEvent,
+    ThreadStartedEvent,
+    TurnCompletedEvent,
+    TurnFailedEvent,
+    TurnStartedEvent,
+    Usage,
+)
+from .exceptions import (
+    CodexAbortError,
+    CodexAppServerError,
+    CodexCLIError,
+    CodexError,
+    CodexParseError,
+    TurnFailedError,
+)
+from .hooks import ThreadHooks
+from .items import (
+    AgentMessageItem,
+    CommandExecutionItem,
+    CommandExecutionStatus,
+    ErrorItem,
+    FileChangeItem,
+    McpToolCallItem,
+    McpToolCallItemError,
+    McpToolCallItemResult,
+    McpToolCallStatus,
+    PatchApplyStatus,
+    PatchChangeKind,
+    ReasoningItem,
+    ThreadItem,
+    TodoItem,
+    TodoListItem,
+    WebSearchItem,
+)
+from .options import (
+    ApprovalMode,
+    CodexOptions,
+    ModelReasoningEffort,
+    SandboxMode,
+    ThreadOptions,
+    TurnOptions,
+)
+from .thread import (
+    Input,
+    LocalImageInput,
+    RunResult,
+    RunStreamedResult,
+    TextInput,
+    Thread,
+    Turn,
+)
+
+__version__ = "0.81.0"
+
+__all__ = [
+    "AbortController",
+    "AbortSignal",
+    "Codex",
+    "AppServerClient",
+    "AppServerClientInfo",
+    "AppServerNotification",
+    "AppServerRequest",
+    "AppServerOptions",
+    "AppServerTurnSession",
+    "ApprovalDecisions",
+    "AppServerInput",
+    "AppServerUserInput",
+    "Thread",
+    "ThreadHooks",
+    "Input",
+    "TextInput",
+    "LocalImageInput",
+    "RunResult",
+    "RunStreamedResult",
+    "Turn",
+    "ThreadEvent",
+    "ThreadStartedEvent",
+    "TurnStartedEvent",
+    "TurnCompletedEvent",
+    "TurnFailedEvent",
+    "ItemStartedEvent",
+    "ItemUpdatedEvent",
+    "ItemCompletedEvent",
+    "ThreadError",
+    "ThreadErrorEvent",
+    "Usage",
+    "ThreadItem",
+    "AgentMessageItem",
+    "ReasoningItem",
+    "CommandExecutionItem",
+    "FileChangeItem",
+    "McpToolCallItem",
+    "McpToolCallItemResult",
+    "McpToolCallItemError",
+    "WebSearchItem",
+    "TodoListItem",
+    "ErrorItem",
+    "CommandExecutionStatus",
+    "PatchChangeKind",
+    "PatchApplyStatus",
+    "McpToolCallStatus",
+    "TodoItem",
+    "CodexOptions",
+    "ThreadOptions",
+    "TurnOptions",
+    "ApprovalMode",
+    "SandboxMode",
+    "ModelReasoningEffort",
+    "CodexError",
+    "CodexAbortError",
+    "CodexAppServerError",
+    "CodexCLIError",
+    "CodexParseError",
+    "TurnFailedError",
+]

codex_sdk/abort.py

@@ -0,0 +1,40 @@
+"""AbortController and AbortSignal helpers for cancelling Codex runs."""
+
+from __future__ import annotations
+
+import asyncio
+from dataclasses import dataclass
+from typing import Optional, Union
+
+AbortReason = Union[str, BaseException]
+
+
+@dataclass
+class AbortSignal:
+    """Signal object used to abort a running operation."""
+
+    _event: asyncio.Event
+    _reason: Optional[AbortReason] = None
+
+    @property
+    def aborted(self) -> bool:
+        return self._event.is_set()
+
+    @property
+    def reason(self) -> Optional[AbortReason]:
+        return self._reason
+
+    async def wait(self) -> None:
+        await self._event.wait()
+
+
+class AbortController:
+    """Controller used to trigger cancellation for an AbortSignal."""
+
+    def __init__(self) -> None:
+        self._event = asyncio.Event()
+        self.signal = AbortSignal(self._event)
+
+    def abort(self, reason: Optional[AbortReason] = None) -> None:
+        self.signal._reason = reason
+        self._event.set()