Error codes

import { HyperclipError, HyperclipTimeoutError } from "hyperclip";

try {
  const ref = await hc.runs.create({ flow_id, inputs });
  await hc.runs.wait(ref.id);
} catch (err) {
  if (err instanceof HyperclipError) {
    if (err.code === "monthly_cap_exceeded") { /* raise the cap */ }
    else if (err.code === "insufficient_credits") { /* top up */ }
    else if (err.code === "worker_error" || err.code === "render_failed") {
      // safe to retry with a new idempotency_key
    } else if (err.status === 401) { /* revoke + reissue */ }
    else throw err;
  } else if (err instanceof HyperclipTimeoutError) {
    // run took longer than the wait timeout — cancel and bump
  } else {
    throw err;
  }
}

from hyperclipco import HyperclipError, HyperclipTimeoutError

try:
    ref = hc.runs.create(flow_id=FLOW_ID, inputs=inputs)
    hc.runs.wait(ref["id"])
except HyperclipError as err:
    if err.code == "monthly_cap_exceeded":
        ...  # raise the cap
    elif err.code == "insufficient_credits":
        ...  # top up
    elif err.code in ("worker_error", "render_failed"):
        ...  # safe to retry with a new idempotency_key
    elif err.status == 401:
        ...  # revoke + reissue
    else:
        raise
except HyperclipTimeoutError:
    ...  # cancel + bump

import { Hyperclip, HyperclipError } from "hyperclip";

async function safeCreate(hc: Hyperclip, body: Parameters<Hyperclip["runs"]["create"]>[0]) {
  const key = body.idempotency_key ?? crypto.randomUUID();
  for (let i = 0; i < 4; i++) {
    try {
      return await hc.runs.create({ ...body, idempotency_key: key });
    } catch (err) {
      if (err instanceof HyperclipError && err.status < 500) throw err;  // 4xx — don't retry
      if (i === 3) throw err;
      await new Promise((res) => setTimeout(res, 1000 * 2 ** i));
    }
  }
}

import time, uuid
from hyperclipco import HyperclipError

def safe_create(hc, **body):
    key = body.pop("idempotency_key", None) or str(uuid.uuid4())
    for i in range(4):
        try:
            return hc.runs.create(idempotency_key=key, **body)
        except HyperclipError as err:
            if err.status < 500:
                raise  # 4xx — don't retry
            if i == 3:
                raise
            time.sleep(1 * (2 ** i))

async function safePost(body: unknown, key = randomUUID()) {
  for (let i = 0; i < 4; i++) {
    try {
      const r = await fetch(`${BASE}/runs`, {
        method: "POST",
        headers: {
          Authorization: `Bearer ${API_KEY}`,
          "Content-Type": "application/json",
          "Idempotency-Key": key,
        },
        body: JSON.stringify(body),
      });
      if (r.status >= 500) throw new Error(`${r.status}`);
      return await r.json();
    } catch (err) {
      if (i === 3) throw err;
      await new Promise((res) => setTimeout(res, 1000 * 2 ** i));
    }
  }
}