switchroom 0.19.48 → 0.20.0

package/skills/switchroom-architecture/SKILL.md

@@ -59,3 +59,8 @@ Switchroom is a multi-agent orchestrator built on Claude Code. It manages multip
 - [cascade.md](cascade.md) — three-layer config cascade semantics
 - [sub-agents.md](sub-agents.md) — delegation patterns and model routing
 - [telegram.md](telegram.md) — enhanced Telegram plugin features
+
+**Why it's built this way** lives in the repo's `reference/` directory — the
+design contract (`reference/README.md` is the map: vision, principles,
+invariants, product spec, job specs, RFCs). For "why does switchroom do X"
+questions, that is the source of truth; `docs/` is usage/operation only.

package/skills/switchroom-cli/SKILL.md

@@ -290,7 +290,7 @@ config-plus-recreate operation with three known traps. **Follow the runbook:
 
 ## Telegram plugin reference — "what MCP tools", "how does reply work"
 
-The `switchroom-telegram` plugin is an enhanced fork of the official Telegram MCP plugin and is the default for all switchroom agents. It exposes **9 MCP tools** (all prefixed `mcp__switchroom-telegram__`):
+The `switchroom-telegram` plugin is an enhanced fork of the official Telegram MCP plugin and is the default for all switchroom agents. It exposes **20+ MCP tools** (all prefixed `mcp__switchroom-telegram__`; the authoritative list is the tool declarations in `telegram-plugin/bridge/bridge.ts`). The core messaging set:
 
 | Tool | Purpose |
 |---|---|

package/telegram-plugin/dist/bridge/bridge.js

@@ -23121,12 +23121,12 @@ function classifyClaudeError(raw) {
   try {
     return classifyInner(raw);
   } catch {
-    return "unknown-4xx";
+    return "unknown-5xx";
   }
 }
 function classifyInner(raw) {
   if (raw == null)
-    return "unknown-4xx";
+    return "unknown-5xx";
   const obj = typeof raw === "object" ? raw : {};
   const errorType = extractString(obj, "error_type") ?? extractString(obj, "type") ?? extractString(getNestedObj(obj, "error"), "type") ?? "";
   const errorCode = extractString(obj, "code") ?? extractString(getNestedObj(obj, "error"), "code") ?? "";
@@ -23171,13 +23171,16 @@ ${message}`;
   if (errorType === "agent-restarted-unexpectedly" || errorCode === "agent-restarted-unexpectedly") {
     return "agent-restarted-unexpectedly";
   }
+  if ((status == null || status >= 500) && (errorType === "server_error" || errorCode === "server_error" || sdkCode === "server_error" || errorType === "api_error" || errorCode === "api_error" || sdkCode === "api_error")) {
+    return "transport-transient";
+  }
   if (status != null) {
     if (status >= 400 && status < 500)
       return "unknown-4xx";
     if (status >= 500 && status < 600)
       return "unknown-5xx";
   }
-  return "unknown-4xx";
+  return "unknown-5xx";
 }
 function extractString(obj, key) {
   const v = obj[key];
@@ -23708,7 +23711,7 @@ ${errStr}`) ? "rate-limited" : "quota-exhausted" : classifyClaudeError({ type: e
   const raw = embeddedError ?? obj;
   const kind = classifyClaudeError(embeddedError ?? obj);
   const detail = extractDetailMessage(embeddedError) ?? extractDetailMessage(obj) ?? String(type ?? "");
-  const transient = kind === "rate-limited";
+  const transient = kind === "rate-limited" || kind === "transport-transient";
   const retry = extractRetryState(obj);
   const terminal = !transient ? true : retry.retryAttempt != null && retry.maxRetries != null ? retry.retryAttempt >= retry.maxRetries : isErrorLine;
   return { kind, raw, detail, transient, terminal };