python-codex 0.4.5__py3-none-any.whl → 0.4.7__py3-none-any.whl

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:

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=""):

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,

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))

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"])
 
 

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.dist-info → python_codex-0.4.7.dist-info}/METADATA

@@ -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.dist-info → python_codex-0.4.7.dist-info}/RECORD

@@ -2,12 +2,12 @@ pycodex/__init__.py,sha256=fHEyhylULeRo-5xEnl-UxT5ZpBzbFzRW7vLwdy_7oxU,2660
 pycodex/__main__.py,sha256=MHKZ_ae3fSLGTLUUMOx15fWdeOnJSHhq-zslRP5F5Lc,79
 pycodex/agent.py,sha256=GF-mNTnxHW8qw-72QEXfGGvExZzl8c3m6emZBux6ddw,21418
 pycodex/bootstrap.py,sha256=U1X5kwORpS5JnPk9HhIiOVWPQzDLlk_ro_cY2knwL8I,12421
-pycodex/cli.py,sha256=MLvXpVwrb-HJuVWmPFmNMTR-4cqR3X08ZfAevYlVSQI,12646
+pycodex/cli.py,sha256=uCrRARI2IypIU-1aC0Y2DLzhzYGWQta1f7zYWsyaNnU,12797
 pycodex/context.py,sha256=yfNY2alT3caQQwhay47pSSrGUbgEAcLKhTVaZqtQ4yU,26610
-pycodex/events.py,sha256=wysYXHLiCHzW3k1yaAuoRTw90NRhHPa3jtY0ANGOqH4,29694
-pycodex/model.py,sha256=3mWXTN-oV2Q50SgQYac45WT5Qk2NSmPTxSWyF-w8TRg,44583
+pycodex/events.py,sha256=L7RkZ3EtFQOfWg1FIG2Y0mLpDKTKV6HGmXMy9HCoWX0,29794
+pycodex/model.py,sha256=VwPN9GEdoL8N8V4hFdMmJ1rGxL_tom3Nq7ZBonCum2k,45648
 pycodex/protocol.py,sha256=uzUz_06iA4m9vAoqZeCGiJ4SocKZDzOfCJUU4Bpt5dI,12033
-pycodex/runtime.py,sha256=3wHKoNjwzOgE6dXeT6Vbpu6Nf7RWqIfHwrjsmOnk81I,23814
+pycodex/runtime.py,sha256=M_gvWDvsZBivELjNkuhmwiZVRmlaQmzKZK1ZQ5-kLLE,24271
 pycodex/portable/__init__.py,sha256=FmspRPmblYuZIVXMpXaxE1uosCaz2hZDpkpOzxDJQic,1084
 pycodex/portable/client.py,sha256=DOxzZljVfN1ynmhqrChX7NsT1IFSFVKzEn1J3wvV3XQ,16038
 pycodex/portable/server.py,sha256=w4YD71Sxb7MD5q57GPuIgx7AoicTv0R9xzX2kAaibPA,7503
@@ -57,12 +57,12 @@ pycodex/utils/crypto.py,sha256=HRCXF26Ft3S8CG2X0YpZwa8GMU9YJ0Loo8Q9PMPMcNw,1249
 pycodex/utils/debug.py,sha256=5XMpWpwFSm6woyx6RGXvN2qL0afRtTQbwlOAv-LotTw,913
 pycodex/utils/doctor.py,sha256=fI66oQqB5zNL7aEpFbiHnzhELyp9XydwMyAGznw5YSE,10616
 pycodex/utils/dotenv.py,sha256=h7ZgvqpEswetqjhtwfiaHyokAHwNKPakizTAHPHz5Ds,1865
-pycodex/utils/event_helpers.py,sha256=pnxL0-nBC7cnOheHPCIfkHqJjMbkJg3C348_EzAVhFA,6342
+pycodex/utils/event_helpers.py,sha256=EJToMDBcoxSYN71IUyZu_OEb0T0yXU4InYrowYon-OQ,6442
 pycodex/utils/get_env.py,sha256=L4S8h84tkgxZKvrxY7ezTgePbXepG-yIigUTKeY6uuE,6094
 pycodex/utils/image_utils.py,sha256=OUzUs0Cow4L8Z2np0EBeEUotAqqsCmRmhrV8AxZUXRw,2460
 pycodex/utils/model_metadata.py,sha256=uK3iI4yC7Ge7yN4I1_gQYalQ4MYKddz2qMwsmQb-P80,1337
 pycodex/utils/random_ids.py,sha256=jLTxZZ0MBbRdQOFDFWGVRjWzIo6FKSQ5ADXbQSLPp1s,379
-pycodex/utils/session_persist.py,sha256=_7Lz1jO7D0Qf16UVuZBKU_Si-k_cUVinnLMlsd1jVj4,23600
+pycodex/utils/session_persist.py,sha256=P-tsYdb1r0Ca_mVgTcK24bZM09zR-tNFgoFXlVIn5Q0,24012
 pycodex/utils/truncation.py,sha256=5D6vAorT8EgXgjd7ASwtraAyIZdlCR-w5jKZqJxDzho,5446
 pycodex/utils/_aes_gcm/LICENSE,sha256=KvdHagY3sYIK34GldJaRi34sNnGwMVJIIoDhbC9MRu8,2805
 pycodex/utils/_aes_gcm/README.md,sha256=D9XGeewCgU2PVqJCO6WusUs0Mw2FbMnABCqaVktqCnE,3045
@@ -83,8 +83,8 @@ responses_server/trajectory_dump.py,sha256=5_Wy6tslszrqx3j1JeP_boyTbzIicKy8No84P
 responses_server/tools/__init__.py,sha256=ivsBSEy0SBUhY-Uea5v1XMLXShkwHdCVl0id-1FwdZg,150
 responses_server/tools/custom_adapter.py,sha256=SnIiNUdomff3APtTriURAC9YCeEdhCDjzGMEYusfUdk,8340
 responses_server/tools/web_search.py,sha256=pnKH9JyTScRehWpZS3HpXRvjWsQvC0QZqxjEOCT4ndg,8936
-python_codex-0.4.5.dist-info/METADATA,sha256=PQFmREYi8DYVVp0Vyvau2QELSyFOCcvYedMt2DqHcfA,47674
-python_codex-0.4.5.dist-info/WHEEL,sha256=KGYbc1zXlYddvwxnNty23BeaKzh7YuoSIvIMO4jEhvw,87
-python_codex-0.4.5.dist-info/entry_points.txt,sha256=sNUVakoVuTrzJH505ZgRTQxmtRRPUHV_EH0i6EbYTyM,45
-python_codex-0.4.5.dist-info/licenses/LICENSE,sha256=0X8ifk312hYAORM4hlzg8wVSEXYKNmiPgWlB1YIy2Nw,10926
-python_codex-0.4.5.dist-info/RECORD,,
+python_codex-0.4.7.dist-info/METADATA,sha256=vJgPquHMbmWwNuGdS_iP1KP8vvS4rApkjHPtKMfJU0M,48049
+python_codex-0.4.7.dist-info/WHEEL,sha256=KGYbc1zXlYddvwxnNty23BeaKzh7YuoSIvIMO4jEhvw,87
+python_codex-0.4.7.dist-info/entry_points.txt,sha256=sNUVakoVuTrzJH505ZgRTQxmtRRPUHV_EH0i6EbYTyM,45
+python_codex-0.4.7.dist-info/licenses/LICENSE,sha256=0X8ifk312hYAORM4hlzg8wVSEXYKNmiPgWlB1YIy2Nw,10926
+python_codex-0.4.7.dist-info/RECORD,,