python-codex 0.4.5__tar.gz → 0.4.7__tar.gz

{python_codex-0.4.5 → python_codex-0.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-codex
-Version: 0.4.5
+Version: 0.4.7
 Summary: A minimal Python extraction of Codex's main agent loop
 License-File: LICENSE
 Requires-Python: >=3.6.2
@@ -369,22 +369,28 @@ Current behavior:
   Open views survive reloads and server restarts. See
   [workspace content views](docs/RUNTIME.md#workspace-content-views) for the
   complete syntax and limits.
-- interactive mode exits through `/exit`, `/quit`, Ctrl+D on an empty prompt,
-  or a single Ctrl+C; accepted work finishes before cleanup and normal exit.
+- interactive mode exits through Ctrl+D on an empty prompt or a single Ctrl+C;
+  accepted work finishes before cleanup and normal exit.
   A `[closing]` message explains the wait. Press Ctrl+C again while closing
   to immediately exit the CLI with status 130. This skips remaining cleanup;
   external tool processes may keep running.
 - interactive mode shows a compact event stream for user-visible phases such as
   tool execution and model follow-up after tool results
+- startup shows a welcome, model, effort, endpoint and available commands.
 - assistant text is printed from streaming deltas directly
-- interactive mode supports `/history`, `/title`, `/model`, `/resume`, `/compact`,
-  and `/fork`
+- interactive mode supports `/history`, `/title`, `/model`, `/effort`, `/resume`,
+  `/compact`, and `/fork`
 - `/model <name>` switches the model used by later turns in the current
   interactive session; `/model` shows the current model and available choices
+- `/effort low` switches effort while idle; `/effort` shows the current value,
+  and `/effort default` restores the model default. Frontend labels show
+  `model:effort`.
 - `/resume` with no argument lists the currently resumable sessions by their
   first user-message preview; `/resume 1` resumes the first listed session
-- `/resume <number>` replaces the in-memory history with the selected recorded
-  Codex rollout from `CODEX_HOME/sessions`. Tool calls without recorded results
+- `/resume <session_id>` accepts a full session UUID, including sessions older
+  than the displayed list. Both forms search `CODEX_HOME/sessions` and
+  `CODEX_HOME/archived_sessions` and replace the in-memory history with the
+  selected recorded Codex rollout. Tool calls without recorded results
   are omitted during restore; later saved messages and completed tools remain
   available, and the source file is left intact.
 - `/compact` synthesizes a local handoff summary, replaces the in-memory

{python_codex-0.4.5 → python_codex-0.4.7}/README.md

@@ -349,22 +349,28 @@ Current behavior:
   Open views survive reloads and server restarts. See
   [workspace content views](docs/RUNTIME.md#workspace-content-views) for the
   complete syntax and limits.
-- interactive mode exits through `/exit`, `/quit`, Ctrl+D on an empty prompt,
-  or a single Ctrl+C; accepted work finishes before cleanup and normal exit.
+- interactive mode exits through Ctrl+D on an empty prompt or a single Ctrl+C;
+  accepted work finishes before cleanup and normal exit.
   A `[closing]` message explains the wait. Press Ctrl+C again while closing
   to immediately exit the CLI with status 130. This skips remaining cleanup;
   external tool processes may keep running.
 - interactive mode shows a compact event stream for user-visible phases such as
   tool execution and model follow-up after tool results
+- startup shows a welcome, model, effort, endpoint and available commands.
 - assistant text is printed from streaming deltas directly
-- interactive mode supports `/history`, `/title`, `/model`, `/resume`, `/compact`,
-  and `/fork`
+- interactive mode supports `/history`, `/title`, `/model`, `/effort`, `/resume`,
+  `/compact`, and `/fork`
 - `/model <name>` switches the model used by later turns in the current
   interactive session; `/model` shows the current model and available choices
+- `/effort low` switches effort while idle; `/effort` shows the current value,
+  and `/effort default` restores the model default. Frontend labels show
+  `model:effort`.
 - `/resume` with no argument lists the currently resumable sessions by their
   first user-message preview; `/resume 1` resumes the first listed session
-- `/resume <number>` replaces the in-memory history with the selected recorded
-  Codex rollout from `CODEX_HOME/sessions`. Tool calls without recorded results
+- `/resume <session_id>` accepts a full session UUID, including sessions older
+  than the displayed list. Both forms search `CODEX_HOME/sessions` and
+  `CODEX_HOME/archived_sessions` and replace the in-memory history with the
+  selected recorded Codex rollout. Tool calls without recorded results
   are omitted during restore; later saved messages and completed tools remain
   available, and the source file is left intact.
 - `/compact` synthesizes a local handoff summary, replaces the in-memory

{python_codex-0.4.5 → python_codex-0.4.7}/README_ZH.md

@@ -304,15 +304,19 @@ pycodex doctor
 
 - 没有 argv prompt 且 stdin 是 TTY 时，进入交互模式
 - 有 argv prompt 或 stdin 管道输入时，执行单轮请求
-- 交互模式通过 `/exit`、`/quit`、空提示符上的 Ctrl+D 或一次 Ctrl+C 正常退出；
+- 交互模式通过空提示符上的 Ctrl+D 或一次 Ctrl+C 正常退出；
   `[closing]` 提示表示正在等待已接收的工作结束并清理资源，不取消模型或工具调用。
 - 交互模式下会显示简洁阶段事件流，例如工具执行状态和模型回看工具结果
+- 开场保留欢迎语，显示 model、effort、endpoint 和命令列表。
 - assistant 文本会按流式 delta 直接打印
-- 交互模式下支持 `/history`、`/title`、`/model` 和 `/resume`
+- 交互模式下支持 `/history`、`/title`、`/model`、`/effort` 和 `/resume`
 - `/model <name>` 会切换当前交互会话后续请求使用的模型；`/model` 会显示当前模型和可选模型
+- `/effort low` 在空闲时切换 effort，`/effort` 查看当前值，`/effort default` 恢复模型默认值；前端模型标签显示 `model:effort`。
 - `/resume` 不带参数时会按首条用户消息预览列出当前可恢复的 session；`/resume 1`
   会恢复列表里的第 1 个 session
-- `/resume <数字>` 会从 `CODEX_HOME/sessions` 读取选中的已记录 Codex rollout，
+- `/resume <session_id>` 支持完整的会话 UUID，不受当前列表条数限制。
+  编号和 UUID 两种方式都会查找 `CODEX_HOME/sessions` 与
+  `CODEX_HOME/archived_sessions`，读取选中的已记录 Codex rollout，
   并直接替换当前内存里的会话 history
 - 新 session 现在会自动保存到 `CODEX_HOME/sessions/.../rollout-*.jsonl`，
   使用稳定的 session/thread id，并按 item 级别 append + flush，和 `/resume`

{python_codex-0.4.5 → python_codex-0.4.7}/pycodex/cli.py

@@ -19,7 +19,7 @@ from prompt_toolkit.patch_stdout import patch_stdout
 
 from .bootstrap import build_agent, build_model, build_runtime, configure_loguru
 from .events import DEFAULT_MAIN_PROMPT, EventDisplay
-from .model import DEFAULT_CODEX_CONFIG_PATH
+from .model import DEFAULT_CODEX_CONFIG_PATH, ModelControl
 from .portable import bootstrap_called_home, upload_codex_home
 from .utils import get_debug_dir
 from .utils.event_helpers import format_error, render_result
@@ -216,7 +216,10 @@ async def run_interactive_session(runtime, json_mode, config_path=None, view=Non
         if not future.cancelled() and future.exception() is None:
             render_result("turn", future.result(), True, view.write_line)
 
-    view.display.start(runtime.commands())
+    client = typing.cast(ModelControl, runtime.agent.model_client)
+    view.display.start(
+        client.model, client.reasoning_effort, client.endpoint, runtime.commands()
+    )
     with _cli_sigint_handler(runtime) as install_sigint_handler:
         try:
             while not view.display.closed:

{python_codex-0.4.5 → python_codex-0.4.7}/pycodex/events.py

@@ -48,11 +48,14 @@ class EventDisplay:
         self.closed = False
         self.set_context_window_tokens(context_window_tokens)
 
-    def start(self, commands):
+    def start(self, model, reasoning_effort, endpoint, commands):
+        self.log("Welcome to PyCodex")
         self.log(
-            "pycodex interactive mode. Type /exit or press Ctrl+C to quit; "
-            "press Ctrl+C again while closing to force exit."
+            "model: {0} | effort: {1}".format(
+                model, reasoning_effort or "provider default"
+            )
         )
+        self.log("endpoint: " + endpoint)
         self.log(format_command_result({"kind": "help", "commands": commands}))
 
     def write(self, text, kind=""):

{python_codex-0.4.5 → python_codex-0.4.7}/pycodex/model.py

@@ -67,6 +67,11 @@ class ModelClient(Protocol):
 
 class ModelControl(Protocol):
     model: "str"
+    reasoning_effort: "typing.Union[str, None]"
+
+    @property
+    def endpoint(self) -> "str":
+        """Return the active API base URL, safe for display."""
 
     async def list_models(self) -> "typing.List[str]":
         """List the models available to an interactive session."""
@@ -398,6 +403,27 @@ class ResponsesModelClient:
     def model(self, model: "str") -> "None":
         self._config = replace(self._config, model=model)
 
+    @property
+    def reasoning_effort(self) -> "typing.Union[str, None]":
+        """Return the effective effort; assign None to restore the model default."""
+        return self._config.effective_reasoning_effort()
+
+    @reasoning_effort.setter
+    def reasoning_effort(self, effort: "typing.Union[str, None]") -> "None":
+        if effort is not None and (
+            not effort or any(char.isspace() for char in effort)
+        ):
+            raise ValueError("reasoning effort must be a single non-empty value")
+        self._config = replace(self._config, reasoning_effort=effort)
+
+    @property
+    def endpoint(self) -> "str":
+        """Return the active API base URL without credentials, query or fragment."""
+        url = urllib.parse.urlsplit(self._config.base_url)
+        return urllib.parse.urlunsplit(
+            (url.scheme, url.netloc.rsplit("@", 1)[-1], url.path, "", "")
+        )
+
     @classmethod
     def from_codex_config(
         cls,

{python_codex-0.4.5 → python_codex-0.4.7}/pycodex/runtime.py

@@ -25,6 +25,7 @@ from .events import (
     TurnInterruptedEvent,
     TurnStartedEvent,
 )
+from .model import ModelControl
 from .protocol import TurnResult
 from .utils import uuid7_string
 from .utils.event_helpers import shorten_title
@@ -124,12 +125,13 @@ class AgentRuntime:
                 "history",
                 "title",
                 "model",
+                "effort",
                 "resume",
                 "compact",
                 "fork",
             )
             + tuple(self.command_handlers)
-            + ("queue", "exit", "quit")
+            + ("queue",)
         )
 
     def snapshot(self):
@@ -141,7 +143,10 @@ class AgentRuntime:
             "recorded_rollout_path": (
                 str(recorded_path) if recorded_path is not None else None
             ),
-            "model": self.agent.model_name,
+            "model": "{0}:{1}".format(
+                self.agent.model_name,
+                getattr(self.agent.model_client, "reasoning_effort", None) or "default",
+            ),
             "title": self.title,
             "history": conversation_history_to_turns(self.agent.history),
             "busy": self.is_busy,
@@ -250,13 +255,10 @@ class AgentRuntime:
         submission_id = uuid7_string()
         future = asyncio.get_running_loop().create_future()
         try:
-            if command in {"/exit", "/quit"}:
+            async with self._get_command_lock():
+                if not self.agent.accepts_input:
+                    raise RuntimeError("agent is shutting down")
                 result = await self._execute_command(command[1:], argument.strip())
-            else:
-                async with self._get_command_lock():
-                    if not self.agent.accepts_input:
-                        raise RuntimeError("agent is shutting down")
-                    result = await self._execute_command(command[1:], argument.strip())
         except Exception as exc:
             future.set_exception(exc)
             self._publish(CommandFailedEvent(submission_id, command, str(exc), sender))
@@ -267,10 +269,7 @@ class AgentRuntime:
         return SubmittedInput(submission_id, "command", future)
 
     async def _execute_command(self, command, argument):
-        if (
-            command in {"help", "history", "compact", "fork", "exit", "quit"}
-            and argument
-        ):
+        if command in {"help", "history", "compact", "fork"} and argument:
             raise ValueError("Usage: /{0}".format(command))
         if command == "help":
             return {"kind": "help", "commands": self.commands()}
@@ -292,6 +291,17 @@ class AgentRuntime:
                 "model": self.agent.model_name,
                 "models": await self.agent.model_client.list_models(),
             }
+        if command == "effort":
+            client = typing.cast(ModelControl, self.agent.model_client)
+            effort = client.reasoning_effort
+            if argument:
+                if len(argument.split()) != 1:
+                    raise ValueError("Usage: /effort [<value>|default]")
+                self.require_idle("change reasoning effort")
+                client.reasoning_effort = None if argument == "default" else argument
+                effort = client.reasoning_effort
+                self.publish_state("effort")
+            return {"kind": "effort", "reasoning_effort": effort}
         if command == "resume":
             if not argument:
                 return {
@@ -317,9 +327,6 @@ class AgentRuntime:
         if command == "fork":
             self.fork()
             return {"kind": "forked", "session_id": self.agent.session_id}
-        if command in {"exit", "quit"}:
-            await self.close()
-            return {"kind": "closed"}
         handler = self.command_handlers.get(command)
         if handler is None:
             raise ValueError("Unknown command: /{0}".format(command))

{python_codex-0.4.5 → python_codex-0.4.7}/pycodex/utils/event_helpers.py

@@ -35,6 +35,10 @@ def format_command_result(result: "typing.Dict[str, object]") -> "str":
         )
     if kind == "model_changed":
         return "Switched model to {0}.".format(result["model"])
+    if kind == "effort":
+        return "Reasoning effort: {0}".format(
+            result["reasoning_effort"] or "provider default"
+        )
     if kind == "sessions":
         if not result["sessions"]:
             return "No resumable sessions found."
@@ -67,8 +71,6 @@ def format_command_result(result: "typing.Dict[str, object]") -> "str":
         )
     if kind == "forked":
         return "Forked session: " + result["session_id"]
-    if kind == "closed":
-        return ""
     return "\n".join(result["lines"])
 
 

{python_codex-0.4.5 → python_codex-0.4.7}/pycodex/utils/session_persist.py

@@ -163,6 +163,7 @@ class SessionRolloutRecorder:
 def list_resumable_sessions(
     codex_home: "Path",
     limit: "int" = 20,
+    session_id: "typing.Union[str, None]" = None,
 ) -> "typing.Tuple[typing.Dict[str, str], ...]":
     latest_rollouts_by_id: "typing.Dict[str, Path]" = {}
     for dirname in ROLLUP_SESSION_DIRNAMES:
@@ -173,6 +174,8 @@ def list_resumable_sessions(
             thread_id = _thread_id_from_rollout_path(path)
             if thread_id is None:
                 continue
+            if session_id is not None and thread_id.lower() != session_id.lower():
+                continue
             previous = latest_rollouts_by_id.get(thread_id)
             if previous is None or path.stat().st_mtime > previous.stat().st_mtime:
                 latest_rollouts_by_id[thread_id] = path
@@ -202,11 +205,16 @@ def list_resumable_sessions(
 
 def select_resumable_session(
     codex_home: "Path",
-    resume_index_text: "str",
+    resume_target: "str",
 ) -> "typing.Dict[str, str]":
-    normalized_target = resume_index_text.strip()
+    normalized_target = resume_target.strip()
+    if UUID_PATTERN.fullmatch(normalized_target):
+        sessions = list_resumable_sessions(codex_home, 1, normalized_target)
+        if not sessions:
+            raise ValueError(f"Session not found: {normalized_target}")
+        return sessions[0]
     if not normalized_target.isdigit():
-        raise ValueError("Usage: /resume <number>")
+        raise ValueError("Usage: /resume <number|session_id>")
 
     sessions = list_resumable_sessions(codex_home)
     resume_index = int(normalized_target)

{python_codex-0.4.5 → python_codex-0.4.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "python-codex"
-version = "0.4.5"
+version = "0.4.7"
 description = "A minimal Python extraction of Codex's main agent loop"
 readme = "README.md"
 requires-python = ">=3.6.2"
@@ -40,7 +40,7 @@ test = [
 ]
 dev = [
     { include-group = "test" },
-    "pycodex-ws==0.4.5",
+    "pycodex-ws==0.4.7",
     "black>=22.8.0",
     "debugpy>=1.8.20; python_version >= '3.8'",
     "isort>=5.10.1",