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
feat: when an upstream fails, suggest running agent-reach update once
Pnantaa8db87a73b4
diff --git a/agent_reach/runtime/result.py b/agent_reach/runtime/result.pyindex 874f1571..02f66fbd 100644--- a/agent_reach/runtime/result.py+++ b/agent_reach/runtime/result.py@@ -34,7 +34,9 @@ FINAL_CODES = frozenset({NOT_FOUND, BAD_INPUT})DEFAULT_HINTS = {NEED_SETUP: "This backend is not installed. Ask the user to run `agent-reach doctor` for setup steps.",NEED_LOGIN: "Login is required or expired. Guide the user to log in themselves; never log in on their behalf.",- UPSTREAM_BROKEN: "The upstream tool failed. Tell the user this channel is unavailable right now; do not retry in a loop.",+ UPSTREAM_BROKEN: ("The upstream tool failed. Suggest the user run `agent-reach update` once (the upstream may "+ "already be fixed); if it still fails, tell them this channel is unavailable right now. "+ "Do not retry in a loop."),TIMEOUT: "No backend answered in time. Retry later, or pass a larger --timeout.",RATE_LIMITED: "Rate limited by the platform. Wait a while before retrying.",NOT_FOUND: "The requested content does not exist. Check the link or id.",diff --git a/agent_reach/skill/SKILL.md b/agent_reach/skill/SKILL.mdindex f18c77c2..a742589f 100644--- a/agent_reach/skill/SKILL.md+++ b/agent_reach/skill/SKILL.md@@ -32,7 +32,7 @@ agent-reach read <链接> # 给链接,自动认出渠道|---|---|| `NEED_SETUP` | 告诉用户 hint 里的命令(常见:`agent-reach add <渠道>`) || `NEED_LOGIN` | 让用户自己登录(`agent-reach login <渠道>`),**绝不替用户登录、不读用户浏览器的 Cookie** |-| `UPSTREAM_BROKEN` | 这个渠道暂时不可用,告诉用户,不要反复重试 |+| `UPSTREAM_BROKEN` | 这个渠道暂时不可用。先建议用户运行一次 `agent-reach update`(上游可能已经修好);还不行就告诉用户,不要反复重试 || `TIMEOUT` / `RATE_LIMITED` | 稍后再试 || `NOT_FOUND` / `BAD_INPUT` | 检查链接或参数,必要时跑 `agent-reach channels` |diff --git a/agent_reach/skill/SKILL_en.md b/agent_reach/skill/SKILL_en.mdindex 624e3e5c..fbf9eb92 100644--- a/agent_reach/skill/SKILL_en.md+++ b/agent_reach/skill/SKILL_en.md@@ -33,7 +33,7 @@ Results:|---|---|| `NEED_SETUP` | Tell the user the command in the hint (usually `agent-reach add <channel>`) || `NEED_LOGIN` | The user logs in themselves (`agent-reach login <channel>`). **Never log in for them or read their browser cookies** |-| `UPSTREAM_BROKEN` | Channel is down right now; tell the user, don't retry in a loop |+| `UPSTREAM_BROKEN` | Channel is down right now. Suggest the user run `agent-reach update` once (upstream may already be fixed); if it still fails, tell them, and don't retry in a loop || `TIMEOUT` / `RATE_LIMITED` | Retry later || `NOT_FOUND` / `BAD_INPUT` | Check the link or args; run `agent-reach channels` if needed |