codex-agent-framework 0.1.23__tar.gz → 0.1.24__tar.gz

{codex_agent_framework-0.1.23 → codex_agent_framework-0.1.24}/CHANGELOG.md

@@ -4,6 +4,17 @@ 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.24] - 2026-05-10
+### Added
+- Add dedicated slash-command lifecycle events, `SlashCommandStartEvent` and `SlashCommandDoneEvent`, with command name, arguments, status, result, and error metadata.
+
+### Changed
+- Show slash-command progress directly in the Textual TUI with running/done/failed status lines so commands such as `/compact` and `/help` no longer appear silent while executing.
+- Render slash-command results and errors immediately in the TUI after completion.
+
+### Tests
+- Add regression coverage for slash-command lifecycle events, failed command reporting, and TUI rendering of command progress, results, and errors.
+
 ## [0.1.23] - 2026-05-10
 ### Added
 - Add the SDK `Agent.stream(prompt=None)` API for iterating turn events while still exposing the final `AgentTurn` through `.turn`.

{codex_agent_framework-0.1.23/codex_agent_framework.egg-info → codex_agent_framework-0.1.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.23
+Version: 0.1.24
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -610,7 +610,7 @@ python -m pytest
 The current tree validates at:
 
 ```text
-489 passed
+507 passed
 ```
 
 Build distributions:
@@ -624,6 +624,7 @@ python -m twine check dist/*
 
 ## Recent releases
 
+- `0.1.24`: add slash-command lifecycle events and TUI progress/result rendering so commands such as `/compact` and `/help` show running, done, failed, result, and error feedback instead of going silent.
 - `0.1.23`: add SDK event streaming with `Agent.stream()`, root `Agent.add_plugin()`, a faster README flow, the `~/.codex-agent` runtime default, text-first voice defaults, safer prompt templating limited to system messages, smarter `codex-agent` local-server attachment, and clearer TUI tool-call progress lines.
 - `0.1.22`: harden FastAPI/SSE and TUI streaming after a stabilization audit; add finite SSE read timeouts, stale-subscriber shutdown, persisted turn-event locking, synchronous replay delta flushes, process-runtime startup guards, isolated event handlers, and shared version metadata.
 - `0.1.21`: add structured `AgentTurn` returns with messages/events, resumable non-terminal turns for `auto_proceed=False`, profile-based subagents, hierarchical message/event types, and internal wakeups as developer messages.

{codex_agent_framework-0.1.23 → codex_agent_framework-0.1.24}/README.md

@@ -561,7 +561,7 @@ python -m pytest
 The current tree validates at:
 
 ```text
-489 passed
+507 passed
 ```
 
 Build distributions:
@@ -575,6 +575,7 @@ python -m twine check dist/*
 
 ## Recent releases
 
+- `0.1.24`: add slash-command lifecycle events and TUI progress/result rendering so commands such as `/compact` and `/help` show running, done, failed, result, and error feedback instead of going silent.
 - `0.1.23`: add SDK event streaming with `Agent.stream()`, root `Agent.add_plugin()`, a faster README flow, the `~/.codex-agent` runtime default, text-first voice defaults, safer prompt templating limited to system messages, smarter `codex-agent` local-server attachment, and clearer TUI tool-call progress lines.
 - `0.1.22`: harden FastAPI/SSE and TUI streaming after a stabilization audit; add finite SSE read timeouts, stale-subscriber shutdown, persisted turn-event locking, synchronous replay delta flushes, process-runtime startup guards, isolated event handlers, and shared version metadata.
 - `0.1.21`: add structured `AgentTurn` returns with messages/events, resumable non-terminal turns for `auto_proceed=False`, profile-based subagents, hierarchical message/event types, and internal wakeups as developer messages.

{codex_agent_framework-0.1.23 → codex_agent_framework-0.1.24}/codex_agent/__init__.py

@@ -27,6 +27,8 @@ from .event import (
     ResponseToolCallsDeltaEvent,
     ServerToolCallEvent,
     SessionDeletedEvent,
+    SlashCommandDoneEvent,
+    SlashCommandStartEvent,
     SubagentEvent,
     SessionLoadedEvent,
     ToolCallDoneEvent,
@@ -90,6 +92,8 @@ __all__ = [
     "ResponseToolCallsDeltaEvent",
     "ServerToolCallEvent",
     "SessionDeletedEvent",
+    "SlashCommandDoneEvent",
+    "SlashCommandStartEvent",
     "SubagentEvent",
     "SessionLoadedEvent",
     "ToolCallDoneEvent",

{codex_agent_framework-0.1.23 → codex_agent_framework-0.1.24}/codex_agent/command.py

@@ -259,22 +259,35 @@ class CommandManager:
         return isinstance(prompt, str) and prompt.strip().startswith("/")
 
     def run_turn(self, prompt):
-        from .event import AssistantTurnEndEvent, AssistantTurnErrorEvent, AssistantTurnStartEvent
+        from .event import AssistantTurnEndEvent, AssistantTurnErrorEvent, AssistantTurnStartEvent, SlashCommandDoneEvent, SlashCommandStartEvent
 
+        name, args = self.parse_prompt(prompt)
         self.agent.emit(AssistantTurnStartEvent, prompt=prompt)
+        self.agent.emit(SlashCommandStartEvent, prompt=prompt, name=name, args=args)
         try:
-            result = self.run(prompt)
+            result = self.run_parsed(prompt, name=name, args=args)
+            self.agent.emit(SlashCommandDoneEvent, prompt=prompt, name=name, args=args, status="done", result=result)
             self.agent.emit(AssistantTurnEndEvent, prompt=prompt, reason=TURN_REASON_COMPLETED)
             return result
         except Exception as exc:
+            self.agent.emit(SlashCommandDoneEvent, prompt=prompt, name=name, args=args, status="failed", error=str(exc))
             self.agent.emit(AssistantTurnErrorEvent, prompt=prompt, error=str(exc))
             raise
 
     def run(self, prompt):
+        name, args = self.parse_prompt(prompt)
+        return self.run_parsed(prompt, name=name, args=args)
+
+    def parse_prompt(self, prompt):
+        text = str(prompt or "").strip()
+        name, _, args = text[1:].partition(" ") if text.startswith("/") else text.partition(" ")
+        return name, args
+
+    def run_parsed(self, prompt, name=None, args=None):
         from .tool import reset_current_agent, set_current_agent
 
-        text = prompt.strip()
-        name, _, args = text[1:].partition(" ")
+        name = "" if name is None else name
+        args = "" if args is None else args
         if not name:
             return None
         command_func = self.commands.get(name)

{codex_agent_framework-0.1.23 → codex_agent_framework-0.1.24}/codex_agent/event.py

@@ -107,6 +107,21 @@ class MessageSubmittedEvent(Event):
     turn_id = None
 
 
+class SlashCommandStartEvent(Event):
+    prompt = ''
+    name = ''
+    args = ''
+
+
+class SlashCommandDoneEvent(Event):
+    prompt = ''
+    name = ''
+    args = ''
+    status = ''
+    result = None
+    error = ''
+
+
 class CompactionRequestedEvent(Event):
     compacted_message_count = 0
     compacted_token_count = 0

{codex_agent_framework-0.1.23 → codex_agent_framework-0.1.24}/codex_agent/tui/chat.py

@@ -16,6 +16,8 @@ from ..event import (
     ResponseContentDeltaEvent,
     ResponseDoneEvent,
     ServerToolCallEvent,
+    SlashCommandDoneEvent,
+    SlashCommandStartEvent,
     ToolCallDoneEvent,
     ToolCallStartEvent,
 )
@@ -116,6 +118,7 @@ class Chat:
         self.client = client or AgentClient(base_url=base_url)
         self.app = None
         self._seen_tool_calls = set()
+        self._seen_slash_commands = set()
         self._agent_buffer = ""
         self._step_had_content = False
         self._transcript = []
@@ -148,6 +151,8 @@ class Chat:
         self.client.on(ToolCallStartEvent, self._once(self._on_tool_call_start))
         self.client.on(ToolCallDoneEvent, self._once(self._on_tool_call_done))
         self.client.on(ServerToolCallEvent, self._once(self._on_server_tool_call))
+        self.client.on(SlashCommandStartEvent, self._once(self._on_slash_command_start))
+        self.client.on(SlashCommandDoneEvent, self._once(self._on_slash_command_done))
         self.client.on("server_connected", self._on_server_connected)
         self.client.on("server_offline", self._on_server_offline)
         self.client.on("server_subscribed", self._on_server_subscribed)
@@ -329,6 +334,9 @@ class Chat:
                     elif kind == "tool":
                         _, name, call_id, status = entry
                         log.write(chat.tool_call_renderable(name, call_id=call_id, status=status))
+                    elif kind == "slash_command":
+                        _, name, args, status = entry
+                        log.write(chat.slash_command_renderable(name, args=args, status=status))
                     elif kind == "step_end":
                         log.write(self.qed_marker())
                     elif kind == "user_end":
@@ -350,6 +358,7 @@ class Chat:
                 chat._agent_buffer = ""
                 chat._step_had_content = False
                 chat._seen_tool_calls.clear()
+                chat._seen_slash_commands.clear()
 
             def start_agent_step(self):
                 chat._step_had_content = False
@@ -365,6 +374,10 @@ class Chat:
                 chat.append_tool_transcript(name, call_id=call_id, status=status)
                 self.render_transcript()
 
+            def write_slash_command(self, name, args="", status=None):
+                chat.append_slash_command_transcript(name, args=args, status=status)
+                self.render_transcript()
+
             def end_agent_step(self):
                 had_content = bool(chat._agent_buffer or chat._step_had_content)
                 if chat._transcript and chat._transcript[-1][0] == "agent":
@@ -420,6 +433,11 @@ class Chat:
         self._transcript.append(("tool", name, call_id, status))
         self._step_had_content = True
 
+    def append_slash_command_transcript(self, name, args="", status=None):
+        self.ensure_agent_transcript()
+        self._transcript.append(("slash_command", name, args, status))
+        self._step_had_content = True
+
     @staticmethod
     def normalized_tool_status(status):
         if status in {"done", "completed", "success"}:
@@ -471,6 +489,25 @@ class Chat:
     def tool_status_label(status):
         return f" · {Chat.normalized_tool_status(status)}"
 
+    @staticmethod
+    def slash_command_renderable(name, args="", status=None):
+        icon, style = Chat.tool_status_badge(status)
+        command = f"/{name}" if name else "/"
+        text = Text("  ", style="#4b5563")
+        text += Text(f"{icon} ", style=style)
+        text += Text(command, style="bold white")
+        if args:
+            text += Text(f" {args}", style="#8b949e")
+        return text
+
+    @staticmethod
+    def slash_command_result_text(result):
+        if result is None:
+            return ""
+        if isinstance(result, str):
+            return result
+        return str(result)
+
     def status_renderable(self):
         if not self._server_connected:
             suffix = f" · {self._server_error}" if self._server_error else ""
@@ -697,6 +734,30 @@ class Chat:
         self._seen_tool_calls.add(key)
         self._call_app("write_tool", name, call_id, status or "running")
 
+    def _on_slash_command_start(self, event):
+        self._mark_server_connected()
+        self.flush_agent_delta()
+        self._print_slash_command(event.get("name") or "", event.get("args") or "", status="running")
+
+    def _on_slash_command_done(self, event):
+        self._mark_server_connected()
+        self.flush_agent_delta()
+        status = event.get("status") or ("failed" if event.get("error") else "done")
+        self._print_slash_command(event.get("name") or "", event.get("args") or "", status=status)
+        result = self.slash_command_result_text(event.get("result"))
+        if result:
+            self._call_app("write_agent_delta", result)
+        if event.get("error"):
+            self._call_app("write_error", event.get("error"))
+        self._call_app("refresh_status")
+
+    def _print_slash_command(self, name, args="", status=None):
+        key = (name, args, status or "running")
+        if key in self._seen_slash_commands:
+            return
+        self._seen_slash_commands.add(key)
+        self._call_app("write_slash_command", name, args, status or "running")
+
     def _on_turn_error(self, event):
         self._call_app("write_error", event.get("error", "turn error"))
         self._call_app("refresh_status")

codex_agent_framework-0.1.24/codex_agent/version.py

@@ -0,0 +1 @@
+__version__ = "0.1.24"

{codex_agent_framework-0.1.23 → codex_agent_framework-0.1.24/codex_agent_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.23
+Version: 0.1.24
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -610,7 +610,7 @@ python -m pytest
 The current tree validates at:
 
 ```text
-489 passed
+507 passed
 ```
 
 Build distributions:
@@ -624,6 +624,7 @@ python -m twine check dist/*
 
 ## Recent releases
 
+- `0.1.24`: add slash-command lifecycle events and TUI progress/result rendering so commands such as `/compact` and `/help` show running, done, failed, result, and error feedback instead of going silent.
 - `0.1.23`: add SDK event streaming with `Agent.stream()`, root `Agent.add_plugin()`, a faster README flow, the `~/.codex-agent` runtime default, text-first voice defaults, safer prompt templating limited to system messages, smarter `codex-agent` local-server attachment, and clearer TUI tool-call progress lines.
 - `0.1.22`: harden FastAPI/SSE and TUI streaming after a stabilization audit; add finite SSE read timeouts, stale-subscriber shutdown, persisted turn-event locking, synchronous replay delta flushes, process-runtime startup guards, isolated event handlers, and shared version metadata.
 - `0.1.21`: add structured `AgentTurn` returns with messages/events, resumable non-terminal turns for `auto_proceed=False`, profile-based subagents, hierarchical message/event types, and internal wakeups as developer messages.

{codex_agent_framework-0.1.23 → codex_agent_framework-0.1.24}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codex-agent-framework"
-version = "0.1.23"
+version = "0.1.24"
 description = "A lightweight event-driven Codex agent runtime."
 readme = "README.md"
 requires-python = ">=3.10"

{codex_agent_framework-0.1.23 → codex_agent_framework-0.1.24}/tests/test_agent.py

@@ -7,7 +7,7 @@ from typing import Literal
 
 import codex_agent.utils as utils
 from modict import modict
-from codex_agent import Agent, AssistantInterruptRequestedEvent, AssistantInterrupted, AssistantInterruptedEvent, AssistantTurnEndEvent, AssistantTurnStartEvent, AssistantStepEndEvent, AudioPlaybackEvent, MessageSubmittedEvent, CompactionCompletedEvent, CompactionMessage, CompactionRequestedEvent, ImageGenerationTool, ResponseContentDeltaEvent, ResponseDoneEvent, ServerToolCallEvent, SessionDeletedEvent, SessionLoadedEvent, SubagentEvent, ToolCallStartEvent, WebSearchTool, get_agent, get_current_call_id
+from codex_agent import Agent, AssistantInterruptRequestedEvent, AssistantInterrupted, AssistantInterruptedEvent, AssistantTurnEndEvent, AssistantTurnStartEvent, AssistantStepEndEvent, AudioPlaybackEvent, MessageSubmittedEvent, CompactionCompletedEvent, CompactionMessage, CompactionRequestedEvent, ImageGenerationTool, ResponseContentDeltaEvent, ResponseDoneEvent, ServerToolCallEvent, SessionDeletedEvent, SessionLoadedEvent, SlashCommandDoneEvent, SlashCommandStartEvent, SubagentEvent, ToolCallStartEvent, WebSearchTool, get_agent, get_current_call_id
 from codex_agent.sessions import AgentSession, UNRESOLVED_TOOL_RESULT_CONTENT
 from codex_agent.image import ImageMessage
 from codex_agent.message import AssistantMessage, DeveloperMessage, InterruptMessage, MessageChunk, ProviderMessage, ServerToolResponseMessage, SystemMessage, ToolResultMessage, ToolResultWrapper, UserMessage
@@ -578,6 +578,48 @@ def test_agent_state_mutations_run_through_mainloop_when_started(tmp_path, monke
     agent.stop()
 
 
+def test_slash_command_emits_start_and_done_events():
+    agent = Agent(session="new", voice_enabled=False)
+    seen = []
+
+    @agent.add_command
+    def echo(value="ok"):
+        return value
+
+    agent.on(SlashCommandStartEvent, lambda event: seen.append((event.type, event.name, event.args, None)))
+    agent.on(SlashCommandDoneEvent, lambda event: seen.append((event.type, event.name, event.args, event.status, event.result, event.error)))
+
+    turn = agent.submit_command("/echo hello").wait()
+
+    assert turn.result == "hello"
+    assert seen == [
+        ("slash_command_start_event", "echo", "hello", None),
+        ("slash_command_done_event", "echo", "hello", "done", "hello", ""),
+    ]
+    assert [event.type for event in turn.events if event.type.startswith("slash_command_")] == [
+        "slash_command_start_event",
+        "slash_command_done_event",
+    ]
+    agent.stop()
+
+
+def test_slash_command_emits_failed_done_event_on_error():
+    agent = Agent(session="new", voice_enabled=False)
+    seen = []
+
+    @agent.add_command
+    def fail():
+        raise RuntimeError("boom")
+
+    agent.on(SlashCommandDoneEvent, lambda event: seen.append((event.name, event.status, event.error)))
+
+    with pytest.raises(RuntimeError, match="boom"):
+        agent.submit_command("/fail").wait()
+
+    assert seen == [("fail", "failed", "boom")]
+    agent.stop()
+
+
 def test_agent_interrupt_emits_request_event():
     agent = Agent(session="new", voice_enabled=False)
     seen = []

{codex_agent_framework-0.1.23 → codex_agent_framework-0.1.24}/tests/test_chat.py

@@ -399,6 +399,47 @@ def test_chat_displays_tool_start_and_done_as_distinct_lines(monkeypatch):
     assert calls.index(("write_tool", ("read", "call_read", "running"))) < calls.index(("write_tool", ("read", "call_read", "done")))
 
 
+def test_chat_displays_slash_command_start_and_done_as_distinct_lines(monkeypatch):
+    chat = Chat()
+    calls = []
+    monkeypatch.setattr(chat, "_call_app", lambda method, *args: calls.append((method, args)))
+
+    chat.attach()
+    chat.client.emit_local(modict(type="assistant_turn_start_event"))
+    chat.client.emit_local(modict(type="slash_command_start_event", name="compact", args="--force"))
+    chat.client.emit_local(modict(type="slash_command_done_event", name="compact", args="--force", status="done"))
+
+    assert calls.count(("write_slash_command", ("compact", "--force", "running"))) == 1
+    assert calls.count(("write_slash_command", ("compact", "--force", "done"))) == 1
+    assert calls.index(("write_slash_command", ("compact", "--force", "running"))) < calls.index(("write_slash_command", ("compact", "--force", "done")))
+
+
+def test_chat_slash_command_done_displays_result(monkeypatch):
+    chat = Chat()
+    calls = []
+    monkeypatch.setattr(chat, "_call_app", lambda method, *args: calls.append((method, args)))
+
+    chat.attach()
+    chat.client.emit_local(modict(type="slash_command_done_event", name="help", status="done", result="Available commands: /help"))
+
+    assert ("write_slash_command", ("help", "", "done")) in calls
+    assert ("write_agent_delta", ("Available commands: /help",)) in calls
+    assert calls[-1] == ("refresh_status", ())
+
+
+def test_chat_slash_command_done_displays_errors(monkeypatch):
+    chat = Chat()
+    calls = []
+    monkeypatch.setattr(chat, "_call_app", lambda method, *args: calls.append((method, args)))
+
+    chat.attach()
+    chat.client.emit_local(modict(type="slash_command_done_event", name="missing", status="failed", error="Unknown command: /missing"))
+
+    assert ("write_slash_command", ("missing", "", "failed")) in calls
+    assert ("write_error", ("Unknown command: /missing",)) in calls
+    assert calls[-1] == ("refresh_status", ())
+
+
 def test_chat_tool_status_helpers_are_compact_and_consistent():
     assert Chat.normalized_tool_status("success") == "done"
     assert Chat.normalized_tool_status("error") == "failed"

codex_agent_framework-0.1.23/codex_agent/version.py

@@ -1 +0,0 @@
-__version__ = "0.1.23"