robotrunk.com

get_recall_watch

Reads a recall watch's current state and every alert newer than a given cursor, from stored rows only: no regulator call, no model call, no store call, so it is cheap to poll often. Use the watch_token watch_recalls returned when the watch started. First call: since null. Then pass the next_since value each answer returns to read only new alerts. Error recovery: watch_not_found means the token is wrong or the watch is stopped and past its term, so there is nothing to recover; rate_limited means wait the seconds stated and poll again; watch_failed (or any other unexpected error): retry once, then call submit_feedback. Next: stop_recall_watch when the person asks to stop. Full guide: get_tool_guide or /agent/tools.json#get_recall_watch Example call: {"watch_token":"rwt_exampletokenvaluehere00000000000000000000000"}

Page: /

Input schema

{
  "type": "object",
  "properties": {
    "watch_token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The watch_token watch_recalls returned when the watch started."
    },
    "since": {
      "type": [
        "number",
        "null"
      ],
      "description": "The next_since cursor from a previous get_recall_watch answer, or null to read every alert from the start."
    },
    "shopping_session_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
      "description": "Optional server-issued shopping session correlation ID. It is not purchase authority."
    }
  },
  "required": [
    "watch_token"
  ],
  "additionalProperties": false
}