python-codex 0.4.0__tar.gz → 0.4.1__tar.gz

{python_codex-0.4.0 → python_codex-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-codex
-Version: 0.4.0
+Version: 0.4.1
 Summary: A minimal Python extraction of Codex's main agent loop
 License-File: LICENSE
 Requires-Python: >=3.6.2
@@ -40,10 +40,14 @@ The import path remains `pycodex`; the CLI commands are `pycodex` and
 
 `python-codex` contains the Agent, runtime, CLI, standard tools, Responses
 compatibility server and portable storage support. `pycodex-ws` depends on the
-exact matching core version and contains the browser workspace, viewer assets,
-Feishu and IPython integrations, including their dependencies. It owns the
+exact matching core version and contains the browser workspace, viewer assets
+and optional Feishu integration. It owns the
 `workspace_server` and `pycodex_ws` modules and the `pycodex-ws` command.
 
+The Feishu SDK is not installed automatically. Install it in the workspace's
+Python environment with `python3 -m pip install lark-oapi` to enable `/link`.
+If `lark_oapi` cannot be imported, `/link` reports that it is unavailable.
+
 Core does not require Pillow. Without it, `view_image` sends the original image
 bytes with `detail="original"`, including when `high` is requested. With Pillow
 installed, the default path retains resizing to a maximum dimension of 2048.
@@ -78,7 +82,7 @@ Relevant Rust reference points:
 
 ## Quick Start
 
-Install the core CLI, or install the workspace package to include all integrations:
+Install the core CLI, or install the workspace package for the browser frontend:
 
 ```bash
 python3 -m pip install python-codex
@@ -86,7 +90,7 @@ python3 -m pip install pycodex-ws
 ```
 
 The core supports Python 3.6.2 or newer. The workspace package requires Python
-3.7 or newer because of its Feishu SDK dependency. Commands are installed into
+3.7 or newer. Commands are installed into
 that interpreter's scripts directory. On a machine with multiple Python
 installations, select the same interpreter explicitly for startup:
 
@@ -118,7 +122,7 @@ uv run pycodex
 
 Tests are split by package. `uv run --dev pytest` runs both suites;
 `uv run --dev pytest packages/pycodex-ws/tests` runs workspace and integration
-tests. To check core without installing workspace or its SDKs, use a separate
+tests. To check core without installing workspace, use a separate
 environment:
 
 ```bash
@@ -202,7 +206,7 @@ Supporting services live in `tools/`, `portable/` and `utils/`.
 - `pycodex/utils/image_utils.py`: image loading, resizing and data-URL preparation
 - `pycodex/prompts/`: vendored prompts and model metadata
 - `packages/pycodex-ws/workspace_server/`: Web board, API and file/diff viewers
-- `packages/pycodex-ws/pycodex_ws/`: Feishu, IPython and workspace assembly
+- `packages/pycodex-ws/pycodex_ws/`: Feishu and workspace assembly
 - `packages/pycodex-ws/extensions/vscode/`: workspace's VS Code frontend, built separately as a VSIX
 - `tests/`: core tests
 - `packages/pycodex-ws/tests/`: workspace and cross-frontend integration tests
@@ -414,7 +418,8 @@ Current behavior:
   user instruction; this is intended for side-effect follow-ups such as
   Feishu notifications
 - `/link <feishu-email|open_id|chat_id>` in a workspace session attaches it
-  to a Feishu card; multiple sessions in the same workspace process share
+  to a Feishu card when the optional `lark-oapi` SDK can be imported;
+  multiple sessions in the same workspace process share
   one Feishu long-connection listener and route card actions by message id
 - Feishu user OAuth stores its refresh token only in
   `~/.codex/.feishu_refresh_token` (mode `0600`). Run
@@ -735,8 +740,7 @@ CLI, Web and Feishu all use `AgentRuntime.submit_input`: not just `/model`
 and `/resume`, but every session command, steer/queue admission, interactive
 questions and permissions, state notifications and shutdown. Frontends only
 adapt input and render events. Web no longer imports or runs the CLI shell.
-IPython is the deliberate exception: `pycodex_ws.ipython.ipython_agent()` returns
-a bare Agent. Workspace assembly uses `pycodex_ws.build_runtime()` to add
+Workspace assembly uses `pycodex_ws.build_runtime()` to add
 `/link` and `/unlink`; `pycodex.bootstrap.build_runtime()` provides core commands.
 
 ```python

{python_codex-0.4.0 → python_codex-0.4.1}/README.md

@@ -20,10 +20,14 @@ The import path remains `pycodex`; the CLI commands are `pycodex` and
 
 `python-codex` contains the Agent, runtime, CLI, standard tools, Responses
 compatibility server and portable storage support. `pycodex-ws` depends on the
-exact matching core version and contains the browser workspace, viewer assets,
-Feishu and IPython integrations, including their dependencies. It owns the
+exact matching core version and contains the browser workspace, viewer assets
+and optional Feishu integration. It owns the
 `workspace_server` and `pycodex_ws` modules and the `pycodex-ws` command.
 
+The Feishu SDK is not installed automatically. Install it in the workspace's
+Python environment with `python3 -m pip install lark-oapi` to enable `/link`.
+If `lark_oapi` cannot be imported, `/link` reports that it is unavailable.
+
 Core does not require Pillow. Without it, `view_image` sends the original image
 bytes with `detail="original"`, including when `high` is requested. With Pillow
 installed, the default path retains resizing to a maximum dimension of 2048.
@@ -58,7 +62,7 @@ Relevant Rust reference points:
 
 ## Quick Start
 
-Install the core CLI, or install the workspace package to include all integrations:
+Install the core CLI, or install the workspace package for the browser frontend:
 
 ```bash
 python3 -m pip install python-codex
@@ -66,7 +70,7 @@ python3 -m pip install pycodex-ws
 ```
 
 The core supports Python 3.6.2 or newer. The workspace package requires Python
-3.7 or newer because of its Feishu SDK dependency. Commands are installed into
+3.7 or newer. Commands are installed into
 that interpreter's scripts directory. On a machine with multiple Python
 installations, select the same interpreter explicitly for startup:
 
@@ -98,7 +102,7 @@ uv run pycodex
 
 Tests are split by package. `uv run --dev pytest` runs both suites;
 `uv run --dev pytest packages/pycodex-ws/tests` runs workspace and integration
-tests. To check core without installing workspace or its SDKs, use a separate
+tests. To check core without installing workspace, use a separate
 environment:
 
 ```bash
@@ -182,7 +186,7 @@ Supporting services live in `tools/`, `portable/` and `utils/`.
 - `pycodex/utils/image_utils.py`: image loading, resizing and data-URL preparation
 - `pycodex/prompts/`: vendored prompts and model metadata
 - `packages/pycodex-ws/workspace_server/`: Web board, API and file/diff viewers
-- `packages/pycodex-ws/pycodex_ws/`: Feishu, IPython and workspace assembly
+- `packages/pycodex-ws/pycodex_ws/`: Feishu and workspace assembly
 - `packages/pycodex-ws/extensions/vscode/`: workspace's VS Code frontend, built separately as a VSIX
 - `tests/`: core tests
 - `packages/pycodex-ws/tests/`: workspace and cross-frontend integration tests
@@ -394,7 +398,8 @@ Current behavior:
   user instruction; this is intended for side-effect follow-ups such as
   Feishu notifications
 - `/link <feishu-email|open_id|chat_id>` in a workspace session attaches it
-  to a Feishu card; multiple sessions in the same workspace process share
+  to a Feishu card when the optional `lark-oapi` SDK can be imported;
+  multiple sessions in the same workspace process share
   one Feishu long-connection listener and route card actions by message id
 - Feishu user OAuth stores its refresh token only in
   `~/.codex/.feishu_refresh_token` (mode `0600`). Run
@@ -715,8 +720,7 @@ CLI, Web and Feishu all use `AgentRuntime.submit_input`: not just `/model`
 and `/resume`, but every session command, steer/queue admission, interactive
 questions and permissions, state notifications and shutdown. Frontends only
 adapt input and render events. Web no longer imports or runs the CLI shell.
-IPython is the deliberate exception: `pycodex_ws.ipython.ipython_agent()` returns
-a bare Agent. Workspace assembly uses `pycodex_ws.build_runtime()` to add
+Workspace assembly uses `pycodex_ws.build_runtime()` to add
 `/link` and `/unlink`; `pycodex.bootstrap.build_runtime()` provides core commands.
 
 ```python

{python_codex-0.4.0 → python_codex-0.4.1}/README_ZH.md

@@ -19,9 +19,13 @@ Import 路径仍保持 `pycodex`；CLI 命令为 `pycodex` 和 `pycodex-ws`。
 
 `python-codex` 提供 Agent、Runtime、CLI、标准工具、Responses 兼容服务和
 整套 portable 功能。`pycodex-ws` 精确依赖同版本的核心包，提供 Web 看板、
-viewer 资源、飞书和 IPython 集成及其依赖；它独立拥有 `workspace_server`、
+viewer 资源和可选飞书集成；它独立拥有 `workspace_server`、
 `pycodex_ws` 模块和 `pycodex-ws` 命令。
 
+飞书 SDK 不会自动安装。需要 `/link` 时，在 workspace 使用的 Python 环境中
+手动执行 `python3 -m pip install lark-oapi`。如果无法导入 `lark_oapi`，
+`/link` 只提示不可用，其他 workspace 功能照常使用。
+
 核心包不依赖 Pillow。未安装时，`view_image` 直接发送原图并返回
 `detail="original"`，省略 `detail` 或指定 `high` 也一样；已安装时默认仍将
 最长边缩至不超过 2048。`pycodex-ws` 为图片预览校验直接依赖 Pillow。
@@ -58,7 +62,7 @@ python3 -m pip install python-codex
 python3 -m pip install pycodex-ws
 ```
 
-核心包要求 Python 3.6.2 或更新版本；workspace 包因飞书 SDK 要求 Python 3.7+。
+核心包要求 Python 3.6.2 或更新版本；workspace 包要求 Python 3.7+。
 命令会安装到该解释器的 scripts 目录。
 在同时存在 Python 2/3 或多套 Python 的机器上，可以明确使用安装时的解释器启动：
 
@@ -141,7 +145,7 @@ core 测试支持 Python 3.6.2+，workspace 测试要求 Python 3.7+；
 - `pycodex/utils/image_utils.py`：图片加载、缩放和 data URL 转换
 - `pycodex/prompts/`：内置提示和模型元数据
 - `packages/pycodex-ws/workspace_server/`：Web 看板、API、文件/diff 查看器
-- `packages/pycodex-ws/pycodex_ws/`：飞书、IPython 与 workspace 装配
+- `packages/pycodex-ws/pycodex_ws/`：飞书与 workspace 装配
 - `packages/pycodex-ws/extensions/vscode/`：属于 workspace 的 VS Code 前端，独立构建 VSIX
 - `tests/`：core 测试
 - `packages/pycodex-ws/tests/`：workspace 与跨前端集成测试
@@ -154,7 +158,6 @@ core 测试支持 Python 3.6.2+，workspace 测试要求 Python 3.7+；
 所有会话命令、steer/queue 策略、模型/历史/标题状态、交互问答和权限响应、
 worker 启停及连接清理都由后端统一处理，前端只做输入和展示适配。
 Web 不再导入或运行 CLI shell，飞书运行中也能提交 steer 和回答问题。
-IPython 是明确的例外：`pycodex_ws.ipython.ipython_agent()` 返回裸 Agent。
 Workspace 使用 `pycodex_ws.build_runtime()` 装配 `/link`、`/unlink`；
 `pycodex.bootstrap.build_runtime()` 仅装配核心会话命令。
 

{python_codex-0.4.0 → python_codex-0.4.1}/pycodex/runtime.py

@@ -307,7 +307,7 @@ class AgentRuntime:
             if not self.agent.history:
                 return {"kind": "compact_empty"}
             result = await self.agent.compact()
-            self.publish_state("history")
+            self.publish_state("compacted")
             return {
                 "kind": "compacted",
                 "original_item_count": result.original_item_count,

{python_codex-0.4.0 → python_codex-0.4.1}/pycodex/utils/async_bridge.py

@@ -5,10 +5,9 @@ import inspect
 def run_async(awaitable):
     """Run an awaitable from synchronous code and return its real result.
 
-    This helper is intended for sync call sites (for example, IPython cells)
-    that need to call async agent APIs without managing the event loop
-    themselves. It returns the underlying result directly and raises on
-    failure instead of swallowing exceptions.
+    This helper lets synchronous callers use async agent APIs without
+    managing the event loop themselves. It returns the underlying result
+    directly and propagates exceptions.
     """
     try:
         running_loop = asyncio.get_running_loop()

{python_codex-0.4.0 → python_codex-0.4.1}/pycodex/utils/session_persist.py

@@ -3,6 +3,7 @@ import mmap
 import os
 import re
 import typing
+from collections import deque
 from contextlib import closing
 from datetime import datetime
 from pathlib import Path
@@ -323,6 +324,33 @@ def conversation_history_to_turns(
     return tuple(turns)
 
 
+def load_display_history(
+    rollout_path: "typing.Union[str, Path]",
+    limit: "int" = 80,
+) -> "typing.Tuple[typing.Union[typing.Tuple[str, str], None], ...]":
+    """Read visible turns across checkpoints; None marks a compaction."""
+    path = Path(rollout_path).expanduser().resolve()
+    turns = deque(maxlen=limit)
+    for entry in _iter_rollout_entries(path):
+        item_type = entry.get("type")
+        payload = entry.get("payload")
+        if not isinstance(payload, dict):
+            continue
+        if item_type == "compacted":
+            turns.append(None)
+        elif item_type == "event_msg" and payload.get("type") == "user_message":
+            turns.append((str(payload.get("message", "")), ""))
+        elif (
+            item_type == "response_item"
+            and payload.get("type") == "message"
+            and payload.get("role") == "assistant"
+        ):
+            if not turns or turns[-1] is None:
+                turns.append(("", ""))
+            turns[-1] = (turns[-1][0], _extract_response_message_text(payload))
+    return tuple(turns)
+
+
 def _drop_unmatched_tool_calls(
     history: "typing.List[ConversationItem]",
 ) -> "typing.List[ConversationItem]":

{python_codex-0.4.0 → python_codex-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "python-codex"
-version = "0.4.0"
+version = "0.4.1"
 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.0",
+    "pycodex-ws==0.4.1",
     "black>=22.8.0",
     "debugpy>=1.8.20; python_version >= '3.8'",
     "isort>=5.10.1",