codex-agent-framework 0.1.4__tar.gz → 0.1.6__tar.gz

{codex_agent_framework-0.1.4 → codex_agent_framework-0.1.6}/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 
 This project loosely follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and uses semantic versioning where practical.
+## [0.1.6] - 2026-05-04
+### Added
+- Add an async-style agent mainloop with command futures so turns and state mutations can be coordinated through one runtime.
+- Add a FastAPI REST/SSE bridge and an `AgentClient` HTTP/SSE client for decoupled interfaces.
+- Add CLI modes for local embedded server + TUI client, server-only, and client-only chat operation.
+
+### Changed
+- Decouple the Textual chat UI from direct `Agent` access; the TUI now communicates with the server through HTTP and SSE.
+- Stream lightweight response deltas instead of cumulative content, reducing SSE traffic and client backpressure.
+- Use unbounded subscriber queues with ping events for more reliable SSE client delivery.
+
+### Tests
+- Add coverage for the server bridge, HTTP/SSE client, async runtime behavior, CLI modes, and event lifecycle.
+
+## [0.1.5] - 2026-05-03
+### Changed
+- Refine the default Textual chat UI with a pure black background, black multiline input area, subtler scrollbars, a smaller step-end marker, and English UI labels.
+
+
 ## [0.1.4] - 2026-05-03
 ### Added
 - Make the Textual REPL UI the default chat interface, with multiline input, subdued colors, visual speaker separators, step-end markers, and cleaner tool-call rendering.

{codex_agent_framework-0.1.4/codex_agent_framework.egg-info → codex_agent_framework-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.4
+Version: 0.1.6
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -17,6 +17,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: beautifulsoup4
 Requires-Dist: codex-backend-sdk
+Requires-Dist: fastapi
 Requires-Dist: filetype
 Requires-Dist: get-gecko-driver
 Requires-Dist: modict
@@ -38,6 +39,7 @@ Requires-Dist: selenium
 Requires-Dist: textual
 Requires-Dist: tiktoken
 Requires-Dist: trafilatura
+Requires-Dist: uvicorn
 Provides-Extra: dev
 Requires-Dist: build; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
@@ -342,6 +344,7 @@ python -m build
 The distribution includes prompt text files and `codex_agent/get_text/default_gitignore` through package data and `MANIFEST.in`.
 
 ## Recent changes
+- `0.1.5`: refine the Textual chat UI with pure black backgrounds, subtler markers/scrollbars, and English UI labels.
 - `0.1.4`: make the Textual REPL UI the default, add multiline input, assistant turn/step events, cleaner tool-call rendering, and `/voice` configuration.
 - `0.1.3`: pass the current session id as `prompt_cache_key` to the Codex backend for prompt cache reuse.
 - `0.1.2`: add `/clear` in the terminal chat to clear the screen without changing session history.

{codex_agent_framework-0.1.4 → codex_agent_framework-0.1.6}/README.md

@@ -295,6 +295,7 @@ python -m build
 The distribution includes prompt text files and `codex_agent/get_text/default_gitignore` through package data and `MANIFEST.in`.
 
 ## Recent changes
+- `0.1.5`: refine the Textual chat UI with pure black backgrounds, subtler markers/scrollbars, and English UI labels.
 - `0.1.4`: make the Textual REPL UI the default, add multiline input, assistant turn/step events, cleaner tool-call rendering, and `/voice` configuration.
 - `0.1.3`: pass the current session id as `prompt_cache_key` to the Codex backend for prompt cache reuse.
 - `0.1.2`: add `/clear` in the terminal chat to clear the screen without changing session history.

{codex_agent_framework-0.1.4 → codex_agent_framework-0.1.6}/codex_agent/__init__.py

@@ -1,7 +1,12 @@
-from .agent import Agent, AgentSession
+from .agent import Agent, AgentCommand, AgentFuture, AgentSession
+from .client import AgentClient
 from .event import (
+    AgentInterruptRequestedEvent,
     AgentInterrupted,
     AgentInterruptedEvent,
+    AgentTurnEndEvent,
+    AgentTurnErrorEvent,
+    AgentTurnStartEvent,
     AssistantStepEndEvent,
     AssistantStepStartEvent,
     AssistantTurnEndEvent,
@@ -18,6 +23,8 @@ from .event import (
     ResponseStartEvent,
     ResponseToolCallsDeltaEvent,
     ServerToolCallEvent,
+    SessionDeletedEvent,
+    SessionLoadedEvent,
     ToolCallDoneEvent,
     ToolCallStartEvent,
 )

codex_agent_framework-0.1.6/codex_agent/__main__.py

@@ -0,0 +1,73 @@
+from pathlib import Path
+
+from . import Agent
+from .chat import Chat
+from .server import create_app
+
+
+def default_agent():
+    package_dir = Path(__file__).parent
+    return Agent(
+        system=str(package_dir / 'prompts' / 'system_prompt.txt'),
+        voice_instructions="You're a lively and friendly female in her mid twenties. You speak french with a easy-going and cheerful tone.",
+        username="Baptiste",
+        userage="40",
+    )
+
+
+def run_server(host="127.0.0.1", port=8765):
+    import uvicorn
+
+    app = create_app(agent=default_agent())
+    uvicorn.run(app, host=host, port=port)
+
+
+def run_chat(base_url="http://127.0.0.1:8765"):
+    Chat(base_url=base_url).run()
+
+
+def run_local(host="127.0.0.1", port=8765):
+    import threading
+    import time
+
+    import uvicorn
+
+    app = create_app(agent=default_agent())
+    config = uvicorn.Config(app, host=host, port=port, log_level="warning")
+    server = uvicorn.Server(config)
+    thread = threading.Thread(target=server.run, name="codex-agent-server", daemon=True)
+    thread.start()
+    time.sleep(0.4)
+    try:
+        run_chat(f"http://{host}:{port}")
+    finally:
+        server.should_exit = True
+        thread.join(timeout=1.0)
+
+
+def main(argv=None):
+    import argparse
+
+    parser = argparse.ArgumentParser(prog="codex-agent")
+    parser.add_argument(
+        "mode",
+        nargs="?",
+        choices=["local", "server", "chat"],
+        default="local",
+        help="local starts an embedded server then the TUI client; server runs only the API; chat connects to an existing API.",
+    )
+    parser.add_argument("--host", default="127.0.0.1")
+    parser.add_argument("--port", type=int, default=8765)
+    parser.add_argument("--url", default=None, help="Base URL for chat mode, e.g. http://127.0.0.1:8765")
+    args = parser.parse_args(argv)
+
+    if args.mode == "server":
+        run_server(args.host, args.port)
+    elif args.mode == "chat":
+        run_chat(args.url or f"http://{args.host}:{args.port}")
+    else:
+        run_local(args.host, args.port)
+
+
+if __name__ == '__main__':
+    main()