hansjone/oclaw
1
0
Fork 0
mirror of https://github.com/hansjone/oclaw.git synced 2026-10-09 04:40:45 +08:00
Code Issues Projects Releases Packages Wiki Activity Actions

Productize scheduled success delivery, close WA pending, and clarify SQL scope grants.

Browse source 
Wrap successful scheduled jobs with a short WA header (+ attachment count), expire stale access pending and DM requesters on admin approve/deny, and add concrete next_steps for insufficient_scope:sql:query.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
oliver 2026-08-10 23:52:41 +08:00
parent dff8901ae3
commit 4898adf7d0
10 changed files with 334 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

26
runtime/tools/tool_error_hints.py
View file

@ -88,16 +88,38 @@ def enrich_mcp_scope_error(result: dict[str, Any]) -> dict[str, Any]:
]
out["user_facing_hint"] = (
"SQL query is not enabled for this bot token. "
"I will use alarm aggregate/report tools instead, or an admin can grant sql:query."
"I will use alarm aggregate/report tools instead. "
"To enable SQL: ask a WhatsApp admin → Admin UI → netx MCP token scopes → grant sql:query."
)
out["next_steps"] = [
"Use aggregateUmeAlarms / queryUmeAlarmsRaw / ume_alarm_xlsx_report instead of sqlQueryUme.",
"Ask a WhatsApp admin to open Admin → MCP / netx token and grant scope sql:query.",
"Do not retry sqlQueryUme until the scope is granted.",
]
out["admin_action"] = {
"required_scope": "sql:query",
"where": "Admin UI → MCP server / netx API token scopes",
"ask": "WhatsApp access admin (whitelist contact with list_type=admin)",
}
else:
out["hint"] = (
f"Current netx token lacks scope {scope or '(unknown)'}. "
"Do not retry the same tool; ask an admin to grant it, or use tools that do not need this scope."
)
out["user_facing_hint"] = (
f"Permission missing ({scope or 'scope'}). An admin needs to grant this on the netx API token."
f"Permission missing ({scope or 'scope'}). "
"Ask a WhatsApp admin to grant this scope on the netx API token "
"(Admin → MCP / netx token scopes)."
)
out["next_steps"] = [
f"Ask a WhatsApp admin to grant scope {scope or '(unknown)'} on the netx MCP token.",
"Retry only after the scope is granted; do not blind-retry this tool.",
]
out["admin_action"] = {
"required_scope": scope or "",
"where": "Admin UI → MCP server / netx API token scopes",
"ask": "WhatsApp access admin (whitelist contact with list_type=admin)",
}
out["failure_class"] = "auth"
out["retry_forbidden"] = True
return out