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.

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.py
index 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.md
index 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.md
index 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 |