forgexa-cli 1.60.0__tar.gz → 1.61.0__tar.gz

{forgexa_cli-1.60.0 → forgexa_cli-1.61.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forgexa-cli
-Version: 1.60.0
+Version: 1.61.0
 Summary: Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform
 Author-email: Jason Sun <dev.winds@gmail.com>
 License-Expression: MIT
@@ -35,7 +35,7 @@ Requires-Dist: socksio>=1.0.0; extra == "daemon"
 Command-line client and agent runtime for the [Forgexa](https://forgexa.net) platform.
 
 Communicates with the Forgexa server via REST API.
-Includes a built-in **daemon** with thirteen integrations: Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, Kimi Code, MiMo Code, Qwen Code, CodeBuddy, Qoder CLI, TraeCode CLI, ZCode, and DeepSeek Harness. Six standard candidates are automatically routed; seven require explicit selection. Harness (`deepseek-harness`) is a developer preview for personal Runtimes/Desktop, pinned to 0.2.0-rc.2 and Node 22.19+ within 22.x or 24+. It owns a managed runtime profile with read-only external credentials, without copying personal settings. Shared pools/native Windows are blocked. After exact-build live acceptance, `forgexa agent approve-live deepseek-harness` records an attestation; `forgexa check --agent deepseek-harness --quick` avoids model calls, while normal `check` runs a potentially billable minimal task. See [global/local installation and limits](../documentation/guide/agent-installation.md#deepseek-harness-developer-preview).
+Includes a built-in **daemon** with thirteen integrations: Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, Kimi Code, MiMo Code, Qwen Code, CodeBuddy, Qoder CLI, TraeCode CLI, ZCode, and DeepSeek Harness. Six standard candidates are automatically routed; seven require explicit selection. Harness (`deepseek`) is a developer preview for personal Runtimes/Desktop, pinned to 0.2.0-rc.2 and Node 22.19+ within 22.x or 24+. It owns a managed runtime profile with read-only external credentials, without copying personal settings. Shared pools/native Windows are blocked. After exact-build live acceptance, `forgexa agent approve-live deepseek` records an attestation; `forgexa check --agent deepseek --quick` avoids model calls, while normal `check` runs a potentially billable minimal task. See [global/local installation and limits](../documentation/guide/agent-installation.md#deepseek-harness-developer-preview).
 
 ## Installation
 

{forgexa_cli-1.60.0 → forgexa_cli-1.61.0}/README.md

@@ -3,7 +3,7 @@
 Command-line client and agent runtime for the [Forgexa](https://forgexa.net) platform.
 
 Communicates with the Forgexa server via REST API.
-Includes a built-in **daemon** with thirteen integrations: Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, Kimi Code, MiMo Code, Qwen Code, CodeBuddy, Qoder CLI, TraeCode CLI, ZCode, and DeepSeek Harness. Six standard candidates are automatically routed; seven require explicit selection. Harness (`deepseek-harness`) is a developer preview for personal Runtimes/Desktop, pinned to 0.2.0-rc.2 and Node 22.19+ within 22.x or 24+. It owns a managed runtime profile with read-only external credentials, without copying personal settings. Shared pools/native Windows are blocked. After exact-build live acceptance, `forgexa agent approve-live deepseek-harness` records an attestation; `forgexa check --agent deepseek-harness --quick` avoids model calls, while normal `check` runs a potentially billable minimal task. See [global/local installation and limits](../documentation/guide/agent-installation.md#deepseek-harness-developer-preview).
+Includes a built-in **daemon** with thirteen integrations: Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, Kimi Code, MiMo Code, Qwen Code, CodeBuddy, Qoder CLI, TraeCode CLI, ZCode, and DeepSeek Harness. Six standard candidates are automatically routed; seven require explicit selection. Harness (`deepseek`) is a developer preview for personal Runtimes/Desktop, pinned to 0.2.0-rc.2 and Node 22.19+ within 22.x or 24+. It owns a managed runtime profile with read-only external credentials, without copying personal settings. Shared pools/native Windows are blocked. After exact-build live acceptance, `forgexa agent approve-live deepseek` records an attestation; `forgexa check --agent deepseek --quick` avoids model calls, while normal `check` runs a potentially billable minimal task. See [global/local installation and limits](../documentation/guide/agent-installation.md#deepseek-harness-developer-preview).
 
 ## Installation
 

{forgexa_cli-1.60.0 → forgexa_cli-1.61.0}/forgexa_cli/__init__.py

@@ -1,2 +1,2 @@
 """forgexa-cli — Forgexa command-line client."""
-__version__ = "1.60.0"
+__version__ = "1.61.0"

{forgexa_cli-1.60.0 → forgexa_cli-1.61.0}/forgexa_cli/agent_core.py

@@ -531,6 +531,34 @@ def _agent_discovery_verification_issue(agent_id: str, binary: str) -> str | Non
     return agent_execution_verification_issue(agent_id, binary)
 
 
+def canonical_agent_id(agent_id: str | None) -> str | None:
+    return "deepseek" if agent_id == "deepseek-harness" else agent_id
+
+
+def canonical_agent_inventory(agents: list | None) -> list | None:
+    if not isinstance(agents, list) or not agents:
+        return agents
+    return [
+        {**entry, "agent_id": "deepseek", "reported_agent_id": "deepseek-harness"}
+        if isinstance(entry, dict) and entry.get("agent_id") == "deepseek-harness" else entry
+        for entry in agents
+    ]
+
+
+def runtime_agent_wire_id(agent_id: str | None, available_agents: list | None) -> str | None:
+    canonical = canonical_agent_id(agent_id)
+    if canonical != "deepseek":
+        return canonical
+    reported = [
+        entry.get("reported_agent_id") or entry.get("agent_id")
+        for entry in available_agents or []
+        if isinstance(entry, dict) and canonical_agent_id(entry.get("agent_id")) == canonical
+    ]
+    if "deepseek" not in reported and "deepseek-harness" in reported:
+        return "deepseek-harness"
+    return canonical
+
+
 # ── Agent Discovery ──
 
 
@@ -584,7 +612,7 @@ class AgentDiscovery:
             ),
             "upgrade_hint": "mimo upgrade",
         },
-        "deepseek-harness": {
+        "deepseek": {
             "commands": ["dsh"],
             "detect": "dsh --version",
             "invoke_modes": ["cli"],
@@ -2378,7 +2406,7 @@ def deepseek_harness_verification_issue(binary: str) -> str | None:
         pass
     return (
         "DeepSeek Harness requires live start/resume/cancel/isolation acceptance "
-        "for this installed build; then run `forgexa agent approve-live deepseek-harness`"
+        "for this installed build; then run `forgexa agent approve-live deepseek`"
     )
 
 
@@ -3106,7 +3134,8 @@ def agent_live_gate_approved(agent_id: str, env: dict[str, str] | None = None) -
 
 def agent_execution_verification_issue(agent_id: str, binary: str) -> str | None:
     """Return a fail-closed build/live-acceptance gate for local agents."""
-    if agent_id == "deepseek-harness":
+    agent_id = canonical_agent_id(agent_id)
+    if agent_id == "deepseek":
         return deepseek_harness_verification_issue(binary)
     if agent_id == "zcode":
         build_issue = zcode_build_verification_issue(binary)

{forgexa_cli-1.60.0 → forgexa_cli-1.61.0}/forgexa_cli/daemon.py

@@ -1196,7 +1196,7 @@ except (ImportError, ModuleNotFoundError):
 # DAEMON_VERSION is the protocol/logic version of the daemon code.
 # Kept in sync with pyproject.toml version via bump-version.sh.
 # CLIENT_TYPE identifies which packaging/distribution this daemon runs in.
-DAEMON_VERSION = "1.60.0"
+DAEMON_VERSION = "1.61.0"
 
 
 def _detect_client_type() -> str:
@@ -6266,7 +6266,7 @@ class ProcessManager:
             result = await self._run_mimo(
                 agent, prompt, workspace_path, timeout, task.task_id, on_chunk,
             )
-        elif agent.agent_id == "deepseek-harness":
+        elif agent_core.canonical_agent_id(agent.agent_id) == "deepseek":
             result = await self._run_deepseek_harness(
                 agent, prompt, workspace_path, timeout, task.task_id, on_chunk,
             )
@@ -6316,7 +6316,7 @@ class ProcessManager:
         result.metrics["duration_seconds"] = round(elapsed, 2)
 
         # Detect agent-level failures despite exit code 0
-        output_failure = None if agent.agent_id == "deepseek-harness" else self._detect_agent_output_failure(result, agent.agent_id)
+        output_failure = None if agent_core.canonical_agent_id(agent.agent_id) == "deepseek" else self._detect_agent_output_failure(result, agent.agent_id)
         if output_failure:
             logger.warning(
                 "Agent '%s' exited 0 but output indicates failure: %s",
@@ -12104,7 +12104,7 @@ class RuntimeDaemon:
                     "codex": "npm install -g @openai/codex",
                     "opencode": "curl -sSL https://opencode.ai/install | sh",
                     "mimo": "curl -fsSL https://mimo.xiaomi.com/install | bash",
-                    "deepseek-harness": "npm i -g @deepseek-ai/dsh@0.2.0-rc.2",
+                    "deepseek": "npm i -g @deepseek-ai/dsh@0.2.0-rc.2",
                     "qwen": "npm install -g @qwen-code/qwen-code",
                     "codebuddy": "npm install -g @tencent-ai/codebuddy-code",
                     "qoder": "curl -fsSL https://qoder.com/install | bash",
@@ -13167,13 +13167,15 @@ class RuntimeDaemon:
         self, current_agent_id: str, fallback_chain: list[str] | None, tried: set[str]
     ) -> DiscoveredAgent | None:
         """Find the next untried agent from fallback chain or available agents."""
+        tried = {agent_core.canonical_agent_id(agent_id) for agent_id in tried}
         # 1. Try fallback chain
         if fallback_chain:
             for fallback_id in fallback_chain:
+                fallback_id = agent_core.canonical_agent_id(fallback_id)
                 if fallback_id in tried:
                     continue
                 for agent in self.agents:
-                    if agent.agent_id == fallback_id:
+                    if agent_core.canonical_agent_id(agent.agent_id) == fallback_id:
                         return agent
 
         # 2. Try any available agent not yet tried (prefer opencode > copilot > gemini > claude)
@@ -13189,8 +13191,8 @@ class RuntimeDaemon:
         # become implicit catch-alls because their execution profiles are
         # tightly managed.
         for agent in self.agents:
-            if agent.agent_id not in tried and agent.agent_id not in {
-                "mimo", "qwen", "codebuddy", "qoder", "trae", "zcode", "deepseek-harness",
+            if agent_core.canonical_agent_id(agent.agent_id) not in tried and agent_core.canonical_agent_id(agent.agent_id) not in {
+                "mimo", "qwen", "codebuddy", "qoder", "trae", "zcode", "deepseek",
             }:
                 return agent
 
@@ -13208,18 +13210,20 @@ class RuntimeDaemon:
         custom identifier).  This prevents silent substitution when the user explicitly
         selected an agent that is just not installed locally.
         """
+        agent_type = agent_core.canonical_agent_id(agent_type)
         # 1. Exact match
         for agent in self.agents:
-            if agent.agent_id == agent_type:
+            if agent_core.canonical_agent_id(agent.agent_id) == agent_type:
                 return agent
 
         # 2. Try fallback chain from policy
         if fallback_chain:
             for fallback_id in fallback_chain:
+                fallback_id = agent_core.canonical_agent_id(fallback_id)
                 if fallback_id == agent_type:
                     continue
                 for agent in self.agents:
-                    if agent.agent_id == fallback_id:
+                    if agent_core.canonical_agent_id(agent.agent_id) == fallback_id:
                         logger.info("Using fallback agent '%s' (requested '%s')", fallback_id, agent_type)
                         return agent
 
@@ -13239,8 +13243,8 @@ class RuntimeDaemon:
         return next(
             (
                 agent for agent in self.agents
-                if agent.agent_id not in {
-                    "mimo", "qwen", "codebuddy", "qoder", "trae", "zcode", "deepseek-harness",
+                if agent_core.canonical_agent_id(agent.agent_id) not in {
+                    "mimo", "qwen", "codebuddy", "qoder", "trae", "zcode", "deepseek",
                 }
             ),
             None,
@@ -14624,7 +14628,7 @@ class RuntimeDaemon:
             # string so _select_agent falls through to its "any available L3
             # agent" logic instead of hard-failing on the 'claude' default.
             _AGENT_ALIASES = {"claude": "claude", "kimi": "kimi"}
-            agent_type = _AGENT_ALIASES.get(agent_override or "", agent_override or "")
+            agent_type = agent_core.canonical_agent_id(_AGENT_ALIASES.get(agent_override or "", agent_override or ""))
             agent = self._select_agent(agent_type, [])
             if not agent:
                 _INSTALL_HINTS = {
@@ -14632,7 +14636,7 @@ class RuntimeDaemon:
                     "codex": "npm install -g @openai/codex",
                     "opencode": "curl -sSL https://opencode.ai/install | sh",
                     "mimo": "curl -fsSL https://mimo.xiaomi.com/install | bash",
-                    "deepseek-harness": "npm i -g @deepseek-ai/dsh@0.2.0-rc.2",
+                    "deepseek": "npm i -g @deepseek-ai/dsh@0.2.0-rc.2",
                     "qwen": "npm install -g @qwen-code/qwen-code",
                     "codebuddy": "npm install -g @tencent-ai/codebuddy-code",
                     "qoder": "curl -fsSL https://qoder.com/install | bash",

{forgexa_cli-1.60.0 → forgexa_cli-1.61.0}/forgexa_cli/main.py

@@ -3018,8 +3018,9 @@ def cmd_check(args: argparse.Namespace) -> None:
 
     os.environ.setdefault("DAEMON_NO_CONSOLE_LOG", "1")
     from forgexa_cli.daemon import AgentDiscovery
+    from forgexa_cli.agent_core import canonical_agent_id
 
-    only_agent = getattr(args, "agent", None)
+    only_agent = canonical_agent_id(getattr(args, "agent", None))
     quick = bool(getattr(args, "quick", False))
     environment_requested = bool(getattr(args, "environment", False))
     timeout = getattr(args, "timeout", None) or 90
@@ -3686,8 +3687,8 @@ def cmd_agent_approve_live(args: argparse.Namespace) -> None:
 
     from . import agent_core
 
-    agent_id = args.agent_id.strip().lower()
-    if agent_id == "deepseek-harness":
+    agent_id = agent_core.canonical_agent_id(args.agent_id.strip().lower())
+    if agent_id == "deepseek":
         binary = getattr(args, "binary", None) or os.environ.get("FACTORY_DEEPSEEK_HARNESS_PATH") or shutil.which("dsh")
         if not binary:
             print("error: dsh not found; install @deepseek-ai/dsh@0.2.0-rc.2 globally", file=sys.stderr)
@@ -3976,7 +3977,7 @@ def main() -> None:
     )
     agent_approve_live_p.add_argument(
         "agent_id", metavar="AGENT_ID",
-        help="Gated agent id (e.g. trae, zcode, deepseek-harness)",
+        help="Gated agent id (e.g. trae, zcode, deepseek; legacy deepseek-harness accepted)",
     )
     agent_approve_live_p.add_argument("--binary", default=None, metavar="PATH", help="Installed Harness binary for build-scoped acceptance")
 

{forgexa_cli-1.60.0 → forgexa_cli-1.61.0}/forgexa_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forgexa-cli
-Version: 1.60.0
+Version: 1.61.0
 Summary: Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform
 Author-email: Jason Sun <dev.winds@gmail.com>
 License-Expression: MIT
@@ -35,7 +35,7 @@ Requires-Dist: socksio>=1.0.0; extra == "daemon"
 Command-line client and agent runtime for the [Forgexa](https://forgexa.net) platform.
 
 Communicates with the Forgexa server via REST API.
-Includes a built-in **daemon** with thirteen integrations: Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, Kimi Code, MiMo Code, Qwen Code, CodeBuddy, Qoder CLI, TraeCode CLI, ZCode, and DeepSeek Harness. Six standard candidates are automatically routed; seven require explicit selection. Harness (`deepseek-harness`) is a developer preview for personal Runtimes/Desktop, pinned to 0.2.0-rc.2 and Node 22.19+ within 22.x or 24+. It owns a managed runtime profile with read-only external credentials, without copying personal settings. Shared pools/native Windows are blocked. After exact-build live acceptance, `forgexa agent approve-live deepseek-harness` records an attestation; `forgexa check --agent deepseek-harness --quick` avoids model calls, while normal `check` runs a potentially billable minimal task. See [global/local installation and limits](../documentation/guide/agent-installation.md#deepseek-harness-developer-preview).
+Includes a built-in **daemon** with thirteen integrations: Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, Kimi Code, MiMo Code, Qwen Code, CodeBuddy, Qoder CLI, TraeCode CLI, ZCode, and DeepSeek Harness. Six standard candidates are automatically routed; seven require explicit selection. Harness (`deepseek`) is a developer preview for personal Runtimes/Desktop, pinned to 0.2.0-rc.2 and Node 22.19+ within 22.x or 24+. It owns a managed runtime profile with read-only external credentials, without copying personal settings. Shared pools/native Windows are blocked. After exact-build live acceptance, `forgexa agent approve-live deepseek` records an attestation; `forgexa check --agent deepseek --quick` avoids model calls, while normal `check` runs a potentially billable minimal task. See [global/local installation and limits](../documentation/guide/agent-installation.md#deepseek-harness-developer-preview).
 
 ## Installation
 

{forgexa_cli-1.60.0 → forgexa_cli-1.61.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "forgexa-cli"
-version = "1.60.0"
+version = "1.61.0"
 description = "Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform"
 requires-python = ">=3.9"
 license = "MIT"

{forgexa_cli-1.60.0 → forgexa_cli-1.61.0}/tests/test_check_command.py

@@ -30,7 +30,8 @@ def _agent(agent_id: str, version: str = "1.0.0") -> daemon.DiscoveredAgent:
     )
 
 
-def test_deepseek_harness_live_approval_is_build_scoped(tmp_path, monkeypatch, capsys):
+@pytest.mark.parametrize("agent_id", ["deepseek", "deepseek-harness"])
+def test_deepseek_harness_live_approval_is_build_scoped(tmp_path, monkeypatch, capsys, agent_id):
     from forgexa_cli import agent_core
 
     approval = tmp_path / "build-approved.json"
@@ -38,12 +39,26 @@ def test_deepseek_harness_live_approval_is_build_scoped(tmp_path, monkeypatch, c
     monkeypatch.setattr(agent_core, "DEEPSEEK_HARNESS_APPROVAL_FILE", approval)
     monkeypatch.setattr(agent_core, "AGENT_LIVE_VERIFIED_FILE", old_approval)
     monkeypatch.setattr(agent_core, "deepseek_harness_build_info", lambda binary: {"fingerprint": "test-build", "version": "0.2.0-rc.2", "node_version": "25.2.1"})
-    main.cmd_agent_approve_live(SimpleNamespace(agent_id="deepseek-harness", binary="/fake/dsh"))
+    main.cmd_agent_approve_live(SimpleNamespace(agent_id=agent_id, binary="/fake/dsh"))
     assert json.loads(approval.read_text())["builds"] == ["test-build"]
     assert not old_approval.exists()
     assert "attestation" in capsys.readouterr().out
 
 
+@pytest.mark.parametrize("agent_id", ["deepseek", "deepseek-harness"])
+def test_deepseek_harness_quick_check_accepts_legacy_id(monkeypatch, capsys, agent_id):
+    monkeypatch.setattr(daemon.AgentDiscovery, "AGENT_REGISTRY", {"deepseek": {"commands": ["dsh"], "detect": "dsh --version"}})
+    monkeypatch.setattr(daemon.AgentDiscovery, "discover", AsyncMock(return_value=[_agent("deepseek", "0.2.0-rc.2")]))
+    execute = AsyncMock()
+    monkeypatch.setattr(daemon.ProcessManager, "run_agent", execute)
+    main.cmd_check(SimpleNamespace(agent=agent_id, quick=True, timeout=90))
+    output = capsys.readouterr().out
+    assert "deepseek" in output and "v0.2.0-rc.2" in output
+    assert "1/1 agent(s) available" in output
+    assert "deepseek-harness" not in output
+    execute.assert_not_called()
+
+
 def test_check_quick_reports_installed_and_missing_agents(
     monkeypatch: pytest.MonkeyPatch, capsys: pytest.CaptureFixture[str],
 ) -> None: