Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Python agent-infrastructureai-agentai-searchautomationbilibiliclaude-codeclicursorfree-apillm-toolsmcppythonreddit-scrapertwitter-scraperweb-scraperxiaohongshuyoutube-transcript
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.pyindex 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 BossClientfrom boss_agent_cli.auth.manager import AuthManagerdiff --git a/agent_reach/runtime/manage.py b/agent_reach/runtime/manage.pyindex 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 copystate.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:returnservers.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.pyindex 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.mdindex 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.mdindex 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.pyindex 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"