superqode 2.4.36__tar.gz → 2.4.38__tar.gz

{superqode-2.4.36 → superqode-2.4.38}/CHANGELOG.md

@@ -7,6 +7,56 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.4.38] - 2026-10-01
+
+### Added
+
+- Run SuperQode inside Herdr with automatic working, idle, approval and question
+  status reporting, plus harness, model and session details.
+- Restore durable interactive conversations after a Herdr server restart,
+  preserving the harness, model, runtime, approval policy and plan/build mode.
+  Update restore commands when switching or forking sessions, and replace stale
+  commands with a fresh launch when the active backend cannot resume.
+- Open saved conversations with `superqode --resume <session-id>` or fork them
+  with `superqode --fork <session-id>`. Set startup decisions with
+  `--approval-mode ask|auto|deny` and `--interaction-mode build|plan`.
+- Document setup, status semantics, pane input, restoration and troubleshooting
+  in the Herdr integration guide and CLI reference. Add Herdr checks to the
+  Linux, macOS and Windows CI matrix.
+
+### Fixed
+
+- Prevent nested coding agents, SDKs and shell tools from claiming their
+  parent's Herdr pane. Keep reporting bounded and release pane authority when
+  SuperQode exits.
+
+### Known limitations
+
+- Herdr's built-in agent registry does not yet include SuperQode. Launch it
+  normally inside a pane and use pane input; `agent start --kind`,
+  `agent prompt` and `agent send-keys` require an upstream registry entry.
+- Conversation restoration requires a durable SuperQode session and Herdr
+  0.9.2 or later. Unsupported backends reopen a fresh TUI. Native lifecycle
+  and restart tests passed with Herdr 0.9.3 on macOS; Linux and Windows checks
+  are configured in CI.
+
+## [2.4.37] - 2026-10-01
+
+### Added
+
+- Connect Muse Code’s native session host to the TUI prompt, including streamed responses, tool approvals, cancellation and successive prompts. Start the host on demand and show an actionable error if Muse rejects a saved login.
+
+### Known limitations
+
+- Muse Code can reject a detected saved credential as “not logged in”. Refresh the login in the vendor CLI before retrying. Live authenticated model responses were not verified for this release; protocol and TUI regression tests passed.
+
+### Fixed
+
+- Dismiss the welcome screen after a successful agent or model connection,
+  including self-contained vendor runtimes such as Antigravity CLI. Preserve
+  existing conversation history and prompt drafts; cancelled or failed setup
+  can still return to the welcome screen.
+
 ## [2.4.36] - 2026-10-01
 
 ### Fixed

{superqode-2.4.36 → superqode-2.4.38}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superqode
-Version: 2.4.36
+Version: 2.4.38
 Summary: The harness layer for coding agents
 Author-email: Shashi Jagtap <info@super-agentic.ai>
 Maintainer-email: Shashi Jagtap <info@super-agentic.ai>

{superqode-2.4.36 → superqode-2.4.38}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "superqode"
-version = "2.4.36"
+version = "2.4.38"
 description = "The harness layer for coding agents"
 readme = "README.md"
 license = "Apache-2.0"

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/__init__.py

@@ -38,7 +38,7 @@ __all__ = [
     "sidebar",
 ]
 
-__version__ = "2.4.36"
+__version__ = "2.4.38"
 
 # Stable, lightweight public extension surface.  Importing this package does
 # not discover or execute third-party extensions; discovery happens only when

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/acp/client.py

@@ -40,6 +40,8 @@ from superqode.acp.types import (
     AvailableCommandsResponse,
 )
 
+from superqode.herdr import child_env
+
 
 async def cancel_prompt_with_grace(
     client, prompt_task: asyncio.Task, *, timeout: float = 2.0
@@ -342,7 +344,7 @@ class ACPClient:
                 stdout=asyncio.subprocess.PIPE,
                 stderr=asyncio.subprocess.STDOUT,  # Merge stderr into stdout
                 cwd=str(self.project_root),
-                env=env,
+                env=child_env(env),
                 limit=10 * 1024 * 1024,  # 10MB buffer
             )
 
@@ -1656,7 +1658,7 @@ class ACPClient:
                 stderr=asyncio.subprocess.STDOUT,
                 stdin=asyncio.subprocess.PIPE,
                 cwd=cwd or str(self.project_root),
-                env=env,
+                env=child_env(env),
             )
 
             self._terminals[terminal_id] = {

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/agents/client.py

@@ -59,6 +59,8 @@ from acp.schema import (
     WriteTextFileResponse,
 )
 
+from superqode.herdr import child_env
+
 
 class SuperQodeACPClient(Client):
     """ACP client implementation for SuperQode."""
@@ -191,7 +193,7 @@ class ACPAgentManager:
                 stdin=asyncio.subprocess.PIPE,
                 stdout=asyncio.subprocess.PIPE,
                 cwd=cwd or os.getcwd(),
-                env={**os.environ, **extra_env} if extra_env else None,
+                env=child_env({**os.environ, **(extra_env or {})}),
             )
 
             if proc.stdin is None or proc.stdout is None:

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/__init__.py

@@ -111,15 +111,20 @@ def _print_launch_splash() -> None:
         pass
 
 
-def run_textual_app():
+def run_textual_app(**startup):
     """Run the SuperQode Textual TUI application."""
     _print_launch_splash()
 
     # Import from parent module to avoid duplication
     from superqode.app_main import SuperQodeApp
 
-    app = SuperQodeApp()
-    app.run()
+    app = SuperQodeApp(**startup)
+    try:
+        app.run()
+    finally:
+        from superqode.app.herdr import close
+
+        close(app)
 
 
 __all__ = [

superqode-2.4.38/src/superqode/app/herdr.py

@@ -0,0 +1,108 @@
+"""Bridge the interactive app's shared lifecycle to Herdr."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from superqode.herdr import HerdrReporter, launch_prefix, valid_resume_argv
+
+
+def resume_command(app) -> tuple[str, tuple[str, ...]]:
+    """Advertise only a durable active session, never a recent-session fallback."""
+    approval = getattr(app, "approval_mode", "ask")
+    mode = "plan" if getattr(app, "_plan_mode_enabled", False) else "build"
+    base = (*launch_prefix(), "--tui", "--approval-mode", approval, "--interaction-mode", mode)
+    # Replacing a previous restore command with a fresh launch prevents Herdr
+    # from reopening the old conversation after disconnecting or changing to
+    # a backend without durable SuperQode session storage.
+    fresh = base if valid_resume_argv(base) else ("superqode", "--tui")
+    pure = getattr(app, "_pure_mode", None)
+    if pure is None or not getattr(getattr(pure, "session", None), "connected", False):
+        return "", fresh
+    if getattr(app, "current_agent", "") or getattr(app, "_chat_mode", False):
+        return "", fresh
+    try:
+        sid = pure.get_current_session_id()
+        manager = getattr(pure, "_session_manager", None)
+        meta = manager.get_session_info(sid) if sid and manager else None
+        if meta is None or not meta.provider or not meta.model:
+            return "", fresh
+        # Session storage and Herdr's restored pane both belong to this cwd.
+        if (
+            meta.working_directory
+            and Path(meta.working_directory).resolve() != Path.cwd().resolve()
+        ):
+            return "", fresh
+        harness = meta.harness_path or meta.harness_id or "core"
+        if not meta.harness_session and getattr(pure, "_agent", None) is None:
+            return "", fresh
+        argv = (
+            *base,
+            "--resume",
+            sid,
+            "--provider",
+            meta.provider,
+            "--model",
+            meta.model,
+            "--harness",
+            harness,
+            "--runtime",
+            pure.runtime_name,
+        )
+        if valid_resume_argv(argv):
+            return sid, argv
+    except (AttributeError, OSError, TypeError, ValueError):
+        pass
+    return "", fresh
+
+
+def start(app) -> None:
+    app._herdr_reporter = HerdrReporter.from_env()
+    sync(app)
+
+
+def sync(app) -> None:
+    reporter = getattr(app, "_herdr_reporter", None)
+    if reporter is None:
+        return
+    pending = []
+    pure = getattr(app, "_pure_mode", None)
+    try:
+        pending = pure.get_pending_approvals() if pure is not None else []
+    except Exception:
+        pass
+    if getattr(app, "_herdr_restore_error", "") and not getattr(
+        getattr(pure, "session", None), "connected", False
+    ):
+        state, message = "blocked", "Session restore failed"
+    elif getattr(app, "_awaiting_agent_question", False):
+        state, message = "blocked", "Answer needed"
+    elif getattr(app, "_permission_pending", False) or pending:
+        state, message = "blocked", "Approval needed"
+    else:
+        state = "working" if getattr(app, "is_busy", False) else "idle"
+        message = ""
+    harness = getattr(app, "current_agent", "") or getattr(app, "current_mode", "")
+    model = getattr(app, "current_model", "")
+    try:
+        status = app.query_one("#status-bar")
+        harness = getattr(status, "active_harness", "") or harness
+        model = getattr(status, "active_model", "") or model
+    except Exception:
+        pass
+    sid, argv = resume_command(app)
+    reporter.report(
+        state,
+        message=message,
+        harness=harness,
+        model=model,
+        session_id=sid,
+        resume_argv=argv,
+    )
+
+
+def close(app) -> None:
+    reporter = getattr(app, "_herdr_reporter", None)
+    if reporter is not None:
+        app._herdr_reporter = None
+        reporter.close()

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/mixins/agent_run.py

@@ -43,6 +43,8 @@ from superqode.app.recipes import LocalRecipe
 from superqode.app.async_utils import _AsyncLoopThread
 from superqode.app.session_state import get_session
 
+from superqode.herdr import child_env
+
 _ACP_AGENT_SHORT_NAMES: frozenset[str] | None = None
 
 
@@ -1703,7 +1705,7 @@ class AgentRunMixin:
                 cwd=os.getcwd(),
                 text=True,
                 bufsize=1,
-                env=env,
+                env=child_env(env),
             )
 
             # Store process reference for cancellation
@@ -1850,6 +1852,7 @@ class AgentRunMixin:
                 stderr=subprocess.STDOUT,
                 text=True,
                 bufsize=1,
+                env=child_env(),
             )
             self._agent_process = process
 
@@ -3064,7 +3067,7 @@ class AgentRunMixin:
                     cwd=os.getcwd(),
                     text=True,
                     bufsize=1,
-                    env=env,
+                    env=child_env(env),
                 )
                 self._claude_process = process
                 self._claude_session_id = ""
@@ -3660,7 +3663,7 @@ class AgentRunMixin:
                 cwd=os.getcwd(),
                 text=True,
                 bufsize=1,
-                env=env,
+                env=child_env(env),
             )
 
             # Store process reference for cancellation
@@ -4415,6 +4418,7 @@ class AgentRunMixin:
         if runtime_name in self._SELF_CONTAINED_RUNTIMES:
             friendly = {
                 "codex-sdk": "Codex",
+                "muse": "Muse Code",
                 "copilot-sdk": "Copilot SDK",
                 "claude-agent-sdk": "Claude Agent SDK",
                 "antigravity-sdk": "Antigravity SDK",

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/mixins/commands_impl.py

@@ -2090,6 +2090,13 @@ class CommandImplMixin:
                 log.add_info("No subscription? Use BYOK instead: :connect byok openai <model>")
                 return
 
+        if sub == "muse":
+            from superqode.providers.connection_profiles import _muse_signed_in
+
+            if not _muse_signed_in():
+                self._show_muse_status(log)
+                return
+
         current = resolve_runtime_name()
         if sub in self._SELF_CONTAINED_RUNTIMES:
             existing = getattr(self, "_pure_mode", None)
@@ -2148,6 +2155,7 @@ class CommandImplMixin:
                     "antigravity-cli": "google",
                     "antigravity-managed": "google",
                     "devin-cli": "devin",
+                    "muse": "meta",
                 }.get(sub, "openai")
                 pure.connect(provider=provider, model="", working_directory=Path.cwd())
                 self._announce_self_contained_connection(sub, log)

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/mixins/connect.py

@@ -167,6 +167,19 @@ class ConnectMixin:
         self._history.clear()
         self._record_screen("conversation", "Agent", lambda: self._end_connection_view(log))
 
+    def _finish_successful_connection_view(self, log: ConversationLog) -> bool:
+        """Restore a conversation after setup, but dismiss the welcome on success."""
+        restored = self._end_connection_view(log)
+        if getattr(self, "_welcome_present", False) or getattr(self, "_welcome_active", False):
+            self._welcome_active = False
+            self._welcome_present = False
+            self._connection_welcome = False
+            if not any(role == "user" for role, *_ in getattr(log, "_messages", [])):
+                log.clear()
+                log.auto_scroll = True
+                self._workspace_intro_visible = True
+        return restored
+
     def _end_connection_view(self, log: ConversationLog) -> bool:
         if not isinstance(log, ConversationLog) or not log.is_mounted:
             return False
@@ -1558,7 +1571,7 @@ class ConnectMixin:
     def _begin_vendor_key_cli(self, profile, log: ConversationLog) -> None:
         """Closed key path for a harness SuperQode cannot drive over ACP.
 
-        Muse Code has no ACP server and no headless mode SuperQode consumes, so
+        The dedicated Muse API-key route currently runs outside SuperQode, so
         the key cannot be handed to a child process here. Gate on the key, then
         state plainly that the user runs the vendor CLI and it reads that key.
         """
@@ -2242,6 +2255,9 @@ class ConnectMixin:
         except Exception:  # noqa: BLE001 - connection works without mounted chrome
             pass
 
+        finish = getattr(self, "_finish_successful_connection_view", None)
+        if callable(finish):
+            finish(log)
         log.add_success(
             "Prime Agent connected through prime-agent-python-client (native Python RPC)."
         )
@@ -2271,8 +2287,10 @@ class ConnectMixin:
             if not started:
                 log.add_info("Muse Code already has a credential.")
                 self._show_muse_connect(log)
-        elif action in {"connect", "status", "doctor"}:
+        elif action == "connect":
             self._show_muse_connect(log)
+        elif action in {"status", "doctor"}:
+            self._show_muse_status(log)
         elif action in {"help", "?"}:
             log.add_info("Usage: :muse [connect|login|status|help]")
         else:
@@ -2425,14 +2443,11 @@ class ConnectMixin:
             self._show_muse_connect(log)
 
     def _show_muse_connect(self, log: ConversationLog) -> None:
-        """Report Muse Code readiness and hand the user a command to run.
+        """Connect Muse Code's native session host to the main prompt."""
+        self._runtime_cmd("muse", log)
 
-        Muse Code 0.1.0 exposes no ACP server, and SuperQode does not consume
-        its headless JSONL events yet, so this route stays honest: it reports
-        what is installed and signed in rather than pretending we can stream
-        its tool calls. The subscription billing rule still applies, because
-        Muse prefers META_API_KEY over the account login this route selects.
-        """
+    def _show_muse_status(self, log: ConversationLog) -> None:
+        """Report local credential presence; Muse validates it on the first call."""
         from superqode.providers.connection_profiles import _muse_auth_path, _muse_signed_in
         from superqode.providers.subscription_env import diverting_api_keys
 
@@ -2465,20 +2480,11 @@ class ConnectMixin:
             log.write(t)
             return
 
-        # Muse reads META_API_KEY ahead of any stored login, so a key left in
-        # the shell silently moves an account session onto per-token billing.
-        # SuperQode does not spawn Muse here, so it cannot strip the key the way
-        # subscription_child_env does for driven routes: say what will actually
-        # happen when the user runs `muse` themselves.
         if signed_in and diverting_api_keys("muse"):
-            t.append("\n  META_API_KEY is set in this environment.\n", style=THEME["warning"])
             t.append(
-                "  Muse Code prefers it over your account login, so this ", style=THEME["muted"]
+                "\n  SuperQode ignores META_API_KEY on this account route.\n", style=THEME["muted"]
             )
-            t.append("bills per token.\n", style=THEME["warning"])
-            t.append("  Unset it before running ", style=THEME["muted"])
-            t.append("muse", style=THEME["cyan"])
-            t.append(" to spend your Meta account session instead.\n", style=THEME["muted"])
+            t.append("  Direct `muse` launches may prefer that API key.\n", style=THEME["dim"])
         elif env_key:
             t.append(
                 "\n  META_API_KEY is set, so Muse Code bills per token.\n", style=THEME["warning"]
@@ -2507,16 +2513,13 @@ class ConnectMixin:
             # account without billing authenticates fine and still fails on the
             # first model call, so never imply sign-in is sufficient.
             t.append(
-                "\n  Signed in. Model calls bill to your Meta account, so a\n", style=THEME["muted"]
-            )
-            t.append(
-                "  team without billing enabled still gets refused by Meta.\n", style=THEME["muted"]
+                "\n  Saved credential detected; Muse validates it on the first call.\n",
+                style=THEME["muted"],
             )
+            t.append("  Your Meta account must have billing enabled.\n", style=THEME["muted"])
 
-        t.append(
-            "\n  SuperQode does not drive Muse Code yet. Run it directly:\n", style=THEME["muted"]
-        )
-        t.append("    muse\n", style=THEME["cyan"])
+        t.append("\n  Connect Muse Code to the SuperQode prompt:\n", style=THEME["muted"])
+        t.append("    :connect muse\n", style=THEME["cyan"])
         t.append("\n  Next:\n", style=THEME["muted"])
         t.append("    • ", style=THEME["dim"])
         t.append(":connect byok meta", style=THEME["cyan"])
@@ -2863,6 +2866,11 @@ class ConnectMixin:
                     (":runtime list", "to compare available runtime routes"),
                 ),
             },
+            "muse": {
+                "auth": "Meta account sign-in managed by Muse Code",
+                "model": "managed by Muse Code",
+                "commands": ((":muse status", "for installation and sign-in details"),),
+            },
         }
         details = connection_details.get(
             runtime_name,

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/mixins/dialogs.py

@@ -78,6 +78,9 @@ class DialogsMixin:
         # Mark that the log currently shows only the welcome, so resizes can
         # re-flow it responsively until the user starts interacting.
         self._welcome_active = True
+        # Command submission stops resize reflow, but the welcome can remain
+        # in the saved navigation view until a connection succeeds.
+        self._welcome_present = True
         # Show the first-run card until the first connection lands, and note
         # the visit for the session hint.
         self._maybe_show_onboarding(log)

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/mixins/events.py

@@ -134,6 +134,9 @@ class EventHandlerMixin:
                 pass
 
     def on_unmount(self) -> None:
+        from superqode.app.herdr import close
+
+        close(self)
         self._stop_wave_bursts()
         self._flush_draft_recovery()
 

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/mixins/feedback.py

@@ -272,7 +272,7 @@ class FeedbackMixin:
             "Model ready",
             "Model selected",
         }:
-            finish = getattr(self, "_end_connection_view", None)
+            finish = getattr(self, "_finish_successful_connection_view", None)
             if callable(finish) and log is not None:
                 finish(log)
 

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/mixins/helper_exit_lifecycle.py

@@ -26,7 +26,7 @@ class HelperExitLifecycleMixin:
             log: The conversation log widget
             context: Optional context string (e.g., "DEV.FULLSTACK", "OPENCODE")
         """
-        restored = self._end_connection_view(log)
+        restored = self._finish_successful_connection_view(log)
         self._welcome_active = False
         if not restored:
             log.clear()
@@ -55,6 +55,7 @@ class HelperExitLifecycleMixin:
 
     def _begin_conversation_transcript(self, log: ConversationLog) -> None:
         """Replace temporary connection/setup content with the first turn."""
+        self._welcome_present = False
         # A live conversation is the new navigation root. Stale connection
         # picker history must never replace its transcript via Back.
         try:

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/mixins/helper_interaction_mode.py

@@ -154,3 +154,6 @@ class HelperInteractionModeMixin:
             persist=False,
             dedupe_key=f"interaction-mode:{mode}",
         )
+        from superqode.app.herdr import sync
+
+        sync(self)

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/mixins/helper_permissions.py

@@ -53,6 +53,9 @@ class HelperPermissionsMixin:
             return
         if not pending:
             return
+        from superqode.app.herdr import sync
+
+        sync(self)
         card = Text()
         card.append("🔐 Tool approval needed\n\n", style=f"bold {THEME['warning']}")
         card.append(f"{len(pending)} pending item(s)\n", style=THEME["text"])

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/mixins/helpers.py

@@ -166,6 +166,7 @@ class HelpersMixin(
                     # must not be presented as the active harness.
                     harness = {
                         "codex-sdk": "codex",
+                        "muse": "Muse Code",
                         "copilot-sdk": "copilot",
                         "claude-agent-sdk": "claude",
                         "antigravity-sdk": "antigravity",
@@ -411,6 +412,9 @@ class HelpersMixin(
             getattr(self, "_permission_pending", False)
             or getattr(self, "_awaiting_agent_question", False)
         )
+        from superqode.app.herdr import sync
+
+        sync(self)
         self._set_composer_working_state(new, interactive=interactive)
         self._sync_navigation_controls()
         if not new:
@@ -762,6 +766,9 @@ class HelpersMixin(
             self.query_one("#status-bar", ColorfulStatusBar).active_runtime = display
         except Exception:  # noqa: BLE001
             pass
+        from superqode.app.herdr import sync
+
+        sync(self)
 
     def _sync_self_contained_status(self, runtime_name: str, *, tokens: int = 0) -> None:
         """Replace stale provider state with runtime-owned identity."""
@@ -781,6 +788,7 @@ class HelpersMixin(
                 status.active_model = ""
             status.active_harness = {
                 "codex-sdk": "codex",
+                "muse": "Muse Code",
                 "copilot-sdk": "copilot",
                 "claude-agent-sdk": "claude",
                 "antigravity-sdk": "antigravity",

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/mixins/model_catalog.py

@@ -1032,6 +1032,9 @@ class ModelCatalogMixin:
             self.query_one("#status-bar", ColorfulStatusBar).active_model = model or ""
         except Exception:  # noqa: BLE001
             pass
+        from superqode.app.herdr import sync
+
+        sync(self)
 
     def _set_acp_status(self, model: str = "") -> None:
         """Synchronize an ACP connection with the persistent top status bar."""

{superqode-2.4.36 → superqode-2.4.38}/src/superqode/app/mixins/slash_commands.py

@@ -353,6 +353,9 @@ class SlashCommandMixin:
         self._set_status_runtime("systemone")
         self._set_status_model(pure.session.model)
         pack = pure._harness_spec.systemone.pack
+        finish = getattr(self, "_finish_successful_connection_view", None)
+        if callable(finish):
+            finish(log)
         log.add_system(
             f"Connected to decision pack {pack} with {pure.session.model}. Enter state for this pack; no coding model or tool execution is involved."
         )
@@ -1911,6 +1914,10 @@ class SlashCommandMixin:
             guidance="Other sessions remain saved.",
             dedupe_key=f"session-resume:{resolved_id}",
         )
+        from superqode.app.herdr import sync
+
+        self._herdr_restore_error = ""
+        sync(self)
         return True
 
     def _handle_fork_session(self, args: str, log: ConversationLog):
@@ -1934,6 +1941,9 @@ class SlashCommandMixin:
             log=log,
             dedupe_key=f"session-fork:{fork_id}",
         )
+        from superqode.app.herdr import sync
+
+        sync(self)
 
     def _handle_compact(self, log: ConversationLog):
         """Compact or enable compaction for the active local provider session."""