python-codex 0.1.6__tar.gz → 0.1.8__tar.gz

{python_codex-0.1.6 → python_codex-0.1.8}/AGENTS.md

@@ -35,6 +35,7 @@
 - 当前 `exec` / `wait` 已有一个最小 code-mode 实现：底层通过 Node 子进程运行 JavaScript，自带 `text` / `image` / `store` / `load` / `exit` / `notify` / `yield_control` helper，并允许通过 `tools.<name>(...)` 调回本地已注册工具；`web_search` 当前作为 Responses API provider-native tool declaration 暴露给模型，不经过本地 ToolRegistry 执行。
 - 我们支持的 tools 必须和原版 Codex 内置 tools 一一对应：名称、定位、参数形状、交互模型、输出语义都应尽量对齐；不要混合多个原版工具的语义做一个“折中工具”。
 - 代码风格上不要使用 `*` 定义 keyword-only 参数；接口默认允许位置参数。
+- runtime 包和会在 import 阶段执行的测试辅助代码需要保持 Python 3.6.2 语法兼容；不要引入 walrus `:=`、`match` 等仅 3.8+/3.10+ 可解析的新语法，哪怕分支在运行时不会走到。
 - 本仓库使用 `uv`；本地默认没有预装测试依赖，开始工作前先跑 `uv sync --dev`，验证用 `uv run pytest`。
 - 上游 Codex 的 `steer` 目前是 TUI 交互层能力：开启后 `Enter` 会立即提交，`Tab` 才是排队。对齐时优先盯“下一次发出去的请求体”而不是内部控制流；当前 `pycodex` 已把 steer/queue 语义下沉到 `AgentRuntime`，并让 `AgentLoop.run_turn(texts)` 一次接收一批 user texts，这样下一次请求的 `input` 可以把多个 steer 文本按顺序并到 history 尾部。`CliSessionView.handle_event()` 把 spinner 再次拉起。要保证输入不被遮挡，需要让 view 知道“当前正在输入”，并在 input-active 期间抑制这些事件对 spinner 的 resume。
 - steer 的最小交互反馈已经约定为两条显式状态文案：入队时打印 `[steer] queued: <prompt>`，该条 queued turn 真正开始执行时打印 `[steer] inserted: <prompt>`。后续如果补更复杂的 queue UI，也应保留这两个核心状态语义。

{python_codex-0.1.6 → python_codex-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-codex
-Version: 0.1.6
+Version: 0.1.8
 Summary: A minimal Python extraction of Codex's main agent loop
 License-File: LICENSE
 Requires-Python: >=3.6.2

{python_codex-0.1.6 → python_codex-0.1.8}/pycodex/cli.py

@@ -7,6 +7,7 @@ import os
 import shlex
 import sys
 import tempfile
+import traceback
 from dataclasses import asdict, replace
 from pathlib import Path
 from typing import Sequence
@@ -20,7 +21,7 @@ from .portable import bootstrap_called_home, upload_codex_home
 from .protocol import AgentEvent
 from .runtime import AgentRuntime
 from .runtime_services import RuntimeEnvironment, create_runtime_environment
-from .utils import CliSessionView, load_codex_dotenv, uuid7_string
+from .utils import CliSessionView, get_debug_dir, load_codex_dotenv, uuid7_string
 from .utils.compactor import compact_agent_loop
 from .utils.session_persist import (
     SessionRolloutRecorder,
@@ -57,9 +58,9 @@ def configure_loguru() -> 'None':
         return
 
     logger.remove()
-    log_path = os.environ.get("PYCODEX_DEBUG_LOG", "").strip()
-    if log_path:
-        logger.add(log_path, level="DEBUG")
+    debug_dir = get_debug_dir()
+    if debug_dir is not None:
+        logger.add(str(debug_dir / "loguru.log"), level="DEBUG")
         return
 
     if os.environ.get("PYCODEX_DEBUG_STDERR", "").strip().lower() in {
@@ -743,6 +744,8 @@ async def run_interactive_session(
 async def run_cli(args: 'argparse.Namespace') -> 'int':
     runtime = None
     worker = None
+    debug_dir = get_debug_dir()
+    phase_handle = None if debug_dir is None else (debug_dir / "phase.log").open("a", encoding="utf-8")
     try:
         if args.put is not None and args.call:
             raise ValueError("--put and --call cannot be combined")
@@ -762,9 +765,18 @@ async def run_cli(args: 'argparse.Namespace') -> 'int':
             print(f"pycodex --call {shlex.quote(call_spec)}", flush=True)
             return 0
         if args.call:
+            if phase_handle is not None:
+                phase_handle.write("bootstrap_called_home:start\n")
+                phase_handle.flush()
             config_path = bootstrap_called_home(args.call)
+            if phase_handle is not None:
+                phase_handle.write("bootstrap_called_home:done\n")
+                phase_handle.flush()
             args.config = str(config_path)
             os.environ["CODEX_HOME"] = str(config_path.parent)
+        if phase_handle is not None:
+            phase_handle.write("build_model_client:start\n")
+            phase_handle.flush()
         client = _build_model_client(
             args.config,
             args.profile,
@@ -773,7 +785,13 @@ async def run_cli(args: 'argparse.Namespace') -> 'int':
             use_chat_completion=args.use_chat_completion,
             use_messages=args.use_messages,
         )
+        if phase_handle is not None:
+            phase_handle.write("build_model_client:done\n")
+            phase_handle.flush()
 
+        if phase_handle is not None:
+            phase_handle.write("build_runtime:start\n")
+            phase_handle.flush()
         runtime = build_runtime(
             args.config,
             args.profile,
@@ -781,6 +799,9 @@ async def run_cli(args: 'argparse.Namespace') -> 'int':
             client,
             session_mode="tui",
         )
+        if phase_handle is not None:
+            phase_handle.write("build_runtime:done\n")
+            phase_handle.flush()
         if should_run_interactive(args.prompt, sys.stdin.isatty()):
             return await run_interactive_session(
                 runtime,
@@ -790,13 +811,28 @@ async def run_cli(args: 'argparse.Namespace') -> 'int':
         else:
             prompt_text = resolve_prompt_text(args.prompt)
             worker = asyncio.create_task(runtime.run_forever())
+            if phase_handle is not None:
+                phase_handle.write("submit_user_turn:start\n")
+                phase_handle.flush()
             result = await runtime.submit_user_turn(prompt_text)
+            if phase_handle is not None:
+                phase_handle.write("submit_user_turn:done\n")
+                phase_handle.flush()
             print(format_turn_output(result, args.json))
             return 0
     except Exception as exc:
+        if phase_handle is not None:
+            phase_handle.write("fatal_exception\n")
+            phase_handle.flush()
+        if debug_dir is not None:
+            (debug_dir / "fatal_error.txt").write_text(
+                traceback.format_exc(), encoding="utf-8"
+            )
         print(f"Error: {exc}", file=sys.stderr)
         return 1
     finally:
+        if phase_handle is not None:
+            phase_handle.close()
         if runtime is not None and worker is not None:
             await runtime.shutdown()
             await worker

{python_codex-0.1.6 → python_codex-0.1.8}/pycodex/tools/base_tool.py

@@ -16,8 +16,10 @@ from dataclasses import dataclass
 from functools import lru_cache
 import json
 from pathlib import Path
+import traceback
 
 from ..protocol import ConversationItem, JSONDict, JSONValue, ToolCall, ToolResult, ToolSpec
+from ..utils import get_debug_dir
 import typing
 
 EXEC_TOOLS_SNAPSHOT_PATH = (
@@ -140,6 +142,21 @@ class ToolRegistry:
                 tool_type=call.tool_type,
             )
         except Exception as exc:  # pragma: no cover - defensive wrapper
+            debug_dir = get_debug_dir()
+            if debug_dir is not None:
+                with (debug_dir / "tool_errors.jsonl").open("a", encoding="utf-8") as handle:
+                    handle.write(
+                        json.dumps(
+                            {
+                                "tool": call.name,
+                                "call_id": call.call_id,
+                                "error": f"{type(exc).__name__}: {exc}",
+                                "traceback": traceback.format_exc(),
+                            },
+                            ensure_ascii=False,
+                        )
+                    )
+                    handle.write("\n")
             return ToolResult(
                 call_id=call.call_id,
                 name=call.name,

{python_codex-0.1.6 → python_codex-0.1.8}/pycodex/utils/__init__.py

@@ -1,4 +1,5 @@
 from .dotenv import DOTENV_FILENAME, load_codex_dotenv, parse_dotenv, parse_dotenv_value
+from .debug import get_debug_dir
 from .get_env import build_user_agent, get_shell_name, get_timezone_name
 from .random_ids import uuid7_string
 from .compactor import DEFAULT_COMPACT_PROMPT, SUMMARY_PREFIX, compact
@@ -31,6 +32,7 @@ __all__ = [
     "format_cli_plan_messages",
     "format_cli_tool_call_message",
     "format_cli_tool_message",
+    "get_debug_dir",
     "get_shell_name",
     "get_timezone_name",
     "load_codex_dotenv",

python_codex-0.1.8/pycodex/utils/debug.py

@@ -0,0 +1,12 @@
+import os
+from pathlib import Path
+import typing
+
+
+def get_debug_dir() -> 'typing.Union[Path, None]':
+    value = os.environ.get("PYCODEX_DEBUG_LOG", "").strip()
+    if not value:
+        return None
+    path = Path(value).expanduser()
+    path.mkdir(parents=True, exist_ok=True)
+    return path

{python_codex-0.1.6 → python_codex-0.1.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "python-codex"
-version = "0.1.6"
+version = "0.1.8"
 description = "A minimal Python extraction of Codex's main agent loop"
 readme = "README.md"
 requires-python = ">=3.6.2"

python_codex-0.1.8/tests/test_py36_syntax.py

@@ -0,0 +1,29 @@
+import ast
+import os
+import sys
+
+import pytest
+
+
+def _iter_python_files():
+    for root in ["pycodex", "responses_server", "tests"]:
+        for dirpath, _dirnames, filenames in os.walk(root):
+            for filename in filenames:
+                if filename.endswith(".py"):
+                    yield os.path.join(dirpath, filename)
+
+
+def test_python_sources_parse_with_python36_grammar():
+    if sys.version_info < (3, 8):
+        pytest.skip("ast feature_version requires Python 3.8+")
+
+    failures = []
+    for path in sorted(_iter_python_files()):
+        with open(path, "r", encoding="utf-8") as handle:
+            source = handle.read()
+        try:
+            ast.parse(source, filename=path, feature_version=(3, 6))
+        except SyntaxError as exc:
+            failures.append("%s:%s: %s" % (path, exc.lineno, exc.msg))
+
+    assert not failures, "Python 3.6-incompatible syntax found:\n%s" % "\n".join(failures)