Error handling

ReyGridError
├── ReyGridApiError            // any 4xx / 5xx
│   ├── ReyGridAuthError       // 401
│   ├── ReyGridValidationError // 400
│   ├── ReyGridNotFoundError   // 404
│   ├── ReyGridConflictError   // 409
│   ├── ReyGridPermissionError // 403 (plan limit, model not on plan, restricted key)
│   └── ReyGridRateLimitError  // 429 (rate limited, key quota used up)
├── ReyGridNetworkError        // fetch failure or timeout
└── ReyGridStreamError         // failure while reading an SSE stream

import {
  ReyGridApiError,
  ReyGridAuthError,
  ReyGridNetworkError,
  ReyGridNotFoundError,
} from "reygrid";

try {
  await client.listMessages("{AgentId}", "user-42");
} catch (err) {
  if (err instanceof ReyGridAuthError) {
    console.error("Invalid API key");
  } else if (err instanceof ReyGridNotFoundError) {
    console.error("No such conversation");
  } else if (err instanceof ReyGridNetworkError) {
    console.error("Network problem:", err.message);
  } else if (err instanceof ReyGridApiError) {
    console.error(`API ${err.statusCode}: ${err.code} — ${err.message}`);
  } else {
    throw err;
  }
}

import { ReyGridApiError, ReyGridPermissionError } from "reygrid";

try {
  await client.addTextSource("{AgentId}", { title: "Refunds", content: "…" });
} catch (err) {
  if (err instanceof ReyGridPermissionError && err.code === "PLAN_LIMIT_REACHED") {
    console.error("Upgrade to add more knowledge");
  } else if (err instanceof ReyGridApiError && err.code === "INVALID_BODY") {
    console.error(err.details?.list); // validation errors per field
  } else {
    throw err;
  }
}