superqode 2.4.35__tar.gz → 2.4.37__tar.gz

{superqode-2.4.35 → superqode-2.4.37}/CHANGELOG.md

@@ -7,6 +7,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+
+- Show each coding agent once in the Harness Hub, omitting duplicate ACP
+  listings when a primary agent connection exists. Remove the ACP suffix from
+  remaining Hub names while preserving explicit ACP connections.
+- Label local Harness Hub availability as Available and Setup required instead
+  of Ready and Needs setup. Explain that availability checks run locally and
+  authentication and connectivity are verified when connecting. Keep Needs a
+  model for built-in harnesses awaiting model selection.
+- Refresh the publication-safe Hub catalog and document the simplified agent
+  listings and local availability labels.
+
 ## [2.4.35] - 2026-09-30
 
 ### Fixed

{superqode-2.4.35 → superqode-2.4.37}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superqode
-Version: 2.4.35
+Version: 2.4.37
 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.35 → superqode-2.4.37}/pyproject.toml

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

{superqode-2.4.35 → superqode-2.4.37}/src/superqode/__init__.py

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

{superqode-2.4.35 → superqode-2.4.37}/src/superqode/app/mixins/agent_run.py

@@ -4415,6 +4415,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.35 → superqode-2.4.37}/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.35 → superqode-2.4.37}/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.35 → superqode-2.4.37}/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.35 → superqode-2.4.37}/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.35 → superqode-2.4.37}/src/superqode/app/mixins/harness_hub.py

@@ -11,6 +11,7 @@ from superqode.app.widgets import ConversationLog
 from superqode.harness.hub import (
     REFERENCE_ONLY_KINDS,
     hub_ecosystem_picker_items,
+    hub_picker_items,
     hub_record,
     readiness_label,
 )
@@ -135,7 +136,7 @@ class HarnessHubMixin:
                 replace(item, display_name=f"SuperQode {item.display_name}")
                 if item.group == "SuperQode harnesses"
                 else item
-                for item in items
+                for item in hub_picker_items(items)
             ),
             key=lambda item: item.display_name.casefold(),
         )
@@ -229,7 +230,7 @@ class HarnessHubMixin:
         log: ConversationLog,
     ) -> None:
         record = hub_record(item, include_local_paths=True)
-        status = readiness_label(record.readiness)
+        status = readiness_label(record.readiness, local=True)
         details = [
             item.description,
             f"Status: {status}",

{superqode-2.4.35 → superqode-2.4.37}/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.35 → superqode-2.4.37}/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",
@@ -781,6 +782,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.35 → superqode-2.4.37}/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."
         )

{superqode-2.4.35 → superqode-2.4.37}/src/superqode/app_main.py

@@ -1231,6 +1231,7 @@ class SuperQodeApp(
             "antigravity-cli",
             "antigravity-managed",
             "devin-cli",
+            "muse",
             # Subscription CLI runtimes: the vendor login supplies both auth and
             # model, so they must auto-connect like the other self-contained
             # runtimes. Without this, :connect copilot reported "Already on

{superqode-2.4.35 → superqode-2.4.37}/src/superqode/harness/hub.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from dataclasses import asdict, dataclass
+from dataclasses import asdict, dataclass, replace
 from datetime import UTC, datetime
 from pathlib import Path
 from typing import Any, Iterable
@@ -95,8 +95,13 @@ def language_label(language: str, confidence: str = "") -> str:
     return f"{name} (inferred)" if confidence == "inferred" else name
 
 
-def readiness_label(readiness: str) -> str:
-    """Return the public label for a readiness value."""
+def readiness_label(readiness: str, *, local: bool = False) -> str:
+    """Return a readiness label, with availability wording for local TUI checks."""
+    if local:
+        if readiness == "ready":
+            return "Available"
+        if readiness == "setup-required":
+            return "Setup required"
     return READINESS_LABELS.get(readiness, str(readiness).replace("-", " ").capitalize())
 
 
@@ -1846,6 +1851,28 @@ def hub_ecosystem_picker_items() -> list[HarnessPickerItem]:
     ]
 
 
+def hub_picker_items(items: Iterable[HarnessPickerItem]) -> list[HarnessPickerItem]:
+    """Show agents once in the Hub without changing explicit ACP routes."""
+    inventory = list(items)
+    primary_agents = set()
+    for item in inventory:
+        if item.kind == "connection":
+            primary_agents.add(item.id.casefold())
+            acp_agent = getattr(item.target, "acp_agent", None)
+            if acp_agent:
+                primary_agents.add(acp_agent.casefold())
+    if "deepagents-code" in primary_agents:
+        primary_agents.add("deepagents")
+
+    return [
+        replace(item, display_name=item.display_name.removesuffix(" (ACP)"))
+        if item.kind == "acp"
+        else item
+        for item in inventory
+        if item.kind != "acp" or item.id.removeprefix("acp:").casefold() not in primary_agents
+    ]
+
+
 def build_hub_index(
     root: str | Path = ".",
     *,
@@ -1865,6 +1892,7 @@ def build_hub_index(
             include_live_registry=not public,
         )
     )
+    inventory = hub_picker_items(inventory)
     if public:
         inventory = [item for item in inventory if item.group != "Project harnesses"]
     records = [

{superqode-2.4.35 → superqode-2.4.37}/src/superqode/providers/connection_profiles.py

@@ -382,10 +382,14 @@ def _prime_agent_present() -> bool:
 
 
 def _muse_cli_ready() -> bool:
-    """Muse Code is installed and holds a credential it can actually use."""
+    """Muse account route has an installed CLI and a stored credential.
+
+    This is a local setup hint; Muse validates the login on model calls.
+    Environment API keys do not satisfy this account route.
+    """
     if shutil.which("muse") is None:
         return False
-    return _muse_signed_in() or _env_key_set("META_API_KEY")
+    return _muse_signed_in()
 
 
 def _muse_product_present() -> bool:
@@ -830,7 +834,9 @@ _AGENT_PROFILES: List[ConnectionProfile] = [
         transport="CLI",
         label="Muse Code",
         description="Use Meta's Muse Code agent with your Meta account sign-in",
-        connector="external-cli",
+        connector="runtime",
+        runtime="muse",
+        self_contained=True,
         menu=CONNECT_MENU_VENDORS,
         detect=_muse_cli_ready,
         product_detect=_muse_product_present,

{superqode-2.4.35 → superqode-2.4.37}/src/superqode/providers/harness_catalog.py

@@ -662,7 +662,7 @@ HARNESS_CATALOG: Tuple[HarnessCatalogEntry, ...] = (
         label="Muse Code",
         description="Meta's Muse Code agent with your Meta account sign-in.",
         openness="closed",
-        auth=_plan_auth("muse", connector="external-cli"),
+        auth=_plan_auth("muse", connector="runtime"),
         hub_id="muse",
         vendor_owned=True,
         wired=True,
@@ -683,8 +683,8 @@ HARNESS_CATALOG: Tuple[HarnessCatalogEntry, ...] = (
         hub_id="muse",
         readiness="setup-required",
         support_note=(
-            "Muse Code has no ACP server or headless mode SuperQode can drive, "
-            "so run `muse` yourself. It prefers META_API_KEY over a stored "
+            "This API-key route currently runs outside SuperQode: run `muse` "
+            "directly. It prefers META_API_KEY over a stored "
             "`muse login` session, so the key is what gets billed."
         ),
         vendor_owned=True,

{superqode-2.4.35 → superqode-2.4.37}/src/superqode/pure_mode.py

@@ -460,6 +460,7 @@ class PureMode:
             "copilot-sdk",
             "claude-agent-sdk",
             "antigravity-sdk",
+            "muse",
         ):
             runtime_kwargs["approval_callback"] = self.on_permission_request
         if self.runtime_name == "builtin":