Skip to content

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

fix: clean retired owned transport and avoid Git prerequisite for BOSS

LohseZSai63c272a02e27
diff --git a/agent_reach/backends/boss_native.py b/agent_reach/backends/boss_native.py
index 6fd0b5db..56e1cf39 100644
--- a/agent_reach/backends/boss_native.py
+++ b/agent_reach/backends/boss_native.py
@@ -11,7 +11,8 @@ def main():
spec = json.loads(sys.argv[1])
dist = distribution('boss-agent-cli')
source = json.loads(dist.read_text('direct_url.json') or '{}')
- if source.get('vcs_info', {}).get('commit_id') != COMMIT:
+ archive = f'https://github.com/can4hou6joeng4/boss-agent-cli/archive/{COMMIT}.zip'
+ if source.get('vcs_info', {}).get('commit_id') != COMMIT and source.get('url') != archive:
return {'ok': False, 'error': {'code': 'NEED_SETUP', 'message': 'Boss dependency differs from the verified commit; run agent-reach add boss to install the pinned private tool'}}
from boss_agent_cli.api.client import BossClient
from boss_agent_cli.auth.manager import AuthManager
diff --git a/agent_reach/runtime/manage.py b/agent_reach/runtime/manage.py
index d9972676..53e00b61 100644
--- a/agent_reach/runtime/manage.py
+++ b/agent_reach/runtime/manage.py
@@ -629,6 +629,8 @@ def setup() -> dict:
if not state.exists():
state.save(state.load())
_cleanup_retired_mcp()
+ if state.load()["tools"].get("mcporter", {}).get("owner") == tools.OURS:
+ tools.remove_private("mcporter") # retired LinkedIn MCP transport, only our private copy
state.mutate(lambda saved: (saved.pop("reuse_sources", None), saved.pop("ask_pending", None)))
skill = place_skill()
data = state.load()
@@ -670,7 +672,11 @@ def setup() -> dict:
def _cleanup_retired_mcp() -> None:
"""Remove only the unchanged Cursor entry recorded as ours by an older build."""
- from agent_reach.utils.paths import atomic_write_private_text, read_small_text_no_follow
+ from agent_reach.utils.paths import (
+ PrivatePathError,
+ atomic_write_private_text,
+ read_small_text_no_follow,
+ )
old = state.load().get("mcp", {}).get("cursor", {})
path = home_dir() / ".cursor" / "mcp.json"
if old.get("path") != str(path) or not path.is_file():
@@ -684,7 +690,7 @@ def _cleanup_retired_mcp() -> None:
return
servers.pop("agent-reach")
atomic_write_private_text(path, json.dumps(data, ensure_ascii=False, indent=2))
- except (OSError, ValueError):
+ except (OSError, ValueError, PrivatePathError):
return # Preserve an unreadable or externally changed config.
state.mutate(lambda saved: saved.pop("mcp", None))
diff --git a/agent_reach/runtime/tools.py b/agent_reach/runtime/tools.py
index 6b049015..d621315f 100644
--- a/agent_reach/runtime/tools.py
+++ b/agent_reach/runtime/tools.py
@@ -57,7 +57,7 @@ TOOLS: Dict[str, Tool] = {
Tool("bili-cli", "pip", "bilibili-cli", ("bili",), tested="0.6.2"),
Tool(
"boss-agent-cli", "pip",
- "boss-agent-cli @ git+https://github.com/can4hou6joeng4/boss-agent-cli.git@4c991b77086a203173bf08a4cb64a23af6514fe6",
+ "boss-agent-cli @ https://github.com/can4hou6joeng4/boss-agent-cli/archive/4c991b77086a203173bf08a4cb64a23af6514fe6.zip",
("boss",),
),
Tool("opencli", "npm", "@jackwener/opencli", ("opencli",), singleton=True, floor="1.8.7", exclude=("1.8.8",), tested="1.8.7", needs=("node",)),
diff --git a/docs/plans/2026-10-20-shared-cloak-browser.md b/docs/plans/2026-10-20-shared-cloak-browser.md
index 7b1b5d88..7872ac24 100644
--- a/docs/plans/2026-10-20-shared-cloak-browser.md
+++ b/docs/plans/2026-10-20-shared-cloak-browser.md
@@ -16,4 +16,4 @@
## Live acceptance record
-384 local core tests, Ruff and Mypy passed. Live Xiaohongshu search/read/comments, explicit session import, scoped cleanup and shortened idle/reopen tests passed. BOSS returned PLATFORM_BLOCKED and requires manual verification. Details: docs/validation/shared-browser-20261020.md. Browser creation and test imports are authorized by the user's current implementation request. Do not mark a platform authenticated merely because cookies were copied; verify with the upstream channel action. Do not send messages, submit applications, post comments, or otherwise write to platforms.
+387 local core tests, Ruff and Mypy passed. Live Xiaohongshu search/read/comments, explicit session import, scoped cleanup and shortened idle/reopen tests passed. BOSS returned PLATFORM_BLOCKED and requires manual verification. Details: docs/validation/shared-browser-20261020.md. Browser creation and test imports are authorized by the user's current implementation request. Do not mark a platform authenticated merely because cookies were copied; verify with the upstream channel action. Do not send messages, submit applications, post comments, or otherwise write to platforms.
diff --git a/docs/validation/shared-browser-20261020.md b/docs/validation/shared-browser-20261020.md
index b38c5fd1..d065879d 100644
--- a/docs/validation/shared-browser-20261020.md
+++ b/docs/validation/shared-browser-20261020.md
@@ -37,6 +37,7 @@ Official 1.8.8 failed the Xiaohongshu default-filter path with `UPSTREAM_BROKEN`
- Cloak's private interpreter does not import the main program's Config/PyYAML. The launcher passes only the necessary runtime settings.
- The browser proxy bypasses localhost so the OpenCLI extension can reach its local Bridge daemon.
- A previous Reach-owned Chrome profile crashed Cloak locally. It is preserved as a private `profile-before-cloak-*` backup; the shared profile restores Reach's saved cookies. No personal Chrome profile is moved.
+- Setup removes only the obsolete private MCP transport installed by Reach; user-owned copies remain. BOSS installs its verified upstream commit from an archive, avoiding an extra Git prerequisite; archive-only installation and provenance were checked in a clean temporary environment.
- The watcher saves session cookies every two seconds and before normal shutdown. Login persistence no longer depends on the user closing the window.
- Closing one site tab does not terminate the watcher. A shared action lock serializes browser channels; a session lock prevents stale saves racing logout.
- Old Reach-owned per-site snapshots merge once, only filling missing cookies. Logout/removal cannot automatically restore those old credentials.
@@ -44,8 +45,8 @@ Official 1.8.8 failed the Xiaohongshu default-filter path with `UPSTREAM_BROKEN`
## Validation
-- Core tests: **384 passed** on local macOS.
-- The curated source checkout also passed all 384 tests, with local API/research files excluded.
+- Core tests: **387 passed** on local macOS.
+- The curated source checkout also passed all 387 tests, with local API/research files excluded.
- Ruff: passed. Mypy: passed, 46 source files.
- Wheel gate passed: 57 entries, about 148 KiB; Skill references and Xiaoyuzhou present, removed modules and browser binaries absent. Clean-venv smoke test confirmed 14 channels and rejection of the four retired command entries.
- Installed the candidate wheel locally, ran setup successfully (5/5 defaults), refreshed the installed Skill and confirmed no retired Reach MCP configuration/process. An actual Xiaohongshu search through the installed wheel returned one item in 7.48 seconds.
diff --git a/tests/test_manage.py b/tests/test_manage.py
index a8c7a21b..55f8f0bf 100644
--- a/tests/test_manage.py
+++ b/tests/test_manage.py
@@ -176,7 +176,8 @@ def test_old_record_without_version_gets_one_without_reinstall(env):
def test_install_spec_uses_tested_versions_or_floor_and_exclude():
assert tools.install_spec(tools.TOOLS["bili-cli"]) == "bilibili-cli==0.6.2"
- assert tools.install_spec(tools.TOOLS["boss-agent-cli"]).endswith("@4c991b77086a203173bf08a4cb64a23af6514fe6")
+ spec = tools.install_spec(tools.TOOLS["boss-agent-cli"])
+ assert "git+" not in spec and spec.endswith("/4c991b77086a203173bf08a4cb64a23af6514fe6.zip")
assert tools.install_spec(tools.Tool("y", "pip", "pkg", ("y",), floor="1.0", exclude=("1.5",))) == "pkg>=1.0,!=1.5"
npm = tools.Tool("x", "npm", "pkg", ("x",), floor="1.0.0", exclude=("1.2.0", "1.1.0"))
assert tools.install_spec(npm) == "pkg@>=1.0.0 <1.1.0 || >1.1.0 <1.2.0 || >1.2.0"
@@ -706,3 +707,26 @@ def test_setup_preserves_unowned_or_changed_mcp_configuration(env):
path.write_text(original)
manage.setup()
assert path.read_text()==original
+
+
[email protected]("owner", [tools.OURS, "user"])
+def test_setup_prunes_only_our_retired_mcp_transport(env, owner):
+ folder = tools.tool_dir("mcporter")
+ folder.mkdir(parents=True)
+ (folder / "keep-or-remove").write_text("fixture")
+ state.mutate(lambda data: data["tools"].update(mcporter={"owner": owner}))
+ manage.setup()
+ assert folder.exists() == (owner != tools.OURS)
+
+
+def test_retired_mcp_cleanup_preserves_changed_private_path(env, monkeypatch):
+ from agent_reach.utils import paths
+ path = home_dir() / ".cursor/mcp.json"
+ path.parent.mkdir()
+ path.write_text("unchanged")
+ state.mutate(lambda data: data.update(mcp={"cursor": {"path": str(path), "entry": {}}}))
+ def changed(*args, **kwargs):
+ raise paths.PrivatePathError("externally changed path")
+ monkeypatch.setattr(paths, "read_small_text_no_follow", changed)
+ manage._cleanup_retired_mcp()
+ assert path.read_text() == "unchanged"