soothe-cli 0.6.7__tar.gz → 0.6.8__tar.gz

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: soothe-cli
-Version: 0.6.7
+Version: 0.6.8
 Summary: Soothe CLI client - communicates with daemon via WebSocket
 Project-URL: Homepage, https://github.com/mirasoth/soothe
 Project-URL: Documentation, https://soothe.readthedocs.io

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/cli/commands/loop_cmd.py

@@ -1,4 +1,4 @@
-"""Loop management CLI commands for AgentLoop instances.
+"""Loop management CLI commands for StrangeLoop instances.
 
 RFC-503: Loop-First User Experience
 RFC-504: Loop Management CLI Commands
@@ -24,7 +24,7 @@ from soothe_cli.runtime import load_config
 console = Console()
 
 # Create loop command group
-loop_app = typer.Typer(help="Manage AgentLoop instances")
+loop_app = typer.Typer(help="Manage StrangeLoop instances")
 
 
 def _require_daemon(ws_url: str) -> None:
@@ -139,7 +139,7 @@ def list_loops(
         typer.Option("--limit", "-l", help="Limit number of results."),
     ] = 20,
 ) -> None:
-    """List all AgentLoop instances.
+    """List all StrangeLoop instances.
 
     Examples:
         soothe loop list
@@ -169,7 +169,7 @@ def list_loops(
         return
 
     # Render table
-    table = Table(title="AgentLoops")
+    table = Table(title="StrangeLoops")
     table.add_column("Loop ID", style="cyan")
     table.add_column("Status", style="green")
     table.add_column("Contexts", justify="right")

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/cli/execution/daemon.py

@@ -39,7 +39,7 @@ _CANCEL_SEND_TIMEOUT_S = 3.0
 
 
 def _is_loop_scoped_event(event: dict[str, Any], *, active_loop_id: str) -> bool:
-    """Return whether a daemon frame belongs to the active AgentLoop session."""
+    """Return whether a daemon frame belongs to the active StrangeLoop session."""
     event_type = event.get("type", "")
     if event_type not in {"status", "event"}:
         return True

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/cli/execution/headless.py

@@ -2,7 +2,6 @@
 
 import asyncio
 import sys
-import time
 
 import typer
 from soothe_sdk.client import (
@@ -42,7 +41,10 @@ def run_headless(
     # Auto-start daemon if not running (RFC-0013) - WebSocket RPC checks (IG-174 Phase 1)
     async def _run_headless_pipeline() -> int:
         """Ensure daemon is reachable, then run the headless daemon session."""
-        daemon_live = await is_daemon_live(ws_url, timeout=5.0)
+        # Check if daemon is live and ready (IG-489: wait for readiness, not just port-live)
+        daemon_live = await is_daemon_live(
+            ws_url, timeout=5.0, wait_for_ready=True, ready_timeout=30.0
+        )
 
         if not daemon_live:
             # Attempt cleanup if stale daemon (connection exists but daemon not responsive)
@@ -64,13 +66,10 @@ def run_headless(
                 stderr=subprocess.DEVNULL,
             )
 
-            # Wait for daemon to become fully ready with timeout
-            start_time = time.time()
-            while time.time() - start_time < _DAEMON_START_WAIT_TIMEOUT:
-                daemon_live = await is_daemon_live(ws_url, timeout=2.0)
-                if daemon_live:
-                    break
-                await asyncio.sleep(0.5)
+            # Wait for daemon to become fully ready with timeout (IG-489)
+            daemon_live = await is_daemon_live(
+                ws_url, timeout=2.0, wait_for_ready=True, ready_timeout=_DAEMON_START_WAIT_TIMEOUT
+            )
             # Note: We don't fail here - let the connection attempt handle errors
             # This allows tests and edge cases to proceed with mocked daemons
 

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/cli/main.py

@@ -152,7 +152,7 @@ def main(
         soothe -p "Research AI advances" # One-shot headless (non-TUI) query
         soothe -p "Hello" --tui         # TUI with an auto-submitted prompt
         soothe --daemon-port 9000 loop list  # Subcommands inherit global flags
-        soothe loop list                 # List AgentLoop instances
+        soothe loop list                 # List StrangeLoop instances
     """
     # Handle -h/--help flag
     if show_help:

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/runtime/headless/processor.py

@@ -110,7 +110,7 @@ class EventProcessor:
 
     @property
     def loop_id(self) -> str:
-        """Active AgentLoop id from daemon status frames."""
+        """Active StrangeLoop id from daemon status frames."""
         return self._state.loop_id
 
     @property

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/runtime/headless/processor_state.py

@@ -38,7 +38,7 @@ class ProcessorState:
     # Current plan state (updated on plan events)
     current_plan: Plan | None = None
 
-    # Active AgentLoop id from daemon status frames (``loop_id``)
+    # Active StrangeLoop id from daemon status frames (``loop_id``)
     loop_id: str = ""
 
     # Internal context tracking (suppress internal LLM responses)

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/runtime/policy/essential_events.py

@@ -6,24 +6,24 @@ from typing import Final
 
 GOAL_START_EVENT_TYPES: Final[frozenset[str]] = frozenset(
     {
-        "soothe.cognition.agent_loop.started",
+        "soothe.cognition.strange_loop.started",
         "soothe.cognition.plan.creating",
     }
 )
 
 STEP_START_EVENT_TYPES: Final[frozenset[str]] = frozenset(
     {
-        "soothe.cognition.agent_loop.step.started",
+        "soothe.cognition.strange_loop.step.started",
     }
 )
 
 STEP_COMPLETE_EVENT_TYPES: Final[frozenset[str]] = frozenset(
     {
-        "soothe.cognition.agent_loop.step.completed",
+        "soothe.cognition.strange_loop.step.completed",
     }
 )
 
-LOOP_REASON_EVENT_TYPE: Final[str] = "soothe.cognition.agent_loop.reasoned"
+LOOP_REASON_EVENT_TYPE: Final[str] = "soothe.cognition.strange_loop.reasoned"
 
 ESSENTIAL_PROGRESS_EVENT_TYPES: Final[frozenset[str]] = frozenset(
     set(GOAL_START_EVENT_TYPES)

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/runtime/policy/tui_trace_log.py

@@ -30,7 +30,7 @@ def log_tui_trace(*, tui_debug: bool, event: str, **fields: Any) -> None:
         tui_debug: Whether tracing is enabled (from config).
         event: Short event name (e.g. ``renderer.assistant_text``).
         fields: Key/value pairs appended as ``key='value'`` (strings truncated).
-            Common fields include ``loop_id`` for the active AgentLoop id.
+            Common fields include ``loop_id`` for the active StrangeLoop id.
     """
     if not tui_debug:
         return

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/runtime/state/step_router.py

@@ -1,4 +1,4 @@
-"""Per-turn routing for AgentLoop steps, root tools, and subagent task namespaces.
+"""Per-turn routing for StrangeLoop steps, root tools, and subagent task namespaces.
 
 Owns associations between execute ``step_id``, root ``tool_call_id``, LangGraph
 subgraph ``namespace``, and ``task`` delegations. Designed for parallel execute waves

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/runtime/transport/session.py

@@ -54,7 +54,7 @@ class TuiDaemonSession:
 
     @property
     def loop_id(self) -> str | None:
-        """Active AgentLoop id for this WebSocket session."""
+        """Active StrangeLoop id for this WebSocket session."""
         return self._loop_id
 
     async def connect(self, *, resume_loop_id: str | None = None) -> dict[str, Any]:
@@ -100,7 +100,7 @@ class TuiDaemonSession:
         return "adaptive"
 
     async def new_loop(self) -> dict[str, Any]:
-        """Start a new AgentLoop conversation."""
+        """Start a new StrangeLoop conversation."""
         return await self._bootstrap_loop(resume_loop_id=None)
 
     async def switch_loop(self, loop_id: str) -> dict[str, Any]:
@@ -398,7 +398,7 @@ class TuiDaemonSession:
         binder that produced the original cards.
 
         Args:
-            loop_id: AgentLoop id.
+            loop_id: StrangeLoop id.
 
         Returns:
             ``SimpleNamespace`` with ``cards: list[dict]``, ``seq: int``,
@@ -442,14 +442,14 @@ class TuiDaemonSession:
         )
 
     async def aget_loop_state(self, loop_id: str) -> Any:
-        """Load agent-loop state channels from the daemon (``loop_state_get`` RPC).
+        """Load StrangeLoop state channels from the daemon (``loop_state_get`` RPC).
 
         Returns a namespace with a ``values`` mapping so history code can share the
         same consumption pattern as the in-process agent snapshot, without passing
         graph config objects over the wire.
 
         Args:
-            loop_id: AgentLoop id.
+            loop_id: StrangeLoop id.
 
         Returns:
             ``types.SimpleNamespace`` with ``values: dict[str, Any]``.
@@ -489,7 +489,7 @@ class TuiDaemonSession:
         """Merge partial state into the loop on the daemon host (``loop_state_update`` RPC).
 
         Args:
-            loop_id: AgentLoop id.
+            loop_id: StrangeLoop id.
             values: Channel updates (e.g. ``messages``) in JSON-serializable form.
             timeout: RPC wait budget in seconds.
             as_node: Optional LangGraph node to attribute the write to. When

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/runtime/turn/prepare.py

@@ -11,12 +11,12 @@ from typing import Any
 
 from langchain_core.messages import ToolMessage
 from soothe_sdk.core.events import (
-    AGENT_LOOP_COMPLETED,
-    AGENT_LOOP_PLAN_DECISION,
-    AGENT_LOOP_STARTED,
-    AGENT_LOOP_STEP_COMPLETED,
-    AGENT_LOOP_STEP_QUEUED,
-    AGENT_LOOP_STEP_STARTED,
+    STRANGE_LOOP_COMPLETED,
+    STRANGE_LOOP_PLAN_DECISION,
+    STRANGE_LOOP_STARTED,
+    STRANGE_LOOP_STEP_COMPLETED,
+    STRANGE_LOOP_STEP_QUEUED,
+    STRANGE_LOOP_STEP_STARTED,
 )
 from soothe_sdk.ux.classification import classify_event_to_tier
 from soothe_sdk.ux.loop_stream import assistant_output_phase
@@ -38,12 +38,12 @@ _MAIN_LOOP_CUSTOM_TYPES = frozenset(
     {
         STREAM_TOOL_CALL_UPDATE,
         TOOL_CALL_UPDATES_BATCH,
-        AGENT_LOOP_STARTED,
-        AGENT_LOOP_COMPLETED,
-        AGENT_LOOP_PLAN_DECISION,
-        AGENT_LOOP_STEP_STARTED,
-        AGENT_LOOP_STEP_QUEUED,
-        AGENT_LOOP_STEP_COMPLETED,
+        STRANGE_LOOP_STARTED,
+        STRANGE_LOOP_COMPLETED,
+        STRANGE_LOOP_PLAN_DECISION,
+        STRANGE_LOOP_STEP_STARTED,
+        STRANGE_LOOP_STEP_QUEUED,
+        STRANGE_LOOP_STEP_COMPLETED,
     }
 )
 

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/tui/app/_app.py

@@ -156,7 +156,7 @@ class SootheApp(
             daemon_config: Loaded Soothe configuration (WebSocket URL, etc.).
             assistant_id: Agent identifier for memory storage.
             cwd: Current working directory to display.
-            resume_loop_id: Initial AgentLoop id when attaching to an existing loop.
+            resume_loop_id: Initial StrangeLoop id when attaching to an existing loop.
             initial_prompt: Optional prompt to auto-submit when session starts.
             initial_skill: Optional skill name to invoke when session starts.
             mcp_server_info: MCP server metadata for the `/mcp` viewer.
@@ -174,7 +174,7 @@ class SootheApp(
 
         self._cwd = str(cwd) if cwd else str(Path.cwd())
 
-        # Active AgentLoop id; LangGraph stores it as configurable.thread_id.
+        # Active StrangeLoop id; LangGraph stores it as configurable.thread_id.
         # Named `_lc_loop_id` to avoid colliding with Textual's App._thread_id.
         self._lc_loop_id = resume_loop_id
 

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/tui/app/_module_init.py

@@ -355,7 +355,7 @@ class AppResult:
     """Exit code (0 for success, non-zero for error)."""
 
     loop_id: str | None
-    """The final AgentLoop id at shutdown (may change if the user switched loops)."""
+    """The final StrangeLoop id at shutdown (may change if the user switched loops)."""
 
     session_stats: SessionStats = field(default_factory=SessionStats)
     """Cumulative usage stats across all turns in the session."""

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/tui/app/_startup.py

@@ -442,7 +442,10 @@ class _StartupMixin:
             ws_url = websocket_url_from_config(self._daemon_config)
 
             # Check daemon status via WebSocket RPC (IG-174 Phase 1)
-            daemon_live = await is_daemon_live(ws_url, timeout=5.0)
+            # Wait for daemon to be fully ready, not just port-live (IG-489)
+            daemon_live = await is_daemon_live(
+                ws_url, timeout=5.0, wait_for_ready=True, ready_timeout=30.0
+            )
 
             if not daemon_live:
                 # CLI does NOT control daemon start/stop per architectural separation (IG-174/IG-175)

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/tui/command_registry.py

@@ -97,7 +97,7 @@ COMMANDS: tuple[SlashCommand, ...] = (
     ),
     SlashCommand(
         name="/resume",
-        description="Browse and resume AgentLoop instances",
+        description="Browse and resume StrangeLoop instances",
         bypass_tier=BypassTier.IMMEDIATE_UI,
         hidden_keywords="continue history sessions loops",
     ),

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/tui/commands/command_router.py

@@ -50,7 +50,7 @@ def validate_command(
         entry: Command registry entry
         command: Command name
         query: Query parameter (if present)
-        loop_id: Active AgentLoop id for this session
+        loop_id: Active StrangeLoop id for this session
 
     Returns:
         Tuple of (is_valid, error_message)
@@ -245,7 +245,7 @@ async def handle_routing_command(
 
     For routing commands that map to a configured subagent id (e.g. ``/research``, ``/explore``),
     sets the WebSocket ``preferred_subagent`` field so the daemon merges a subagent hint into
-    AgentLoop (IG-349). Other routing commands (e.g. ``/plan``) are sent as plain text unchanged.
+    StrangeLoop (IG-349). Other routing commands (e.g. ``/plan``) are sent as plain text unchanged.
 
     Args:
         cmd_input: Full command input (e.g., "/research topic summary")

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/tui/config.py

@@ -578,7 +578,7 @@ def build_stream_config(
     * Including the SDK version here ensures it survives the merge.
 
     Args:
-        loop_id: Active AgentLoop id (stored under LangGraph ``configurable.thread_id``).
+        loop_id: Active StrangeLoop id (stored under LangGraph ``configurable.thread_id``).
         assistant_id: The agent/assistant identifier, if any.
         sandbox_type: Sandbox provider name for trace metadata, or `None` if no
             sandbox is active.

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/tui/sessions.py

@@ -73,7 +73,7 @@ class LoopInfo(TypedDict, total=False):
     """Loop metadata returned by `list_loops_via_daemon_rpc`."""
 
     loop_id: str
-    """Unique identifier for the AgentLoop."""
+    """Unique identifier for the StrangeLoop."""
 
     status: str
     """Loop status (running, paused, completed, etc.)."""
@@ -230,7 +230,7 @@ async def list_loops_via_daemon_rpc(
     limit: int = 20,
     sort_by: str = "updated",
 ) -> list[LoopInfo]:
-    """List AgentLoop instances via daemon WebSocket RPC (RFC-504).
+    """List StrangeLoop instances via daemon WebSocket RPC (RFC-504).
 
     Queries daemon's loop persistence (per-loop metadata.json files)
     instead of only local SQLite checkpoint walks.

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/tui/textual_adapter.py

@@ -31,15 +31,15 @@ if TYPE_CHECKING:
 
 from langchain_core.messages import AIMessage, HumanMessage
 from soothe_sdk.core.events import (
-    AGENT_LOOP_COMPLETED,
-    AGENT_LOOP_PLAN_DECISION,
-    AGENT_LOOP_STARTED,
-    AGENT_LOOP_STEP_COMPLETED,
-    AGENT_LOOP_STEP_QUEUED,
-    AGENT_LOOP_STEP_STARTED,
     LOOP_CLARIFICATION_ANSWERED,
     LOOP_CLARIFICATION_DEFERRED,
     LOOP_CLARIFICATION_REQUESTED,
+    STRANGE_LOOP_COMPLETED,
+    STRANGE_LOOP_PLAN_DECISION,
+    STRANGE_LOOP_STARTED,
+    STRANGE_LOOP_STEP_COMPLETED,
+    STRANGE_LOOP_STEP_QUEUED,
+    STRANGE_LOOP_STEP_STARTED,
 )
 from soothe_sdk.core.subagent_wire import is_allowlisted_subagent_event_type
 from soothe_sdk.langchain_wire import (
@@ -158,7 +158,7 @@ class TextualUIAdapter:
         """Stable tool_call_id → step card for subagent activity and pending-tool routing."""
 
         self._current_step_messages: dict[str, CognitionStepMessage] = {}
-        """Map of agent-loop act step IDs to step card widgets."""
+        """Map of StrangeLoop act step IDs to step card widgets."""
 
         self._step_by_namespace: dict[tuple[Any, ...], CognitionStepMessage] = {}
         """Active step card per stream namespace (main-agent tool aggregation, IG-402)."""
@@ -2475,7 +2475,7 @@ async def execute_task_textual(
                                     await adapter._set_spinner(None)
                                 continue
 
-                            if event_type == AGENT_LOOP_STARTED:
+                            if event_type == STRANGE_LOOP_STARTED:
                                 if not ns_key:
                                     goal_loop_start_monotonic = time.monotonic()
                                     ui_coalesce.execute_wave_active = True
@@ -2494,7 +2494,7 @@ async def execute_task_textual(
                                     assistant_message_by_namespace.pop(ns_key, None)
                                 continue
 
-                            if event_type == AGENT_LOOP_COMPLETED:
+                            if event_type == STRANGE_LOOP_COMPLETED:
                                 continue
 
                             if event_type in (
@@ -2553,7 +2553,7 @@ async def execute_task_textual(
                                 adapter._clarification_pending = False
                                 continue
 
-                            if event_type == AGENT_LOOP_PLAN_DECISION and not ns_key:
+                            if event_type == STRANGE_LOOP_PLAN_DECISION and not ns_key:
                                 raw_steps = data.get("steps")
                                 if isinstance(raw_steps, list):
                                     execution_mode = str(data.get("execution_mode", "")).strip()
@@ -2566,7 +2566,7 @@ async def execute_task_textual(
                                         ui_coalesce.execute_wave_active = True
                                 continue
 
-                            if event_type == AGENT_LOOP_STEP_QUEUED:
+                            if event_type == STRANGE_LOOP_STEP_QUEUED:
                                 step_id = str(data.get("step_id", "")).strip()
                                 description = str(data.get("description", "")).strip()
                                 if step_id:
@@ -2584,7 +2584,7 @@ async def execute_task_textual(
                                     step_widget.set_queued()
                                 continue
 
-                            if event_type == AGENT_LOOP_STEP_STARTED:
+                            if event_type == STRANGE_LOOP_STEP_STARTED:
                                 ui_coalesce.execute_wave_active = True
                                 step_id = str(data.get("step_id", "")).strip()
                                 description = str(data.get("description", "")).strip()
@@ -2637,7 +2637,7 @@ async def execute_task_textual(
 
                                     continue
 
-                            if event_type == AGENT_LOOP_STEP_COMPLETED:
+                            if event_type == STRANGE_LOOP_STEP_COMPLETED:
                                 step_id = str(data.get("step_id", "")).strip()
                                 if step_id:
                                     # Drain buffered tools that still reference this
@@ -2924,11 +2924,11 @@ __all__ = [
     "SessionStats",
     "SpinnerStatus",
     "format_token_count",
-    "AGENT_LOOP_COMPLETED",
-    "AGENT_LOOP_STARTED",
-    "AGENT_LOOP_STEP_COMPLETED",
-    "AGENT_LOOP_STEP_QUEUED",
-    "AGENT_LOOP_STEP_STARTED",
+    "STRANGE_LOOP_COMPLETED",
+    "STRANGE_LOOP_STARTED",
+    "STRANGE_LOOP_STEP_COMPLETED",
+    "STRANGE_LOOP_STEP_QUEUED",
+    "STRANGE_LOOP_STEP_STARTED",
     "TurnToolUiCoalescer",
 ]
 

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/tui/tips.py

@@ -6,7 +6,7 @@ import random
 
 SESSION_TIPS: list[str] = [
     "Use @ to reference files and / for commands",
-    "Try /resume to pick up a previous AgentLoop instance",
+    "Try /resume to pick up a previous StrangeLoop instance",
     "After Ctrl+C exit, use 'soothe loop continue' to resume",
     "Use /tokens to check context usage",
     "Use /mcp to see your loaded tools and servers",

{soothe_cli-0.6.7 → soothe_cli-0.6.8}/src/soothe_cli/tui/widgets/welcome.py

@@ -55,7 +55,7 @@ class WelcomeBanner(Static):
         """Initialize the welcome banner.
 
         Args:
-            loop_id: Optional AgentLoop id to display in the banner.
+            loop_id: Optional StrangeLoop id to display in the banner.
             mcp_tool_count: Number of MCP tools loaded at startup.
             workspace_path: Session workspace path shown in the source row.
             connecting: When `True`, show a connecting footer instead of