@zeroxyz/sdk 0.6.0 → 0.8.0

package/dist/{chunk-UIK7QKNQ.cjs → chunk-72WCE7HE.cjs}

@@ -11,8 +11,8 @@ var fetch = require('@x402/fetch');
 var mppx = require('mppx');
 var client$2 = require('mppx/client');
 var chains = require('viem/chains');
-var zod = require('zod');
 var crypto$1 = require('crypto');
+var zod = require('zod');
 
 // src/auth/managed-account.ts
 var createManagedAccount = (client, address) => accounts.toAccount({
@@ -1215,1683 +1215,1696 @@ var Payments = class {
     };
   };
 };
-
-// package.json
-var package_default = {
-  version: "0.6.0"};
-
-// src/version.ts
-var SDK_VERSION = package_default.version;
-var userWalletDtoSchema = zod.z.object({
-  walletAddress: zod.z.string(),
-  source: zod.z.enum(["self_custody", "privy_embedded"]),
-  isPrimary: zod.z.boolean(),
-  linkedAt: zod.z.union([zod.z.string(), zod.z.date()]).nullable().optional(),
-  delegationGranted: zod.z.boolean(),
-  signerQuorumId: zod.z.string().nullable(),
-  // Per-transaction USDC cap in base units (6 dp). null = unlimited, 0 = free-only.
-  maxTransactionUsdcBaseUnits: zod.z.number().int().nullable()
-});
-var welcomeBonusSummarySchema = zod.z.object({
-  status: zod.z.string(),
-  amountUsd: zod.z.number()
-});
-var internalUserDtoSchema = zod.z.object({
-  id: zod.z.string(),
-  email: zod.z.string().nullable(),
-  createdAt: zod.z.union([zod.z.string(), zod.z.date()]).optional(),
-  lastLoginAt: zod.z.union([zod.z.string(), zod.z.date()]).nullable().optional(),
-  onboardingCompleted: zod.z.boolean().optional(),
-  delegationGranted: zod.z.boolean().optional(),
-  wallets: zod.z.array(userWalletDtoSchema).optional(),
-  balance: zod.z.object({ amount: zod.z.string(), asset: zod.z.string() }).nullable().optional(),
-  welcomeBonus: welcomeBonusSummarySchema.nullable().optional()
-});
-var publicUserDtoSchema = zod.z.object({
-  user: zod.z.object({
-    id: zod.z.string(),
-    email: zod.z.string().nullable()
-  }),
-  walletAddress: zod.z.string().nullable(),
-  balance: zod.z.object({ amount: zod.z.string(), asset: zod.z.string() }).nullable(),
-  welcomeBonus: welcomeBonusSummarySchema.nullable()
-});
-var signResponseSchema = zod.z.object({
-  signature: zod.z.string().regex(/^0x[0-9a-fA-F]+$/, "must be 0x-prefixed hex"),
-  walletAddress: zod.z.string().regex(/^0x[0-9a-fA-F]{40}$/, "must be 0x-prefixed 40-char hex address")
-});
-
-// src/schemas/device.ts
-var deviceStartResponseSchema = zod.z.object({
-  deviceCode: zod.z.string(),
-  userCode: zod.z.string(),
-  verificationUri: zod.z.string(),
-  pollInterval: zod.z.number(),
-  expiresAt: zod.z.number()
-});
-var devicePollResponseSchema = zod.z.union([
-  // userCode + verificationUri are optional: older API deployments don't
-  // echo them on pending.
-  zod.z.object({
-    error: zod.z.literal("authorization_pending"),
-    userCode: zod.z.string().optional(),
-    verificationUri: zod.z.string().optional()
-  }),
-  zod.z.object({ error: zod.z.literal("expired_token") }),
-  zod.z.object({
-    accessToken: zod.z.string(),
-    refreshToken: zod.z.string(),
-    expiresIn: zod.z.number(),
-    user: internalUserDtoSchema
-  })
-]);
-var sessionExchangeResponseSchema = zod.z.object({
-  token: zod.z.string(),
-  expiresAt: zod.z.number()
-});
-var refreshResponseSchema = zod.z.object({
-  accessToken: zod.z.string(),
-  refreshToken: zod.z.string()
-});
-var tryRefreshSession = async (client, callerSignal) => {
-  const credentials = client.getCredentials();
-  if (credentials.kind !== "session") return false;
-  if (!credentials.refreshToken) return false;
-  const url = `${client.baseUrl.replace(/\/$/, "")}/v1/auth/refresh`;
-  const timeoutSignal = AbortSignal.timeout(client.timeout);
-  const signal = callerSignal ? AbortSignal.any([callerSignal, timeoutSignal]) : timeoutSignal;
-  let response;
-  try {
-    response = await client.fetchImpl(url, {
-      method: "POST",
-      headers: { "content-type": "application/json" },
-      body: JSON.stringify({ refreshToken: credentials.refreshToken }),
-      signal
-    });
-  } catch {
-    return false;
+var isShortToken = (id) => id.startsWith("z_") && id.indexOf(".", 2) !== -1;
+var MAX_402_PROBE_BYTES = 1024 * 1024;
+var MAX_RESPONSE_BYTES = 10 * 1024 * 1024;
+var TEXT_CONTENT_TYPES = [
+  "application/json",
+  "application/xml",
+  "application/javascript",
+  "application/ecmascript",
+  "application/x-www-form-urlencoded",
+  "text/",
+  "+json",
+  "+xml"
+];
+var MPP_SCHEME_TOKENS = /* @__PURE__ */ new Set(["payment", "mpp"]);
+var splitWwwAuthenticateChallenges = (header) => {
+  const chunks = [];
+  let buf = "";
+  let inQuotes = false;
+  for (let i = 0; i < header.length; i++) {
+    const ch = header[i];
+    if (inQuotes) {
+      if (ch === "\\" && i + 1 < header.length) {
+        buf += ch + header[i + 1];
+        i++;
+        continue;
+      }
+      if (ch === '"') inQuotes = false;
+      buf += ch;
+      continue;
+    }
+    if (ch === '"') {
+      inQuotes = true;
+      buf += ch;
+      continue;
+    }
+    if (ch === ",") {
+      chunks.push(buf);
+      buf = "";
+      continue;
+    }
+    buf += ch;
   }
-  if (!response.ok) return false;
-  let body;
+  if (buf.length > 0) chunks.push(buf);
+  return chunks;
+};
+var isTextContentType = (contentType) => {
+  if (!contentType) return true;
+  const lower = contentType.toLowerCase();
+  return TEXT_CONTENT_TYPES.some((marker) => lower.includes(marker));
+};
+var redactUrl = (url) => {
   try {
-    body = await response.json();
+    const u = new URL(url);
+    return `${u.origin}${u.pathname}`;
   } catch {
-    return false;
+    return "<invalid url>";
   }
-  const parsed = refreshResponseSchema.safeParse(body);
-  if (!parsed.success) return false;
-  await client.applyRefreshedTokens({
-    accessToken: parsed.data.accessToken,
-    refreshToken: parsed.data.refreshToken
-  });
-  return true;
-};
-var buildSessionAuthHeaders = (accessToken) => ({
-  authorization: `Bearer ${accessToken}`
-});
-var buildCanonicalMessage = (method, pathWithQuery, body, timestamp, nonce) => {
-  const bodyHash = crypto$1.createHash("sha256").update(body ?? "").digest("hex");
-  return `${method}:${pathWithQuery}:${bodyHash}:${timestamp}:${nonce}`;
 };
-var buildAccountAuthHeaders = async (account, method, pathWithQuery, body) => {
-  const timestamp = Math.floor(Date.now() / 1e3).toString();
-  const nonce = crypto.randomUUID();
-  const message = buildCanonicalMessage(
-    method,
-    pathWithQuery,
-    body,
-    timestamp,
-    nonce
+var ECHO_DETECT_MIN_LEN = 16;
+var ECHO_DETECT_MAX_SCAN = 64 * 1024;
+var requestBodyEchoed = (candidate, requestBody) => {
+  if (requestBody === void 0) return false;
+  const asString = typeof requestBody === "string" ? requestBody : new TextDecoder("utf-8", { fatal: false }).decode(
+    requestBody.byteLength > ECHO_DETECT_MAX_SCAN ? requestBody.subarray(0, ECHO_DETECT_MAX_SCAN) : requestBody
   );
-  const signature = await account.signMessage({ message });
-  return {
-    "x-zero-address": account.address,
-    "x-zero-timestamp": timestamp,
-    "x-zero-nonce": nonce,
-    "x-zero-signature": signature
-  };
-};
-
-// src/transport/http.ts
-var RETRYABLE_STATUS = /* @__PURE__ */ new Set([408, 502, 503, 504]);
-var sleep = (ms, signal) => new Promise((resolve, reject) => {
-  if (signal?.aborted) {
-    reject(new DOMException("Aborted", "AbortError"));
-    return;
-  }
-  const timer = setTimeout(() => {
-    signal?.removeEventListener("abort", onAbort);
-    resolve();
-  }, ms);
-  const onAbort = () => {
-    clearTimeout(timer);
-    reject(new DOMException("Aborted", "AbortError"));
-  };
-  signal?.addEventListener("abort", onAbort, { once: true });
-});
-var buildPathWithQuery = (path, query) => {
-  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
-  if (!query) return normalizedPath;
-  const params = new URLSearchParams();
-  for (const [key, value] of Object.entries(query)) {
-    if (value !== void 0) params.set(key, String(value));
-  }
-  const qs = params.toString();
-  return qs ? `${normalizedPath}?${qs}` : normalizedPath;
-};
-var joinUrl = (baseUrl, pathWithQuery) => {
-  const base3 = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
-  return `${base3}${pathWithQuery}`;
-};
-var buildHeaders = async (client, method, pathWithQuery, hasBody, bodyStr) => {
-  const headers = { ...client.defaultHeaders };
-  if (hasBody) headers["content-type"] = "application/json";
-  headers["x-zero-sdk-version"] = SDK_VERSION;
-  if (client.apiVersion) headers["x-zero-api-version"] = client.apiVersion;
-  const credentials = client.getCredentials();
-  if (credentials.kind === "session") {
-    Object.assign(headers, buildSessionAuthHeaders(credentials.accessToken));
-  } else if (credentials.kind === "account") {
-    const signed = await buildAccountAuthHeaders(
-      credentials.account,
-      method,
-      pathWithQuery,
-      bodyStr
-    );
-    Object.assign(headers, signed);
+  if (asString.length < ECHO_DETECT_MIN_LEN) return false;
+  const scanLen = Math.min(asString.length, ECHO_DETECT_MAX_SCAN);
+  for (let i = 0; i + ECHO_DETECT_MIN_LEN <= scanLen; i++) {
+    if (candidate.includes(asString.slice(i, i + ECHO_DETECT_MIN_LEN))) {
+      return true;
+    }
   }
-  return headers;
+  return false;
 };
-var parseErrorBody = async (response) => {
+var cancelBody2 = (response) => {
   try {
-    return await response.clone().json();
+    response.body?.cancel().catch(() => {
+    });
   } catch {
-    try {
-      return await response.text();
-    } catch {
-      return void 0;
-    }
   }
 };
-var errorMessageFromBody = (body, status) => {
-  if (body !== null && typeof body === "object" && "error" in body && typeof body.error === "string") {
-    return body.error;
+var detectPaymentRequirement = async (response) => {
+  if (response.status !== 402) return null;
+  const x402Header = response.headers.get("payment-required") ?? response.headers.get("x-payment-required");
+  if (x402Header) {
+    cancelBody2(response);
+    try {
+      const decoded = JSON.parse(
+        Buffer.from(x402Header, "base64").toString("utf8")
+      );
+      return { protocol: "x402", raw: decoded };
+    } catch {
+      return { protocol: "x402", raw: { encoded: x402Header } };
+    }
   }
-  return `HTTP ${status}`;
-};
-var request = async (client, opts, schema) => {
-  const pathWithQuery = buildPathWithQuery(opts.path, opts.query);
-  const url = joinUrl(client.baseUrl, pathWithQuery);
-  const hasBody = opts.body !== void 0;
-  const bodyStr = hasBody ? JSON.stringify(
-    opts.body,
-    (_k, v) => typeof v === "bigint" ? v.toString() : v
-  ) : void 0;
-  const configuredFetch = buildConfiguredFetch(client);
-  const performOnce = async () => configuredFetch(url, {
-    method: opts.method,
-    headers: await buildHeaders(
-      client,
-      opts.method,
-      pathWithQuery,
-      hasBody,
-      bodyStr
-    ),
-    body: bodyStr,
-    signal: opts.signal
-  });
-  let refreshAttempted = false;
-  const executeWithRefresh = async () => {
-    const response = await performOnce();
-    if (response.status !== 401 || refreshAttempted) return response;
-    const credentials = client.getCredentials();
-    if (credentials.kind !== "session") return response;
-    refreshAttempted = true;
-    const refreshed = await client.refreshSessionOnce(opts.signal);
-    if (!refreshed) return response;
-    return await performOnce();
-  };
-  let lastNetworkError;
-  for (let attempt = 0; attempt <= client.maxRetries; attempt++) {
-    let response;
+  const declaredLen = Number.parseInt(
+    response.headers.get("content-length") ?? "",
+    10
+  );
+  const bodyFits = !Number.isFinite(declaredLen) || declaredLen <= MAX_402_PROBE_BYTES;
+  if (bodyFits) {
     try {
-      response = await executeWithRefresh();
-    } catch (e) {
-      if (e instanceof ZeroError) throw e;
-      lastNetworkError = e;
-      if (attempt < client.maxRetries) {
-        try {
-          await sleep(2 ** attempt * 200, opts.signal);
-        } catch (sleepErr) {
-          throw new ZeroApiError("Request aborted by caller", {
-            status: 0,
-            cause: sleepErr
-          });
+      const text = await readClippedText(response, MAX_402_PROBE_BYTES);
+      if (text) {
+        const parsed = JSON.parse(text);
+        if (looksLikeX402Body(parsed)) {
+          return { protocol: "x402", raw: parsed };
         }
-        continue;
-      }
-      throw new ZeroApiError("Network request failed", {
-        status: 0,
-        cause: e
-      });
-    }
-    if (response.ok) {
-      let text;
-      try {
-        text = await response.text();
-      } catch (e) {
-        throw new ZeroApiError("Response body read failed", {
-          status: response.status,
-          cause: e
-        });
-      }
-      let json;
-      try {
-        json = JSON.parse(text);
-      } catch {
       }
-      const parsed = schema.safeParse(json);
-      if (!parsed.success) {
-        throw new ZeroValidationError(
-          `Response did not match expected schema for ${opts.method} ${opts.path}`,
-          { cause: parsed.error, body: text }
-        );
-      }
-      return parsed.data;
+    } catch {
     }
-    if (RETRYABLE_STATUS.has(response.status) && attempt < client.maxRetries) {
-      try {
-        await sleep(2 ** attempt * 200, opts.signal);
-      } catch (sleepErr) {
-        throw new ZeroApiError("Request aborted by caller", {
-          status: 0,
-          cause: sleepErr
-        });
-      }
-      continue;
+  }
+  const wwwAuth = response.headers.get("www-authenticate");
+  if (wwwAuth) {
+    const schemes = splitWwwAuthenticateChallenges(wwwAuth).map(
+      (challenge) => challenge.trim().split(/\s+/)[0]?.toLowerCase() ?? ""
+    );
+    if (schemes.some((scheme) => MPP_SCHEME_TOKENS.has(scheme))) {
+      cancelBody2(response);
+      return { protocol: "mpp", raw: { "www-authenticate": wwwAuth } };
     }
-    const errorBody = await parseErrorBody(response);
-    const requestId = response.headers.get("x-request-id") ?? void 0;
-    throw new ZeroApiError(errorMessageFromBody(errorBody, response.status), {
-      status: response.status,
-      requestId,
-      body: errorBody
-    });
   }
-  throw new ZeroApiError("Exhausted retries", {
-    status: 0,
-    cause: lastNetworkError
-  });
+  cancelBody2(response);
+  return { protocol: "unknown", raw: {} };
 };
-
-// src/namespaces/auth-device.ts
-var AuthDevice = class {
-  constructor(client) {
-    this.client = client;
-  }
-  start = (opts = {}) => request(
-    this.client,
-    {
-      method: "POST",
-      path: "/v1/auth/device/start",
-      signal: opts.signal
-    },
-    deviceStartResponseSchema
-  );
-  poll = async (deviceCode, opts = {}) => {
-    const parsed = await request(
-      this.client,
-      {
-        method: "POST",
-        path: "/v1/auth/device/poll",
-        body: { deviceCode },
-        signal: opts.signal
-      },
-      devicePollResponseSchema
-    );
-    if ("error" in parsed) {
-      return parsed.error === "authorization_pending" ? {
-        status: "pending",
-        userCode: parsed.userCode,
-        verificationUri: parsed.verificationUri
-      } : { status: "expired" };
+var readClippedBytes = async (response, max) => {
+  if (response.body === null) return new Uint8Array(0);
+  const reader = response.body.getReader();
+  const chunks = [];
+  let total = 0;
+  try {
+    while (total < max) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      if (!value) continue;
+      chunks.push(value);
+      total += value.byteLength;
     }
-    return {
-      status: "ok",
-      accessToken: parsed.accessToken,
-      refreshToken: parsed.refreshToken,
-      expiresIn: parsed.expiresIn,
-      user: parsed.user
-    };
-  };
+  } finally {
+    try {
+      await reader.cancel();
+    } catch {
+    }
+  }
+  const merged = new Uint8Array(Math.min(total, max));
+  let offset = 0;
+  for (const c of chunks) {
+    const take = Math.min(c.byteLength, max - offset);
+    merged.set(c.subarray(0, take), offset);
+    offset += take;
+    if (offset >= max) break;
+  }
+  return merged;
 };
-var userWalletsSchema = zod.z.array(userWalletDtoSchema);
-var normalizeMessage = (message) => {
-  if (typeof message === "string") return message;
-  if (typeof message.raw === "string") return message.raw;
-  return viem.bytesToHex(message.raw);
+var readClippedText = async (response, max) => {
+  const bytes = await readClippedBytes(response, max);
+  return new TextDecoder().decode(bytes);
 };
-var repackageSignFailure = (err, op) => {
-  if (err instanceof ZeroApiError && err.status === 402) {
-    const body = err.body;
-    const detail = body && typeof body.error === "string" ? `: ${body.error}` : "";
-    throw new ZeroPaymentError(
-      `Sign endpoint refused ${op} (HTTP 402)${detail}`,
-      { cause: err }
-    );
+var parseResponseBody = async (response, max) => {
+  const contentType = response.headers.get("content-type");
+  const bytes = await readClippedBytes(response, max + 1);
+  const truncated = bytes.byteLength > max;
+  const view = truncated ? bytes.subarray(0, max) : bytes;
+  const buf = Buffer.from(view.buffer, view.byteOffset, view.byteLength);
+  if (!isTextContentType(contentType)) {
+    const base64 = buf.toString("base64");
+    return {
+      body: base64,
+      bodyRaw: base64,
+      bodyEncoding: "base64",
+      truncated
+    };
   }
-  throw err;
-};
-var Auth = class {
-  constructor(client) {
-    this.client = client;
-    this.device = new AuthDevice(client);
+  const text = buf.toString("utf8");
+  if (contentType?.toLowerCase().includes("json")) {
+    try {
+      return { body: JSON.parse(text), bodyRaw: text, truncated };
+    } catch {
+    }
   }
-  device;
-  // The internal (web-app facing) user profile. Richer than profile(): full
-  // wallet list with per-wallet delegation/signer/limit metadata.
-  me = (opts = {}) => request(
-    this.client,
-    { method: "GET", path: "/v1/users/me", signal: opts.signal },
-    internalUserDtoSchema
-  );
-  // The public (agent-facing) profile — identity + primary wallet address +
-  // balance + welcome-bonus, no per-wallet metadata. Same shape the MCP
-  // get_profile tool returns; rendered by `zero auth whoami`.
-  profile = (opts = {}) => request(
-    this.client,
-    { method: "GET", path: "/v1/users/me/profile", signal: opts.signal },
-    publicUserDtoSchema
+  return { body: text, bodyRaw: text, truncated };
+};
+var UPSTREAM_ERROR_FIELDS = [
+  "error",
+  "message",
+  "detail",
+  "reason",
+  "error_description"
+];
+var UPSTREAM_ERROR_MAX_LEN = 200;
+var ERROR_SNIPPET_BYTES = 500;
+var clampUpstreamMessage = (value) => {
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  return trimmed.length > UPSTREAM_ERROR_MAX_LEN ? `${trimmed.slice(0, UPSTREAM_ERROR_MAX_LEN)}\u2026` : trimmed;
+};
+var tryParseJson = (text) => {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+};
+var extractUpstreamErrorMessage = (body) => {
+  const parsed = tryParseJson(body);
+  if (parsed === null || typeof parsed !== "object") {
+    return clampUpstreamMessage(body);
+  }
+  const record = parsed;
+  for (const field of UPSTREAM_ERROR_FIELDS) {
+    const value = record[field];
+    if (typeof value === "string" && value.length > 0) {
+      return clampUpstreamMessage(value);
+    }
+    if (value && typeof value === "object") {
+      const nested = value.message;
+      if (typeof nested === "string" && nested.length > 0) {
+        return clampUpstreamMessage(nested);
+      }
+    }
+  }
+  return void 0;
+};
+var buildUpstreamError = (status, bodyRaw, bodyEncoding) => {
+  if (status >= 200 && status < 300) return void 0;
+  if (bodyRaw === null || bodyRaw.length === 0) return void 0;
+  if (bodyEncoding === "base64") return void 0;
+  const snippet = bodyRaw.slice(0, ERROR_SNIPPET_BYTES);
+  return {
+    status,
+    message: extractUpstreamErrorMessage(bodyRaw),
+    snippetHash: crypto$1.createHash("sha256").update(snippet).digest("hex"),
+    snippetLength: snippet.length
+  };
+};
+var computeOutcome = (status, payment, warnings) => {
+  if (warnings.includes(FETCH_WARNINGS.mppSessionCloseFailed))
+    return "payment_close_failed";
+  if (status === 402 && payment !== null) return "payment_rejected";
+  if (status === 402) return "payment_failed";
+  if (status >= 400) return "server_error";
+  return "success";
+};
+var errorFetchResult = (startedAt, error, skipReason, capabilityIdRequested, outcome, status = null) => {
+  const result = {
+    runId: null,
+    ok: false,
+    status,
+    latencyMs: Date.now() - startedAt,
+    payment: null,
+    outcome,
+    body: null,
+    bodyRaw: null,
+    error
+  };
+  if (capabilityIdRequested) result.runTrackingSkipped = [skipReason];
+  return result;
+};
+var resolveRecordingClient = (client, opts) => {
+  const credentials = client.getCredentials();
+  const recordingClient = opts.account ? client.withAccount(opts.account) : client;
+  const canRecord = opts.account !== void 0 || credentials.kind === "account" || credentials.kind === "session";
+  return { recordingClient, canRecord };
+};
+var recordErrorFetchRun = async (client, opts, result, capabilityIdOverride) => {
+  const effectiveCapId = opts.capabilityId;
+  if (effectiveCapId === void 0) return;
+  const { recordingClient, canRecord } = resolveRecordingClient(client, opts);
+  if (!canRecord) return;
+  const fetchOriginForRecord = opts.capabilityId === void 0 ? "direct_url" : isShortToken(effectiveCapId) ? "from_search" : opts.fetchOrigin;
+  try {
+    const created = await recordingClient.runs.create({
+      capabilityId: effectiveCapId,
+      ...opts.searchId && { searchId: opts.searchId },
+      ...fetchOriginForRecord && { fetchOrigin: fetchOriginForRecord },
+      ...result.status !== null && { status: result.status },
+      latencyMs: result.latencyMs,
+      ...opts.requestSchema && { requestSchema: opts.requestSchema }
+    });
+    result.runId = created.runId;
+    delete result.runTrackingSkipped;
+  } catch {
+  }
+};
+var recordTimeoutRun = async (client, opts, err, startedAt, capabilityIdRequested, capabilityIdOverride) => {
+  const result = errorFetchResult(
+    startedAt,
+    err.message,
+    "timeout",
+    capabilityIdRequested,
+    "network_error"
   );
-  // The user's wallets only. Lightweight sibling of `me()` for callers that
-  // just need wallet addresses (e.g. managed-account resolution on the pay
-  // path) — avoids the heavier internal-profile computation behind `me()`.
-  wallets = (opts = {}) => request(
-    this.client,
-    { method: "GET", path: "/v1/users/me/wallets", signal: opts.signal },
-    userWalletsSchema
+  await recordErrorFetchRun(client, opts, result);
+};
+var sniffJsonShapeBytes = (buf) => {
+  let i = 0;
+  if (buf.length >= 3 && buf[0] === 239 && buf[1] === 187 && buf[2] === 191) {
+    i = 3;
+  }
+  while (i < buf.length && (buf[i] === 32 || buf[i] === 9 || buf[i] === 10 || buf[i] === 13)) {
+    i++;
+  }
+  if (i >= buf.length) return false;
+  return buf[i] === 123 || buf[i] === 91;
+};
+var withDefaultContentType = (headers, body) => {
+  if (!headers && body === void 0) return void 0;
+  const next = headers ? { ...headers } : {};
+  if (body === void 0) return next;
+  const hasContentType = Object.keys(next).some(
+    (k) => k.toLowerCase() === "content-type"
   );
-  // Exchange an ephemeral session code (e.g. runner / sandbox handoff) for
-  // a session access token. The returned token has no refresh path — pair
-  // with `refreshToken: ""` when constructing the client.
-  exchangeSessionCode = (code, opts = {}) => request(
-    this.client,
-    {
-      method: "POST",
-      path: "/v1/session/exchange",
-      body: { code },
-      signal: opts.signal
-    },
-    sessionExchangeResponseSchema
+  if (!hasContentType) {
+    next["content-type"] = typeof body === "string" || sniffJsonShapeBytes(body) ? "application/json" : "application/octet-stream";
+  }
+  return next;
+};
+var clientFetch = async (client, url, opts = {}) => {
+  const startedAt = Date.now();
+  const capabilityIdRequested = opts.capabilityId !== void 0;
+  const normalized = normalizeTransportEnvelopeRequest(url, {
+    method: opts.method,
+    body: opts.body
+  });
+  const requestUrl = normalized.url;
+  const requestBody = normalized.body;
+  const method = normalized.method ?? (requestBody !== void 0 ? "POST" : "GET");
+  const { canRecord: canRecordForResolve } = resolveRecordingClient(
+    client,
+    opts
   );
-  // Server-side revoke of the refresh token. Throws ZeroApiError on any
-  // non-2xx — callers that have already cleared local state (e.g. CLI
-  // logout) typically want to swallow with `.catch(() => {})` so a flaky
-  // server doesn't surface as a user-visible failure for a sign-out that
-  // already succeeded locally. Response body is opaque; schema is
-  // `z.unknown()` and the resolved value is discarded.
-  logout = async (refreshToken, opts = {}) => {
-    await request(
-      this.client,
-      {
-        method: "POST",
-        path: "/v1/auth/logout",
-        body: { refreshToken },
-        signal: opts.signal
-      },
-      zod.z.unknown()
-    );
+  const resolvePromise = !capabilityIdRequested && canRecordForResolve ? client.capabilities.resolveByUrl(redactUrl(requestUrl), method).catch(() => null) : Promise.resolve(null);
+  const probeHeaders = withDefaultContentType(opts.headers, requestBody);
+  const requestInit = {
+    method,
+    headers: probeHeaders,
+    body: requestBody,
+    signal: opts.signal
   };
-  // Force a session refresh. Routes through refreshSessionOnce() so a
-  // proactive call doesn't race a 401-driven transport refresh —
-  // concurrent POSTs with the same refresh token kill the session
-  // family (RFC 6819 token-theft response).
-  refresh = async () => {
-    const credentials = this.client.getCredentials();
-    if (credentials.kind !== "session") {
-      throw new ZeroAuthError(
-        "auth_no_credentials",
-        "refresh() requires the client to be constructed with a session \u2014 got credentials.kind=" + credentials.kind
-      );
-    }
-    const ok = await this.client.refreshSessionOnce();
-    if (!ok) {
-      throw new ZeroAuthError(
-        "auth_session_expired",
-        "Session refresh failed. The refresh token may be revoked or expired."
+  const configuredFetch = buildConfiguredFetch(client, {
+    timeoutMs: opts.timeoutMs
+  });
+  let response;
+  let payment = null;
+  const skipReasons = [];
+  const warnings = [];
+  try {
+    response = await configuredFetch(requestUrl, requestInit);
+  } catch (err) {
+    if (err instanceof ZeroTimeoutError) {
+      await recordTimeoutRun(
+        client,
+        opts,
+        err,
+        startedAt,
+        capabilityIdRequested
       );
+      throw err;
     }
-  };
-  signMessage = async (input, opts = {}) => {
-    const credentials = this.client.getCredentials();
-    if (credentials.kind === "account") {
-      return await credentials.account.signMessage({ message: input.message });
-    }
-    if (credentials.kind === "session") {
+    if (err instanceof ZeroError) throw err;
+    const errMessage = err instanceof Error ? err.message : String(err);
+    const result2 = errorFetchResult(
+      startedAt,
+      errMessage,
+      "fetch_failed_before_response",
+      capabilityIdRequested,
+      "network_error"
+    );
+    await recordErrorFetchRun(client, opts, result2);
+    return result2;
+  }
+  if (response.status === 402) {
+    const requirement = await detectPaymentRequirement(response);
+    if (requirement?.protocol === "x402" || requirement?.protocol === "mpp") {
+      const payCall = requirement.protocol === "x402" ? client.payments.pay : client.payments.payMpp;
       try {
-        const parsed = await request(
-          this.client,
-          {
-            method: "POST",
-            path: "/v1/users/me/sign-message",
-            body: { message: normalizeMessage(input.message) }
-          },
-          signResponseSchema
-        );
-        this.assertSignerMatches(parsed.walletAddress, opts.expectedAddress);
-        return parsed.signature;
+        const paid = await payCall({
+          url: requestUrl,
+          method,
+          // Fresh clone for the paid retry — same rationale as
+          // the probe-side clone above. Re-derives the default
+          // Content-Type so the paid leg matches the probe.
+          headers: withDefaultContentType(opts.headers, requestBody),
+          body: requestBody,
+          maxPay: opts.maxPay,
+          account: opts.account,
+          signal: opts.signal,
+          timeoutMs: opts.timeoutMs,
+          ...opts.displayCostAmount && {
+            displayCostAmount: opts.displayCostAmount
+          }
+        });
+        response = paid.response;
+        payment = paid.payment;
+        if (paid.warnings) warnings.push(...paid.warnings);
       } catch (err) {
-        repackageSignFailure(err, "signMessage");
+        if (err instanceof ZeroSessionCloseFailedError) {
+          response = err.response;
+          payment = {
+            protocol: "mpp",
+            chain: tempoChainLabelFromId(err.session.chainId),
+            txHash: null,
+            amount: err.capturedAmount,
+            asset: "USDC",
+            session: err.session
+          };
+          warnings.push(FETCH_WARNINGS.mppSessionCloseFailed);
+        } else if (err instanceof ZeroInsufficientFundsError) {
+          return errorFetchResult(
+            startedAt,
+            err.message,
+            FETCH_SKIP_REASONS.insufficientFunds,
+            capabilityIdRequested,
+            "insufficient_funds",
+            null
+          );
+        } else if (err instanceof ZeroPaymentError || err instanceof ZeroAuthError) {
+          const result2 = errorFetchResult(
+            startedAt,
+            err.message,
+            "payment_failed",
+            capabilityIdRequested,
+            "payment_failed",
+            402
+          );
+          await recordErrorFetchRun(client, opts, result2);
+          return result2;
+        } else if (err instanceof ZeroTimeoutError) {
+          await recordTimeoutRun(
+            client,
+            opts,
+            err,
+            startedAt,
+            capabilityIdRequested
+          );
+          throw err;
+        } else {
+          throw err;
+        }
       }
+    } else if (requirement?.protocol === "unknown") {
+      const result2 = errorFetchResult(
+        startedAt,
+        "Capability returned 402 with an unrecognized payment protocol. Neither x402 nor MPP markers were detected in the response headers or body.",
+        "unrecognized_402_protocol",
+        capabilityIdRequested,
+        "payment_failed",
+        402
+      );
+      await recordErrorFetchRun(client, opts, result2);
+      return result2;
     }
-    throw new ZeroAuthError(
-      "auth_no_credentials",
-      "signMessage() requires the client to be constructed with `account` or `session`."
-    );
-  };
-  // Managed-only: BYO accounts sign locally via viem's account.signTransaction.
-  signTransaction = async (input, opts = {}) => {
-    const credentials = this.client.getCredentials();
-    if (credentials.kind === "session") {
-      try {
-        const parsed = await request(
-          this.client,
-          {
-            method: "POST",
-            path: "/v1/users/me/sign-transaction",
-            body: { unsignedTransaction: input.unsignedTransaction }
-          },
-          signResponseSchema
-        );
-        this.assertSignerMatches(parsed.walletAddress, opts.expectedAddress);
-        return parsed.signature;
-      } catch (err) {
-        repackageSignFailure(err, "signTransaction");
-      }
+  }
+  const latencyMs = Date.now() - startedAt;
+  const maxResponseBytes = opts.maxResponseBytes ?? MAX_RESPONSE_BYTES;
+  let body;
+  let bodyRaw;
+  let bodyEncoding;
+  try {
+    const parsed = await parseResponseBody(response, maxResponseBytes);
+    body = parsed.body;
+    bodyRaw = parsed.bodyRaw;
+    bodyEncoding = parsed.bodyEncoding;
+    if (parsed.truncated) warnings.push(FETCH_WARNINGS.bodyTruncated);
+  } catch (err) {
+    if (err instanceof Error && err.name === "AbortError") {
+      throw new ZeroApiError("Request aborted by caller", {
+        status: 0,
+        cause: err
+      });
     }
-    if (credentials.kind === "account") {
-      throw new ZeroAuthError(
-        "auth_error",
-        "signTransaction() is a managed-signing operation and is not supported in account mode. Sign locally with viem's account.signTransaction instead."
-      );
+    const message = err instanceof Error ? err.message : String(err);
+    const skips = [];
+    const settledLocally = paymentHasAnchor(payment);
+    if (settledLocally && response.status === 402) {
+      warnings.push(FETCH_WARNINGS.paidButStill402NotRecorded);
+      skips.push(FETCH_WARNINGS.paidButStill402NotRecorded);
     }
-    throw new ZeroAuthError(
-      "auth_no_credentials",
-      "signTransaction() requires session credentials (managed signing)."
-    );
-  };
-  signTypedData = async (input, opts = {}) => {
-    const credentials = this.client.getCredentials();
-    if (credentials.kind === "account") {
-      if (!credentials.account.signTypedData) {
-        throw new ZeroAuthError(
-          "auth_error",
-          "The configured viem account does not implement signTypedData."
-        );
-      }
-      return await credentials.account.signTypedData(input);
+    if (payment !== null && !settledLocally) {
+      warnings.push(FETCH_WARNINGS.paymentSettlementUnconfirmed);
+      skips.push(FETCH_WARNINGS.paymentSettlementUnconfirmed);
     }
-    if (credentials.kind === "session") {
-      try {
-        const parsed = await request(
-          this.client,
-          {
-            method: "POST",
-            path: "/v1/users/me/sign-typed-data",
-            body: { typedData: input }
-          },
-          signResponseSchema
-        );
-        this.assertSignerMatches(parsed.walletAddress, opts.expectedAddress);
-        return parsed.signature;
-      } catch (err) {
-        repackageSignFailure(err, "signTypedData");
-      }
+    if (payment !== null && payment.amount === "unknown") {
+      warnings.push(FETCH_WARNINGS.paymentAmountUnknown);
     }
-    throw new ZeroAuthError(
-      "auth_no_credentials",
-      "signTypedData() requires the client to be constructed with `account` or `session`."
-    );
-  };
-  // Compare against the caller's pinned address (not shared cache) so
-  // concurrent pay()s can't race past each other. Mismatch → clear + throw;
-  // the caller's retry rebuilds against the new wallet.
-  assertSignerMatches = (serverAddr, expectedAddr) => {
-    if (!expectedAddr) return;
-    const canonicalServer = viem.getAddress(serverAddr);
-    const canonicalExpected = viem.getAddress(expectedAddr);
-    if (canonicalExpected === canonicalServer) return;
-    this.client.clearManagedAccount();
-    throw new ZeroAuthError(
-      "auth_error",
-      `Managed signing wallet changed (caller expected ${canonicalExpected}, server signed as ${canonicalServer}). Cache cleared \u2014 retry to rebuild against the current wallet.`
-    );
-  };
-};
-var BUG_REPORT_CATEGORIES = [
-  "search_relevance",
-  "ranking_issue",
-  "missing_capability",
-  "wrong_schema",
-  "misleading_description",
-  "broken_execution",
-  "payment_failure",
-  "billing_anomaly",
-  "cli_bug",
-  "security",
-  "other"
-];
-var createBugReportResponseSchema = zod.z.object({
-  bugReportId: zod.z.string(),
-  status: zod.z.string(),
-  deduped: zod.z.boolean(),
-  category: zod.z.enum(BUG_REPORT_CATEGORIES).nullable(),
-  title: zod.z.string().nullable(),
-  attached: zod.z.object({
-    capabilityId: zod.z.number().nullable(),
-    runId: zod.z.number().nullable(),
-    searchId: zod.z.number().nullable()
-  })
-});
-
-// src/namespaces/bug-reports.ts
-var BugReports = class {
-  constructor(client) {
-    this.client = client;
+    skips.push(FETCH_SKIP_REASONS.bodyReadFailed);
+    const result2 = {
+      runId: null,
+      ok: false,
+      status: response.status,
+      latencyMs: Date.now() - startedAt,
+      payment,
+      outcome: computeOutcome(response.status, payment, warnings),
+      body: null,
+      bodyRaw: null,
+      error: message
+    };
+    if (capabilityIdRequested) result2.runTrackingSkipped = skips;
+    if (warnings.length > 0) result2.warnings = warnings;
+    return result2;
   }
-  // POST /v1/bug-reports. Wallet-attributed server-side; the SDK client's
-  // active credential drives attribution (account-mode → EIP-191 from the
-  // wallet, session-mode → Bearer + server resolves the user's wallet).
-  create = (input, opts = {}) => request(
-    this.client,
-    {
-      method: "POST",
-      path: "/v1/bug-reports",
-      body: input,
-      signal: opts.signal
-    },
-    createBugReportResponseSchema
-  );
-};
-var ratingSchema = zod.z.object({
-  score: zod.z.string(),
-  successRate: zod.z.string(),
-  reviews: zod.z.number(),
-  stars: zod.z.string().nullable().optional(),
-  state: zod.z.enum(["unrated", "rated"]).optional()
-});
-
-// src/schemas/capabilities.ts
-var capabilityResponseSchema = zod.z.object({
-  uid: zod.z.string(),
-  slug: zod.z.string(),
-  name: zod.z.string(),
-  description: zod.z.string(),
-  url: zod.z.string(),
-  urlTemplate: zod.z.string().nullable().optional(),
-  method: zod.z.string(),
-  headers: zod.z.record(zod.z.string(), zod.z.string()).nullable(),
-  bodySchema: zod.z.record(zod.z.string(), zod.z.unknown()).nullable(),
-  responseSchema: zod.z.record(zod.z.string(), zod.z.unknown()).nullable(),
-  example: zod.z.object({ request: zod.z.unknown(), response: zod.z.unknown() }).nullable(),
-  tags: zod.z.array(zod.z.string()).nullable(),
-  exampleAgentPrompt: zod.z.string().nullable().optional(),
-  displayCostAmount: zod.z.string(),
-  displayCostAsset: zod.z.string(),
-  reviewCount: zod.z.number(),
-  rating: ratingSchema,
-  priceObserved: zod.z.object({
-    minCents: zod.z.string().nullable(),
-    medianCents: zod.z.string().nullable(),
-    maxCents: zod.z.string().nullable(),
-    // Deprecated alias for maxCents; kept for back-compat with older
-    // API versions that still emit it.
-    p95Cents: zod.z.string().nullable(),
-    sampleCount: zod.z.number(),
-    varies: zod.z.boolean(),
-    failureChargeRate: zod.z.number().nullable()
-  }).nullable().optional(),
-  paymentMethods: zod.z.array(
-    zod.z.object({
-      uid: zod.z.string(),
-      protocol: zod.z.string(),
-      methodType: zod.z.string(),
-      chain: zod.z.string().nullable(),
-      mode: zod.z.string(),
-      costAmount: zod.z.string(),
-      costPer: zod.z.string(),
-      priority: zod.z.number()
-    })
-  ).nullable(),
-  availabilityStatus: zod.z.enum(["healthy", "unknown", "down"]).nullable().optional(),
-  /**
-   * @deprecated The API no longer emits `displayStatus`; it has been replaced
-   * by the consolidated 3-value {@link capabilityResponseSchema.shape.availabilityStatus}.
-   * Kept as an optional field for one release for back-compat (ZERO-89 soft
-   * migration) and will be removed in the next major version.
-   */
-  displayStatus: zod.z.enum(["healthy", "stable", "degraded", "unhealthy", "unknown"]).optional(),
-  activationCount: zod.z.number().optional(),
-  lastUsedAt: zod.z.string().nullable().optional(),
-  lastSuccessfullyRanAt: zod.z.string().nullable().optional()
-});
-var resolveCapabilityResponseSchema = zod.z.object({
-  capabilityId: zod.z.string(),
-  capabilitySlug: zod.z.string(),
-  matchedVia: zod.z.enum(["exact", "template"])
-});
-
-// src/namespaces/capabilities.ts
-var Capabilities = class {
-  constructor(client) {
-    this.client = client;
+  const settled = paymentHasAnchor(payment);
+  const paidButStill402 = settled && response.status === 402;
+  const settlementUnconfirmed = payment !== null && !settled;
+  if (paidButStill402) warnings.push(FETCH_WARNINGS.paidButStill402NotRecorded);
+  if (settlementUnconfirmed)
+    warnings.push(FETCH_WARNINGS.paymentSettlementUnconfirmed);
+  if (payment !== null && payment.amount === "unknown") {
+    warnings.push(FETCH_WARNINGS.paymentAmountUnknown);
   }
-  get = (id, opts = {}) => request(
-    this.client,
-    {
-      method: "GET",
-      path: `/v1/capabilities/${encodeURIComponent(id)}`,
-      query: opts.searchId ? { searchId: opts.searchId } : void 0,
-      signal: opts.signal
-    },
-    capabilityResponseSchema
+  let runId = null;
+  const closeFailed = warnings.includes(FETCH_WARNINGS.mppSessionCloseFailed);
+  const upstreamErrorForRecord = buildUpstreamError(
+    response.status,
+    bodyRaw,
+    bodyEncoding
   );
-  // Resolve a raw endpoint URL + method back to the capability that owns it,
-  // for the `zero fetch <url>` case where the client has no local search
-  // context to match against (a memoized/cross-session URL). Returns null on
-  // 404 — i.e. no match or an ambiguous multi-match, both of which the server
-  // reports as 404 (resolveByUrl fails closed rather than mis-attribute).
-  // The URL travels in the POST body so it stays out of access logs and is
-  // never stored; the caller uses the returned capabilityId to record an
-  // attributed run without the URL ever touching the run row (ZERO-335).
-  resolveByUrl = async (url, method, opts = {}) => {
-    try {
-      return await request(
-        this.client,
-        {
-          method: "POST",
-          path: "/v1/capabilities/resolve",
-          body: { url, method },
-          signal: opts.signal
-        },
-        resolveCapabilityResponseSchema
-      );
-    } catch (err) {
-      if (err instanceof ZeroApiError && err.status === 404) return null;
-      throw err;
+  if (capabilityIdRequested) {
+    if (paidButStill402)
+      skipReasons.push(FETCH_WARNINGS.paidButStill402NotRecorded);
+    else if (closeFailed)
+      skipReasons.push(FETCH_SKIP_REASONS.mppSessionCloseFailedNotRecorded);
+  }
+  const resolvedCap = await resolvePromise;
+  const effectiveCapabilityId = opts.capabilityId ?? resolvedCap?.capabilityId;
+  const capabilityResolution = !capabilityIdRequested && canRecordForResolve ? resolvedCap !== null ? {
+    resolved: true,
+    capabilityId: resolvedCap.capabilityId,
+    capabilitySlug: resolvedCap.capabilitySlug,
+    matchedVia: resolvedCap.matchedVia
+  } : { resolved: false } : void 0;
+  if (effectiveCapabilityId !== void 0 && !paidButStill402 && !closeFailed) {
+    const { recordingClient, canRecord } = resolveRecordingClient(client, opts);
+    if (!canRecord) {
+      skipReasons.push("no_credentials");
+    } else {
+      const knownAmount = payment !== null && payment.amount !== "unknown";
+      try {
+        let derived;
+        if (opts.deriveRunMetadata) {
+          try {
+            derived = opts.deriveRunMetadata({
+              status: response.status,
+              ok: response.ok,
+              bodyRaw,
+              ...bodyEncoding && { bodyEncoding }
+            });
+          } catch {
+          }
+        }
+        const result2 = await recordingClient.runs.create({
+          capabilityId: effectiveCapabilityId,
+          searchId: opts.searchId,
+          // Auto-resolved runs are always direct_url — they only fire when
+          // no capabilityId was supplied (the direct_url path by definition).
+          ...opts.capabilityId === void 0 ? { fetchOrigin: "direct_url" } : opts.fetchOrigin && { fetchOrigin: opts.fetchOrigin },
+          status: response.status,
+          latencyMs,
+          ...opts.requestSchema && { requestSchema: opts.requestSchema },
+          ...derived?.responseSchema && {
+            responseSchema: derived.responseSchema
+          },
+          ...upstreamErrorForRecord && {
+            errorSnippetHash: upstreamErrorForRecord.snippetHash,
+            errorSnippetLength: upstreamErrorForRecord.snippetLength
+          },
+          ...payment && {
+            ...knownAmount && {
+              costAmount: payment.amount,
+              costAsset: payment.asset
+            },
+            paymentProtocol: payment.protocol,
+            paymentChain: payment.chain,
+            paymentTxHash: payment.txHash ?? void 0,
+            paymentMode: payment.session ? "session" : "charge"
+          }
+        });
+        runId = result2.runId;
+      } catch (err) {
+        const errorMessage2 = err instanceof Error ? err.message : String(err);
+        const code = err instanceof ZeroError ? err.code : void 0;
+        const skipMsg = code ? `run_create_failed:${code}: ${errorMessage2}` : `run_create_failed: ${errorMessage2}`;
+        skipReasons.push(skipMsg);
+        client.logger?.({
+          level: "warn",
+          message: "Failed to record run for fetch",
+          meta: {
+            url: redactUrl(url),
+            capabilityId: effectiveCapabilityId,
+            error: errorMessage2,
+            errorCode: code
+          }
+        });
+      }
     }
+  }
+  const result = {
+    runId,
+    ok: response.ok,
+    status: response.status,
+    latencyMs,
+    payment,
+    outcome: computeOutcome(response.status, payment, warnings),
+    body,
+    bodyRaw
   };
+  if (bodyEncoding) result.bodyEncoding = bodyEncoding;
+  if (!response.ok) {
+    const candidate = bodyRaw !== null && bodyRaw.length > 0 && bodyEncoding !== "base64" ? bodyRaw.slice(0, 240) : null;
+    result.error = candidate !== null && !requestBodyEchoed(candidate, opts.body) ? candidate : `HTTP ${response.status}`;
+    if (upstreamErrorForRecord) result.upstreamError = upstreamErrorForRecord;
+  }
+  if (capabilityIdRequested && skipReasons.length > 0) {
+    result.runTrackingSkipped = skipReasons;
+  }
+  if (warnings.length > 0) result.warnings = warnings;
+  if (capabilityResolution !== void 0)
+    result.capabilityResolution = capabilityResolution;
+  return result;
 };
-var createRunResponseSchema = zod.z.object({
-  runId: zod.z.string()
-});
-var runListItemSchema = zod.z.object({
-  uid: zod.z.string(),
-  capabilityUid: zod.z.string(),
-  capabilitySlug: zod.z.string(),
-  capabilityName: zod.z.string(),
-  status: zod.z.number().nullable(),
-  latencyMs: zod.z.number().nullable(),
-  cost: zod.z.object({ amount: zod.z.string(), asset: zod.z.string().nullable() }).nullable(),
-  payment: zod.z.object({
-    protocol: zod.z.string(),
-    chain: zod.z.string().nullable(),
-    txHash: zod.z.string().nullable(),
-    mode: zod.z.string().nullable()
-  }).nullable(),
-  createdAt: zod.z.coerce.date(),
-  reviewed: zod.z.boolean()
+
+// package.json
+var package_default = {
+  version: "0.8.0"};
+
+// src/version.ts
+var SDK_VERSION = package_default.version;
+var userWalletDtoSchema = zod.z.object({
+  walletAddress: zod.z.string(),
+  source: zod.z.enum(["self_custody", "privy_embedded"]),
+  isPrimary: zod.z.boolean(),
+  linkedAt: zod.z.union([zod.z.string(), zod.z.date()]).nullable().optional(),
+  delegationGranted: zod.z.boolean(),
+  signerQuorumId: zod.z.string().nullable(),
+  // Per-transaction USDC cap in base units (6 dp). null = unlimited, 0 = free-only.
+  maxTransactionUsdcBaseUnits: zod.z.number().int().nullable()
 });
-var listRunsResponseSchema = zod.z.object({
-  runs: zod.z.array(runListItemSchema),
-  nextCursor: zod.z.string().nullable()
+var welcomeBonusSummarySchema = zod.z.object({
+  status: zod.z.string(),
+  amountUsd: zod.z.number()
 });
-var runDetailSchema = zod.z.object({
-  runId: zod.z.string(),
-  status: zod.z.number().nullable(),
-  latencyMs: zod.z.number().nullable(),
-  errorClass: zod.z.string().nullable(),
-  createdAt: zod.z.coerce.date(),
-  cost: zod.z.object({ amount: zod.z.string(), asset: zod.z.string().nullable() }).nullable(),
-  payment: zod.z.object({
-    protocol: zod.z.string(),
-    chain: zod.z.string().nullable(),
-    txHash: zod.z.string().nullable(),
-    mode: zod.z.string().nullable()
-  }).nullable(),
-  capability: zod.z.object({
-    uid: zod.z.string(),
-    slug: zod.z.string(),
-    name: zod.z.string(),
-    url: zod.z.string(),
-    method: zod.z.string(),
-    whatItDoes: zod.z.string().nullable(),
-    tags: zod.z.array(zod.z.string())
+var internalUserDtoSchema = zod.z.object({
+  id: zod.z.string(),
+  email: zod.z.string().nullable(),
+  createdAt: zod.z.union([zod.z.string(), zod.z.date()]).optional(),
+  lastLoginAt: zod.z.union([zod.z.string(), zod.z.date()]).nullable().optional(),
+  onboardingCompleted: zod.z.boolean().optional(),
+  delegationGranted: zod.z.boolean().optional(),
+  wallets: zod.z.array(userWalletDtoSchema).optional(),
+  balance: zod.z.object({ amount: zod.z.string(), asset: zod.z.string() }).nullable().optional(),
+  welcomeBonus: welcomeBonusSummarySchema.nullable().optional()
+});
+var publicUserDtoSchema = zod.z.object({
+  user: zod.z.object({
+    id: zod.z.string(),
+    email: zod.z.string().nullable()
   }),
-  reviewed: zod.z.boolean()
+  walletAddress: zod.z.string().nullable(),
+  balance: zod.z.object({ amount: zod.z.string(), asset: zod.z.string() }).nullable(),
+  welcomeBonus: welcomeBonusSummarySchema.nullable()
 });
-var createReviewResponseSchema = zod.z.object({
-  reviewId: zod.z.string(),
-  recorded: zod.z.boolean(),
-  updated: zod.z.boolean().optional()
+var signResponseSchema = zod.z.object({
+  signature: zod.z.string().regex(/^0x[0-9a-fA-F]+$/, "must be 0x-prefixed hex"),
+  walletAddress: zod.z.string().regex(/^0x[0-9a-fA-F]{40}$/, "must be 0x-prefixed 40-char hex address")
 });
-var batchReviewResponseSchema = zod.z.object({
-  results: zod.z.array(
-    zod.z.union([
-      zod.z.object({
-        runId: zod.z.string(),
-        ok: zod.z.literal(true),
-        reviewId: zod.z.string(),
-        updated: zod.z.boolean()
-      }),
-      zod.z.object({
-        runId: zod.z.string(),
-        ok: zod.z.literal(false),
-        status: zod.z.number(),
-        error: zod.z.string()
-      })
-    ])
-  ),
-  summary: zod.z.object({
-    total: zod.z.number(),
-    ok: zod.z.number(),
-    failed: zod.z.number()
+
+// src/schemas/device.ts
+var deviceStartResponseSchema = zod.z.object({
+  deviceCode: zod.z.string(),
+  userCode: zod.z.string(),
+  verificationUri: zod.z.string(),
+  pollInterval: zod.z.number(),
+  expiresAt: zod.z.number()
+});
+var devicePollResponseSchema = zod.z.union([
+  // userCode + verificationUri are optional: older API deployments don't
+  // echo them on pending.
+  zod.z.object({
+    error: zod.z.literal("authorization_pending"),
+    userCode: zod.z.string().optional(),
+    verificationUri: zod.z.string().optional()
+  }),
+  zod.z.object({ error: zod.z.literal("expired_token") }),
+  zod.z.object({
+    accessToken: zod.z.string(),
+    refreshToken: zod.z.string(),
+    expiresIn: zod.z.number(),
+    user: internalUserDtoSchema
   })
+]);
+var sessionExchangeResponseSchema = zod.z.object({
+  token: zod.z.string(),
+  expiresAt: zod.z.number()
+});
+var refreshResponseSchema = zod.z.object({
+  accessToken: zod.z.string(),
+  refreshToken: zod.z.string()
+});
+var tryRefreshSession = async (client, callerSignal) => {
+  const credentials = client.getCredentials();
+  if (credentials.kind !== "session") return false;
+  if (!credentials.refreshToken) return false;
+  const url = `${client.baseUrl.replace(/\/$/, "")}/v1/auth/refresh`;
+  const timeoutSignal = AbortSignal.timeout(client.timeout);
+  const signal = callerSignal ? AbortSignal.any([callerSignal, timeoutSignal]) : timeoutSignal;
+  let response;
+  try {
+    response = await client.fetchImpl(url, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ refreshToken: credentials.refreshToken }),
+      signal
+    });
+  } catch {
+    return false;
+  }
+  if (!response.ok) return false;
+  let body;
+  try {
+    body = await response.json();
+  } catch {
+    return false;
+  }
+  const parsed = refreshResponseSchema.safeParse(body);
+  if (!parsed.success) return false;
+  await client.applyRefreshedTokens({
+    accessToken: parsed.data.accessToken,
+    refreshToken: parsed.data.refreshToken
+  });
+  return true;
+};
+var buildSessionAuthHeaders = (accessToken) => ({
+  authorization: `Bearer ${accessToken}`
+});
+var buildCanonicalMessage = (method, pathWithQuery, body, timestamp, nonce) => {
+  const bodyHash = crypto$1.createHash("sha256").update(body ?? "").digest("hex");
+  return `${method}:${pathWithQuery}:${bodyHash}:${timestamp}:${nonce}`;
+};
+var buildAccountAuthHeaders = async (account, method, pathWithQuery, body) => {
+  const timestamp = Math.floor(Date.now() / 1e3).toString();
+  const nonce = crypto.randomUUID();
+  const message = buildCanonicalMessage(
+    method,
+    pathWithQuery,
+    body,
+    timestamp,
+    nonce
+  );
+  const signature = await account.signMessage({ message });
+  return {
+    "x-zero-address": account.address,
+    "x-zero-timestamp": timestamp,
+    "x-zero-nonce": nonce,
+    "x-zero-signature": signature
+  };
+};
+
+// src/transport/http.ts
+var RETRYABLE_STATUS = /* @__PURE__ */ new Set([408, 502, 503, 504]);
+var sleep = (ms, signal) => new Promise((resolve, reject) => {
+  if (signal?.aborted) {
+    reject(new DOMException("Aborted", "AbortError"));
+    return;
+  }
+  const timer = setTimeout(() => {
+    signal?.removeEventListener("abort", onAbort);
+    resolve();
+  }, ms);
+  const onAbort = () => {
+    clearTimeout(timer);
+    reject(new DOMException("Aborted", "AbortError"));
+  };
+  signal?.addEventListener("abort", onAbort, { once: true });
 });
+var buildPathWithQuery = (path, query) => {
+  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+  if (!query) return normalizedPath;
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value !== void 0) params.set(key, String(value));
+  }
+  const qs = params.toString();
+  return qs ? `${normalizedPath}?${qs}` : normalizedPath;
+};
+var joinUrl = (baseUrl, pathWithQuery) => {
+  const base3 = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+  return `${base3}${pathWithQuery}`;
+};
+var buildHeaders = async (client, method, pathWithQuery, hasBody, bodyStr) => {
+  const headers = { ...client.defaultHeaders };
+  if (hasBody) headers["content-type"] = "application/json";
+  headers["x-zero-sdk-version"] = SDK_VERSION;
+  if (client.apiVersion) headers["x-zero-api-version"] = client.apiVersion;
+  const credentials = client.getCredentials();
+  if (credentials.kind === "session") {
+    Object.assign(headers, buildSessionAuthHeaders(credentials.accessToken));
+  } else if (credentials.kind === "account") {
+    const signed = await buildAccountAuthHeaders(
+      credentials.account,
+      method,
+      pathWithQuery,
+      bodyStr
+    );
+    Object.assign(headers, signed);
+  }
+  return headers;
+};
+var parseErrorBody = async (response) => {
+  try {
+    return await response.clone().json();
+  } catch {
+    try {
+      return await response.text();
+    } catch {
+      return void 0;
+    }
+  }
+};
+var errorMessageFromBody = (body, status) => {
+  if (body !== null && typeof body === "object" && "error" in body && typeof body.error === "string") {
+    return body.error;
+  }
+  return `HTTP ${status}`;
+};
+var request = async (client, opts, schema) => {
+  const pathWithQuery = buildPathWithQuery(opts.path, opts.query);
+  const url = joinUrl(client.baseUrl, pathWithQuery);
+  const hasBody = opts.body !== void 0;
+  const bodyStr = hasBody ? JSON.stringify(
+    opts.body,
+    (_k, v) => typeof v === "bigint" ? v.toString() : v
+  ) : void 0;
+  const configuredFetch = buildConfiguredFetch(client);
+  const performOnce = async () => configuredFetch(url, {
+    method: opts.method,
+    headers: await buildHeaders(
+      client,
+      opts.method,
+      pathWithQuery,
+      hasBody,
+      bodyStr
+    ),
+    body: bodyStr,
+    signal: opts.signal
+  });
+  let refreshAttempted = false;
+  const executeWithRefresh = async () => {
+    const response = await performOnce();
+    if (response.status !== 401 || refreshAttempted) return response;
+    const credentials = client.getCredentials();
+    if (credentials.kind !== "session") return response;
+    refreshAttempted = true;
+    const refreshed = await client.refreshSessionOnce(opts.signal);
+    if (!refreshed) return response;
+    return await performOnce();
+  };
+  let lastNetworkError;
+  for (let attempt = 0; attempt <= client.maxRetries; attempt++) {
+    let response;
+    try {
+      response = await executeWithRefresh();
+    } catch (e) {
+      if (e instanceof ZeroError) throw e;
+      lastNetworkError = e;
+      if (attempt < client.maxRetries) {
+        try {
+          await sleep(2 ** attempt * 200, opts.signal);
+        } catch (sleepErr) {
+          throw new ZeroApiError("Request aborted by caller", {
+            status: 0,
+            cause: sleepErr
+          });
+        }
+        continue;
+      }
+      throw new ZeroApiError("Network request failed", {
+        status: 0,
+        cause: e
+      });
+    }
+    if (response.ok) {
+      let text;
+      try {
+        text = await response.text();
+      } catch (e) {
+        throw new ZeroApiError("Response body read failed", {
+          status: response.status,
+          cause: e
+        });
+      }
+      let json;
+      try {
+        json = JSON.parse(text);
+      } catch {
+      }
+      const parsed = schema.safeParse(json);
+      if (!parsed.success) {
+        throw new ZeroValidationError(
+          `Response did not match expected schema for ${opts.method} ${opts.path}`,
+          { cause: parsed.error, body: text }
+        );
+      }
+      return parsed.data;
+    }
+    if (RETRYABLE_STATUS.has(response.status) && attempt < client.maxRetries) {
+      try {
+        await sleep(2 ** attempt * 200, opts.signal);
+      } catch (sleepErr) {
+        throw new ZeroApiError("Request aborted by caller", {
+          status: 0,
+          cause: sleepErr
+        });
+      }
+      continue;
+    }
+    const errorBody = await parseErrorBody(response);
+    const requestId = response.headers.get("x-request-id") ?? void 0;
+    throw new ZeroApiError(errorMessageFromBody(errorBody, response.status), {
+      status: response.status,
+      requestId,
+      body: errorBody
+    });
+  }
+  throw new ZeroApiError("Exhausted retries", {
+    status: 0,
+    cause: lastNetworkError
+  });
+};
 
-// src/namespaces/runs.ts
-var Runs = class {
+// src/namespaces/auth-device.ts
+var AuthDevice = class {
   constructor(client) {
     this.client = client;
   }
-  create = (input, opts = {}) => request(
+  start = (opts = {}) => request(
     this.client,
     {
       method: "POST",
-      path: "/v1/runs",
-      body: input,
+      path: "/v1/auth/device/start",
       signal: opts.signal
     },
-    createRunResponseSchema
+    deviceStartResponseSchema
   );
-  list = (params = {}, opts = {}) => {
-    if (params.limit === 0) {
-      if (opts.signal?.aborted) {
-        return Promise.reject(
-          new ZeroApiError("Request aborted by caller", { status: 0 })
-        );
-      }
-      if (params.cursor === void 0) {
-        return Promise.reject(
-          new ZeroApiError(
-            "runs.list({ limit: 0 }) requires a cursor \u2014 without one the empty page is indistinguishable from end-of-stream",
-            { status: 0 }
-          )
-        );
-      }
-      return Promise.resolve({
-        runs: [],
-        nextCursor: params.cursor
-      });
-    }
-    const query = {};
-    if (params.capabilityId !== void 0)
-      query.capabilityId = params.capabilityId;
-    if (params.unreviewed !== void 0) query.unreviewed = params.unreviewed;
-    if (params.limit !== void 0) query.limit = params.limit;
-    if (params.cursor !== void 0) query.cursor = params.cursor;
-    return request(
+  poll = async (deviceCode, opts = {}) => {
+    const parsed = await request(
       this.client,
       {
-        method: "GET",
-        path: "/v1/runs",
-        query,
+        method: "POST",
+        path: "/v1/auth/device/poll",
+        body: { deviceCode },
         signal: opts.signal
       },
-      listRunsResponseSchema
+      devicePollResponseSchema
     );
+    if ("error" in parsed) {
+      return parsed.error === "authorization_pending" ? {
+        status: "pending",
+        userCode: parsed.userCode,
+        verificationUri: parsed.verificationUri
+      } : { status: "expired" };
+    }
+    return {
+      status: "ok",
+      accessToken: parsed.accessToken,
+      refreshToken: parsed.refreshToken,
+      expiresIn: parsed.expiresIn,
+      user: parsed.user
+    };
   };
-  get = (runId, opts = {}) => request(
-    this.client,
-    {
-      method: "GET",
-      path: `/v1/runs/${runId}`,
-      signal: opts.signal
-    },
-    runDetailSchema
-  );
-  review = (input, opts = {}) => request(
-    this.client,
-    {
-      method: "POST",
-      path: "/v1/reviews",
-      body: input,
-      signal: opts.signal
-    },
-    createReviewResponseSchema
-  );
-  // Bulk review submission. The CLI's bulk JSONL parser stays CLI-side —
-  // SDK consumers pass already-parsed structured input.
-  createReviewsBatch = (reviews, opts = {}) => request(
-    this.client,
-    {
-      method: "POST",
-      path: "/v1/reviews/batch",
-      body: { reviews },
-      signal: opts.signal
-    },
-    batchReviewResponseSchema
-  );
 };
-var USDC_BASE2 = "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913";
-var USDC_TEMPO2 = "0x20c000000000000000000000b9537d11c60e8b50";
-var TEMPO_CHAIN_ID2 = 4217;
-var baseChain = chains.base;
-var tempoChain2 = {
-  id: TEMPO_CHAIN_ID2,
-  name: "Tempo",
-  nativeCurrency: { name: "USD", symbol: "USD", decimals: 18 },
-  rpcUrls: {
-    default: { http: ["https://rpc.tempo.xyz"] }
-  }
+var userWalletsSchema = zod.z.array(userWalletDtoSchema);
+var normalizeMessage = (message) => {
+  if (typeof message === "string") return message;
+  if (typeof message.raw === "string") return message.raw;
+  return viem.bytesToHex(message.raw);
 };
-var ERC20_BALANCE_ABI2 = [
-  {
-    inputs: [{ name: "account", type: "address" }],
-    name: "balanceOf",
-    outputs: [{ name: "", type: "uint256" }],
-    stateMutability: "view",
-    type: "function"
+var repackageSignFailure = (err, op) => {
+  if (err instanceof ZeroApiError && err.status === 402) {
+    const body = err.body;
+    const detail = body && typeof body.error === "string" ? `: ${body.error}` : "";
+    throw new ZeroPaymentError(
+      `Sign endpoint refused ${op} (HTTP 402)${detail}`,
+      { cause: err }
+    );
   }
-];
-var USDC_DECIMALS = 6;
-
-// src/namespaces/wallet.ts
-var fundingUrlResponseSchema = zod.z.object({ url: zod.z.string() });
-var userWalletListSchema = zod.z.array(userWalletDtoSchema);
-var migrateAuthorizationResponseSchema = zod.z.object({
-  transactionHash: zod.z.string()
-});
-var errorMessage = (reason) => reason instanceof Error ? reason.message : String(reason);
-var Wallet = class {
+  throw err;
+};
+var Auth = class {
   constructor(client) {
     this.client = client;
+    this.device = new AuthDevice(client);
   }
-  clients = {};
-  // The configured wallet address, or null if the client wasn't constructed
-  // with an account. Stable read — does not hit the network.
-  get address() {
-    const credentials = this.client.getCredentials();
-    if (credentials.kind !== "account") return null;
-    return credentials.account.address;
-  }
-  balance = async (opts = {}) => {
-    const target = opts.address ?? this.address;
-    if (!target) {
-      throw new ZeroWalletError(
-        "balance() requires either an `address` option or a client constructed with an account"
-      );
-    }
-    const chain = opts.chain ?? "total";
-    if (chain !== "total") {
-      const raw = await this.readChainBalance(chain, target);
-      return { amount: viem.formatUnits(raw, USDC_DECIMALS), asset: "USDC" };
-    }
-    const chains = ["base", "tempo"];
-    const settled = await Promise.allSettled(
-      chains.map((c) => this.readChainBalance(c, target))
-    );
-    let sum = 0n;
-    const errors = [];
-    for (let i = 0; i < settled.length; i++) {
-      const result = settled[i];
-      const chainName = chains[i];
-      if (!result || !chainName) continue;
-      if (result.status === "fulfilled") {
-        sum += result.value;
-      } else {
-        errors.push({ chain: chainName, message: errorMessage(result.reason) });
-      }
-    }
-    if (errors.length === settled.length) {
-      throw new ZeroWalletError(
-        `balance() failed for every chain: ${errors.map((e) => `${e.chain} (${e.message})`).join(", ")}`
-      );
-    }
-    const balance = {
-      amount: viem.formatUnits(sum, USDC_DECIMALS),
-      asset: "USDC"
-    };
-    if (errors.length > 0) balance.errors = errors;
-    return balance;
-  };
-  // All wallets linked to the authenticated session user. Session-only.
-  list = (opts = {}) => request(
+  device;
+  // The internal (web-app facing) user profile. Richer than profile(): full
+  // wallet list with per-wallet delegation/signer/limit metadata.
+  me = (opts = {}) => request(
     this.client,
-    {
-      method: "GET",
-      path: "/v1/users/me/wallets",
-      signal: opts.signal
-    },
-    userWalletListSchema
+    { method: "GET", path: "/v1/users/me", signal: opts.signal },
+    internalUserDtoSchema
   );
-  // Provision a managed (Privy-embedded) wallet for the session user.
-  // Idempotent server-side — repeat calls return the existing wallet.
-  provision = (opts = {}) => request(
+  // The public (agent-facing) profile — identity + primary wallet address +
+  // balance + welcome-bonus, no per-wallet metadata. Same shape the MCP
+  // get_profile tool returns; rendered by `zero auth whoami`.
+  profile = (opts = {}) => request(
+    this.client,
+    { method: "GET", path: "/v1/users/me/profile", signal: opts.signal },
+    publicUserDtoSchema
+  );
+  // The user's wallets only. Lightweight sibling of `me()` for callers that
+  // just need wallet addresses (e.g. managed-account resolution on the pay
+  // path) — avoids the heavier internal-profile computation behind `me()`.
+  wallets = (opts = {}) => request(
     this.client,
-    {
-      method: "POST",
-      path: "/v1/users/me/wallets/provision",
-      signal: opts.signal
-    },
-    userWalletDtoSchema
+    { method: "GET", path: "/v1/users/me/wallets", signal: opts.signal },
+    userWalletsSchema
   );
-  // Relays a BYO-wallet-signed EIP-3009 ReceiveWithAuthorization, sweeping
-  // USDC from the BYO wallet to the user's Zero wallet on Base via the
-  // gas-paying relayer. The SDK does not author the authorization (chain
-  // nonce + EIP-712 domain coupling stays caller-side); it only forwards
-  // the signed payload. Session-only.
-  migrateAuthorization = (authorization, opts = {}) => request(
+  // Exchange an ephemeral session code (e.g. runner / sandbox handoff) for
+  // a session access token. The returned token has no refresh path — pair
+  // with `refreshToken: ""` when constructing the client.
+  exchangeSessionCode = (code, opts = {}) => request(
     this.client,
     {
       method: "POST",
-      path: "/v1/users/me/wallets/migrate",
-      body: { authorization },
+      path: "/v1/session/exchange",
+      body: { code },
       signal: opts.signal
     },
-    migrateAuthorizationResponseSchema
+    sessionExchangeResponseSchema
   );
-  // Routes by identity: account mode signs EIP-191 against /v1/wallet/fund-url,
-  // session mode hits /v1/users/me/fund-url (Bearer-authed, wallet resolved
-  // server-side). Both honor `provider` (coinbase | stripe).
-  fundingUrl = async (opts = {}) => {
-    const credentials = this.client.getCredentials();
-    const path = credentials.kind === "account" ? "/v1/wallet/fund-url" : credentials.kind === "session" ? "/v1/users/me/fund-url" : null;
-    if (!path) {
-      throw new ZeroWalletError(
-        "fundingUrl() requires a client constructed with an account or session credentials"
-      );
-    }
-    const query = {
-      provider: opts.provider ?? "coinbase"
-    };
-    if (opts.amount) query.amount = opts.amount;
-    const { url } = await request(
+  // Server-side revoke of the refresh token. Throws ZeroApiError on any
+  // non-2xx — callers that have already cleared local state (e.g. CLI
+  // logout) typically want to swallow with `.catch(() => {})` so a flaky
+  // server doesn't surface as a user-visible failure for a sign-out that
+  // already succeeded locally. Response body is opaque; schema is
+  // `z.unknown()` and the resolved value is discarded.
+  logout = async (refreshToken, opts = {}) => {
+    await request(
       this.client,
-      { method: "GET", path, query, signal: opts.signal },
-      fundingUrlResponseSchema
+      {
+        method: "POST",
+        path: "/v1/auth/logout",
+        body: { refreshToken },
+        signal: opts.signal
+      },
+      zod.z.unknown()
     );
-    return url;
   };
-  getPublicClient = (chain) => {
-    if (chain === "base") {
-      if (!this.clients.base) {
-        this.clients.base = viem.createPublicClient({
-          chain: baseChain,
-          transport: viem.http()
-        });
-      }
-      return this.clients.base;
+  // Force a session refresh. Routes through refreshSessionOnce() so a
+  // proactive call doesn't race a 401-driven transport refresh —
+  // concurrent POSTs with the same refresh token kill the session
+  // family (RFC 6819 token-theft response).
+  refresh = async () => {
+    const credentials = this.client.getCredentials();
+    if (credentials.kind !== "session") {
+      throw new ZeroAuthError(
+        "auth_no_credentials",
+        "refresh() requires the client to be constructed with a session \u2014 got credentials.kind=" + credentials.kind
+      );
     }
-    if (!this.clients.tempo) {
-      this.clients.tempo = viem.createPublicClient({
-        // biome-ignore lint/suspicious/noExplicitAny: tempo is a custom chain object that viem's stricter Chain type rejects shape-wise but accepts at runtime
-        chain: tempoChain2,
-        transport: viem.http()
-      });
+    const ok = await this.client.refreshSessionOnce();
+    if (!ok) {
+      throw new ZeroAuthError(
+        "auth_session_expired",
+        "Session refresh failed. The refresh token may be revoked or expired."
+      );
     }
-    return this.clients.tempo;
   };
-  /**
-   * @internal
-   *
-   * Per-chain USDC balance read. Exposed (rather than private) so unit
-   * tests can stub it without standing up a real viem public client —
-   * viem's `http()` transport doesn't go through `client.fetchImpl`, so
-   * the standard mock-fetch trick doesn't cover this path.
-   */
-  readChainBalance = async (chain, address) => {
-    const publicClient = this.getPublicClient(chain);
-    const tokenAddress = chain === "base" ? USDC_BASE2 : USDC_TEMPO2;
-    const balance = await publicClient.readContract({
-      address: tokenAddress,
-      abi: ERC20_BALANCE_ABI2,
-      functionName: "balanceOf",
-      args: [address]
-    });
-    return balance;
-  };
-};
-
-// src/options.ts
-var DEFAULT_BASE_URL = "https://api.zero.xyz";
-var DEFAULT_TIMEOUT_MS = 18e4;
-var DEFAULT_MAX_RETRIES = 2;
-
-// src/auth/credentials.ts
-var noopRefresh = async () => {
-};
-var MAX_402_PROBE_BYTES = 1024 * 1024;
-var MAX_RESPONSE_BYTES = 10 * 1024 * 1024;
-var TEXT_CONTENT_TYPES = [
-  "application/json",
-  "application/xml",
-  "application/javascript",
-  "application/ecmascript",
-  "application/x-www-form-urlencoded",
-  "text/",
-  "+json",
-  "+xml"
-];
-var MPP_SCHEME_TOKENS = /* @__PURE__ */ new Set(["payment", "mpp"]);
-var splitWwwAuthenticateChallenges = (header) => {
-  const chunks = [];
-  let buf = "";
-  let inQuotes = false;
-  for (let i = 0; i < header.length; i++) {
-    const ch = header[i];
-    if (inQuotes) {
-      if (ch === "\\" && i + 1 < header.length) {
-        buf += ch + header[i + 1];
-        i++;
-        continue;
-      }
-      if (ch === '"') inQuotes = false;
-      buf += ch;
-      continue;
-    }
-    if (ch === '"') {
-      inQuotes = true;
-      buf += ch;
-      continue;
+  signMessage = async (input, opts = {}) => {
+    const credentials = this.client.getCredentials();
+    if (credentials.kind === "account") {
+      return await credentials.account.signMessage({ message: input.message });
     }
-    if (ch === ",") {
-      chunks.push(buf);
-      buf = "";
-      continue;
+    if (credentials.kind === "session") {
+      try {
+        const parsed = await request(
+          this.client,
+          {
+            method: "POST",
+            path: "/v1/users/me/sign-message",
+            body: { message: normalizeMessage(input.message) }
+          },
+          signResponseSchema
+        );
+        this.assertSignerMatches(parsed.walletAddress, opts.expectedAddress);
+        return parsed.signature;
+      } catch (err) {
+        repackageSignFailure(err, "signMessage");
+      }
     }
-    buf += ch;
-  }
-  if (buf.length > 0) chunks.push(buf);
-  return chunks;
-};
-var isTextContentType = (contentType) => {
-  if (!contentType) return true;
-  const lower = contentType.toLowerCase();
-  return TEXT_CONTENT_TYPES.some((marker) => lower.includes(marker));
-};
-var redactUrl = (url) => {
-  try {
-    const u = new URL(url);
-    return `${u.origin}${u.pathname}`;
-  } catch {
-    return "<invalid url>";
-  }
-};
-var ECHO_DETECT_MIN_LEN = 16;
-var ECHO_DETECT_MAX_SCAN = 64 * 1024;
-var requestBodyEchoed = (candidate, requestBody) => {
-  if (requestBody === void 0) return false;
-  const asString = typeof requestBody === "string" ? requestBody : new TextDecoder("utf-8", { fatal: false }).decode(
-    requestBody.byteLength > ECHO_DETECT_MAX_SCAN ? requestBody.subarray(0, ECHO_DETECT_MAX_SCAN) : requestBody
-  );
-  if (asString.length < ECHO_DETECT_MIN_LEN) return false;
-  const scanLen = Math.min(asString.length, ECHO_DETECT_MAX_SCAN);
-  for (let i = 0; i + ECHO_DETECT_MIN_LEN <= scanLen; i++) {
-    if (candidate.includes(asString.slice(i, i + ECHO_DETECT_MIN_LEN))) {
-      return true;
+    throw new ZeroAuthError(
+      "auth_no_credentials",
+      "signMessage() requires the client to be constructed with `account` or `session`."
+    );
+  };
+  // Managed-only: BYO accounts sign locally via viem's account.signTransaction.
+  signTransaction = async (input, opts = {}) => {
+    const credentials = this.client.getCredentials();
+    if (credentials.kind === "session") {
+      try {
+        const parsed = await request(
+          this.client,
+          {
+            method: "POST",
+            path: "/v1/users/me/sign-transaction",
+            body: { unsignedTransaction: input.unsignedTransaction }
+          },
+          signResponseSchema
+        );
+        this.assertSignerMatches(parsed.walletAddress, opts.expectedAddress);
+        return parsed.signature;
+      } catch (err) {
+        repackageSignFailure(err, "signTransaction");
+      }
     }
-  }
-  return false;
-};
-var cancelBody2 = (response) => {
-  try {
-    response.body?.cancel().catch(() => {
-    });
-  } catch {
-  }
-};
-var detectPaymentRequirement = async (response) => {
-  if (response.status !== 402) return null;
-  const x402Header = response.headers.get("payment-required") ?? response.headers.get("x-payment-required");
-  if (x402Header) {
-    cancelBody2(response);
-    try {
-      const decoded = JSON.parse(
-        Buffer.from(x402Header, "base64").toString("utf8")
+    if (credentials.kind === "account") {
+      throw new ZeroAuthError(
+        "auth_error",
+        "signTransaction() is a managed-signing operation and is not supported in account mode. Sign locally with viem's account.signTransaction instead."
       );
-      return { protocol: "x402", raw: decoded };
-    } catch {
-      return { protocol: "x402", raw: { encoded: x402Header } };
     }
-  }
-  const declaredLen = Number.parseInt(
-    response.headers.get("content-length") ?? "",
-    10
-  );
-  const bodyFits = !Number.isFinite(declaredLen) || declaredLen <= MAX_402_PROBE_BYTES;
-  if (bodyFits) {
-    try {
-      const text = await readClippedText(response, MAX_402_PROBE_BYTES);
-      if (text) {
-        const parsed = JSON.parse(text);
-        if (looksLikeX402Body(parsed)) {
-          return { protocol: "x402", raw: parsed };
-        }
+    throw new ZeroAuthError(
+      "auth_no_credentials",
+      "signTransaction() requires session credentials (managed signing)."
+    );
+  };
+  signTypedData = async (input, opts = {}) => {
+    const credentials = this.client.getCredentials();
+    if (credentials.kind === "account") {
+      if (!credentials.account.signTypedData) {
+        throw new ZeroAuthError(
+          "auth_error",
+          "The configured viem account does not implement signTypedData."
+        );
       }
-    } catch {
+      return await credentials.account.signTypedData(input);
     }
-  }
-  const wwwAuth = response.headers.get("www-authenticate");
-  if (wwwAuth) {
-    const schemes = splitWwwAuthenticateChallenges(wwwAuth).map(
-      (challenge) => challenge.trim().split(/\s+/)[0]?.toLowerCase() ?? ""
-    );
-    if (schemes.some((scheme) => MPP_SCHEME_TOKENS.has(scheme))) {
-      cancelBody2(response);
-      return { protocol: "mpp", raw: { "www-authenticate": wwwAuth } };
+    if (credentials.kind === "session") {
+      try {
+        const parsed = await request(
+          this.client,
+          {
+            method: "POST",
+            path: "/v1/users/me/sign-typed-data",
+            body: { typedData: input }
+          },
+          signResponseSchema
+        );
+        this.assertSignerMatches(parsed.walletAddress, opts.expectedAddress);
+        return parsed.signature;
+      } catch (err) {
+        repackageSignFailure(err, "signTypedData");
+      }
     }
-  }
-  cancelBody2(response);
-  return { protocol: "unknown", raw: {} };
+    throw new ZeroAuthError(
+      "auth_no_credentials",
+      "signTypedData() requires the client to be constructed with `account` or `session`."
+    );
+  };
+  // Compare against the caller's pinned address (not shared cache) so
+  // concurrent pay()s can't race past each other. Mismatch → clear + throw;
+  // the caller's retry rebuilds against the new wallet.
+  assertSignerMatches = (serverAddr, expectedAddr) => {
+    if (!expectedAddr) return;
+    const canonicalServer = viem.getAddress(serverAddr);
+    const canonicalExpected = viem.getAddress(expectedAddr);
+    if (canonicalExpected === canonicalServer) return;
+    this.client.clearManagedAccount();
+    throw new ZeroAuthError(
+      "auth_error",
+      `Managed signing wallet changed (caller expected ${canonicalExpected}, server signed as ${canonicalServer}). Cache cleared \u2014 retry to rebuild against the current wallet.`
+    );
+  };
 };
-var readClippedBytes = async (response, max) => {
-  if (response.body === null) return new Uint8Array(0);
-  const reader = response.body.getReader();
-  const chunks = [];
-  let total = 0;
-  try {
-    while (total < max) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      if (!value) continue;
-      chunks.push(value);
-      total += value.byteLength;
-    }
-  } finally {
-    try {
-      await reader.cancel();
-    } catch {
-    }
-  }
-  const merged = new Uint8Array(Math.min(total, max));
-  let offset = 0;
-  for (const c of chunks) {
-    const take = Math.min(c.byteLength, max - offset);
-    merged.set(c.subarray(0, take), offset);
-    offset += take;
-    if (offset >= max) break;
+var BUG_REPORT_CATEGORIES = [
+  "search_relevance",
+  "ranking_issue",
+  "missing_capability",
+  "wrong_schema",
+  "misleading_description",
+  "broken_execution",
+  "payment_failure",
+  "billing_anomaly",
+  "cli_bug",
+  "security",
+  "other"
+];
+var createBugReportResponseSchema = zod.z.object({
+  bugReportId: zod.z.string(),
+  status: zod.z.string(),
+  deduped: zod.z.boolean(),
+  category: zod.z.enum(BUG_REPORT_CATEGORIES).nullable(),
+  title: zod.z.string().nullable(),
+  attached: zod.z.object({
+    capabilityId: zod.z.number().nullable(),
+    runId: zod.z.number().nullable(),
+    searchId: zod.z.number().nullable()
+  })
+});
+
+// src/namespaces/bug-reports.ts
+var BugReports = class {
+  constructor(client) {
+    this.client = client;
   }
-  return merged;
-};
-var readClippedText = async (response, max) => {
-  const bytes = await readClippedBytes(response, max);
-  return new TextDecoder().decode(bytes);
+  // POST /v1/bug-reports. Wallet-attributed server-side; the SDK client's
+  // active credential drives attribution (account-mode → EIP-191 from the
+  // wallet, session-mode → Bearer + server resolves the user's wallet).
+  create = (input, opts = {}) => request(
+    this.client,
+    {
+      method: "POST",
+      path: "/v1/bug-reports",
+      body: input,
+      signal: opts.signal
+    },
+    createBugReportResponseSchema
+  );
 };
-var parseResponseBody = async (response, max) => {
-  const contentType = response.headers.get("content-type");
-  const bytes = await readClippedBytes(response, max + 1);
-  const truncated = bytes.byteLength > max;
-  const view = truncated ? bytes.subarray(0, max) : bytes;
-  const buf = Buffer.from(view.buffer, view.byteOffset, view.byteLength);
-  if (!isTextContentType(contentType)) {
-    const base64 = buf.toString("base64");
-    return {
-      body: base64,
-      bodyRaw: base64,
-      bodyEncoding: "base64",
-      truncated
-    };
+var ratingSchema = zod.z.object({
+  score: zod.z.string(),
+  successRate: zod.z.string(),
+  reviews: zod.z.number(),
+  stars: zod.z.string().nullable().optional(),
+  state: zod.z.enum(["unrated", "rated"]).optional()
+});
+
+// src/schemas/capabilities.ts
+var capabilityResponseSchema = zod.z.object({
+  uid: zod.z.string(),
+  slug: zod.z.string(),
+  name: zod.z.string(),
+  description: zod.z.string(),
+  url: zod.z.string(),
+  urlTemplate: zod.z.string().nullable().optional(),
+  method: zod.z.string(),
+  headers: zod.z.record(zod.z.string(), zod.z.string()).nullable(),
+  bodySchema: zod.z.record(zod.z.string(), zod.z.unknown()).nullable(),
+  responseSchema: zod.z.record(zod.z.string(), zod.z.unknown()).nullable(),
+  example: zod.z.object({ request: zod.z.unknown(), response: zod.z.unknown() }).nullable(),
+  tags: zod.z.array(zod.z.string()).nullable(),
+  exampleAgentPrompt: zod.z.string().nullable().optional(),
+  whatItDoes: zod.z.string().nullable().optional(),
+  resultDescription: zod.z.string().nullable().optional(),
+  failureModes: zod.z.array(zod.z.string()).nullable().optional(),
+  whenToPreferThis: zod.z.string().nullable().optional(),
+  // Agent-facing execution guide (markdown). Covers usage patterns, input
+  // field guidance, cross-cap composition, and known failure modes.
+  // Named after MCP tool convention: description = what it is, instructions = how to use it.
+  instructions: zod.z.string().nullable().optional(),
+  displayCostAmount: zod.z.string(),
+  displayCostAsset: zod.z.string(),
+  reviewCount: zod.z.number(),
+  rating: ratingSchema,
+  priceObserved: zod.z.object({
+    minCents: zod.z.string().nullable(),
+    medianCents: zod.z.string().nullable(),
+    maxCents: zod.z.string().nullable(),
+    // Deprecated alias for maxCents; kept for back-compat with older
+    // API versions that still emit it.
+    p95Cents: zod.z.string().nullable(),
+    sampleCount: zod.z.number(),
+    varies: zod.z.boolean(),
+    failureChargeRate: zod.z.number().nullable()
+  }).nullable().optional(),
+  paymentMethods: zod.z.array(
+    zod.z.object({
+      uid: zod.z.string(),
+      protocol: zod.z.string(),
+      methodType: zod.z.string(),
+      chain: zod.z.string().nullable(),
+      mode: zod.z.string(),
+      costAmount: zod.z.string(),
+      costPer: zod.z.string(),
+      priority: zod.z.number()
+    })
+  ).nullable(),
+  availabilityStatus: zod.z.enum(["healthy", "unknown", "down"]).nullable().optional(),
+  /**
+   * @deprecated The API no longer emits `displayStatus`; it has been replaced
+   * by the consolidated 3-value {@link capabilityResponseSchema.shape.availabilityStatus}.
+   * Kept as an optional field for one release for back-compat (ZERO-89 soft
+   * migration) and will be removed in the next major version.
+   */
+  displayStatus: zod.z.enum(["healthy", "stable", "degraded", "unhealthy", "unknown"]).optional(),
+  activationCount: zod.z.number().optional(),
+  lastUsedAt: zod.z.string().nullable().optional(),
+  lastSuccessfullyRanAt: zod.z.string().nullable().optional()
+});
+var resolveCapabilityResponseSchema = zod.z.object({
+  capabilityId: zod.z.string(),
+  capabilitySlug: zod.z.string(),
+  matchedVia: zod.z.enum(["exact", "template"])
+});
+
+// src/namespaces/capabilities.ts
+var Capabilities = class {
+  constructor(client) {
+    this.client = client;
   }
-  const text = buf.toString("utf8");
-  if (contentType?.toLowerCase().includes("json")) {
+  get = (id, opts = {}) => request(
+    this.client,
+    {
+      method: "GET",
+      path: `/v1/capabilities/${encodeURIComponent(id)}`,
+      query: opts.searchId ? { searchId: opts.searchId } : void 0,
+      signal: opts.signal
+    },
+    capabilityResponseSchema
+  );
+  // Resolve a raw endpoint URL + method back to the capability that owns it,
+  // for the `zero fetch <url>` case where the client has no local search
+  // context to match against (a memoized/cross-session URL). Returns null on
+  // 404 — i.e. no match or an ambiguous multi-match, both of which the server
+  // reports as 404 (resolveByUrl fails closed rather than mis-attribute).
+  // The URL travels in the POST body so it stays out of access logs and is
+  // never stored; the caller uses the returned capabilityId to record an
+  // attributed run without the URL ever touching the run row (ZERO-335).
+  resolveByUrl = async (url, method, opts = {}) => {
     try {
-      return { body: JSON.parse(text), bodyRaw: text, truncated };
-    } catch {
+      return await request(
+        this.client,
+        {
+          method: "POST",
+          path: "/v1/capabilities/resolve",
+          body: { url, method },
+          signal: opts.signal
+        },
+        resolveCapabilityResponseSchema
+      );
+    } catch (err) {
+      if (err instanceof ZeroApiError && err.status === 404) return null;
+      throw err;
     }
-  }
-  return { body: text, bodyRaw: text, truncated };
-};
-var UPSTREAM_ERROR_FIELDS = [
-  "error",
-  "message",
-  "detail",
-  "reason",
-  "error_description"
-];
-var UPSTREAM_ERROR_MAX_LEN = 200;
-var ERROR_SNIPPET_BYTES = 500;
-var clampUpstreamMessage = (value) => {
-  const trimmed = value.trim();
-  if (!trimmed) return void 0;
-  return trimmed.length > UPSTREAM_ERROR_MAX_LEN ? `${trimmed.slice(0, UPSTREAM_ERROR_MAX_LEN)}\u2026` : trimmed;
-};
-var tryParseJson = (text) => {
-  try {
-    return JSON.parse(text);
-  } catch {
-    return null;
-  }
+  };
 };
-var extractUpstreamErrorMessage = (body) => {
-  const parsed = tryParseJson(body);
-  if (parsed === null || typeof parsed !== "object") {
-    return clampUpstreamMessage(body);
+var createRunResponseSchema = zod.z.object({
+  runId: zod.z.string()
+});
+var runListItemSchema = zod.z.object({
+  uid: zod.z.string(),
+  capabilityUid: zod.z.string(),
+  capabilitySlug: zod.z.string(),
+  capabilityName: zod.z.string(),
+  status: zod.z.number().nullable(),
+  latencyMs: zod.z.number().nullable(),
+  cost: zod.z.object({ amount: zod.z.string(), asset: zod.z.string().nullable() }).nullable(),
+  payment: zod.z.object({
+    protocol: zod.z.string(),
+    chain: zod.z.string().nullable(),
+    txHash: zod.z.string().nullable(),
+    mode: zod.z.string().nullable()
+  }).nullable(),
+  createdAt: zod.z.coerce.date(),
+  reviewed: zod.z.boolean()
+});
+var listRunsResponseSchema = zod.z.object({
+  runs: zod.z.array(runListItemSchema),
+  nextCursor: zod.z.string().nullable()
+});
+var runDetailSchema = zod.z.object({
+  runId: zod.z.string(),
+  status: zod.z.number().nullable(),
+  latencyMs: zod.z.number().nullable(),
+  errorClass: zod.z.string().nullable(),
+  createdAt: zod.z.coerce.date(),
+  cost: zod.z.object({ amount: zod.z.string(), asset: zod.z.string().nullable() }).nullable(),
+  payment: zod.z.object({
+    protocol: zod.z.string(),
+    chain: zod.z.string().nullable(),
+    txHash: zod.z.string().nullable(),
+    mode: zod.z.string().nullable()
+  }).nullable(),
+  capability: zod.z.object({
+    uid: zod.z.string(),
+    slug: zod.z.string(),
+    name: zod.z.string(),
+    url: zod.z.string(),
+    method: zod.z.string(),
+    whatItDoes: zod.z.string().nullable(),
+    tags: zod.z.array(zod.z.string())
+  }),
+  reviewed: zod.z.boolean()
+});
+var createReviewResponseSchema = zod.z.object({
+  reviewId: zod.z.string(),
+  recorded: zod.z.boolean(),
+  updated: zod.z.boolean().optional()
+});
+var batchReviewResponseSchema = zod.z.object({
+  results: zod.z.array(
+    zod.z.union([
+      zod.z.object({
+        runId: zod.z.string(),
+        ok: zod.z.literal(true),
+        reviewId: zod.z.string(),
+        updated: zod.z.boolean()
+      }),
+      zod.z.object({
+        runId: zod.z.string(),
+        ok: zod.z.literal(false),
+        status: zod.z.number(),
+        error: zod.z.string()
+      })
+    ])
+  ),
+  summary: zod.z.object({
+    total: zod.z.number(),
+    ok: zod.z.number(),
+    failed: zod.z.number()
+  })
+});
+
+// src/namespaces/runs.ts
+var Runs = class {
+  constructor(client) {
+    this.client = client;
   }
-  const record = parsed;
-  for (const field of UPSTREAM_ERROR_FIELDS) {
-    const value = record[field];
-    if (typeof value === "string" && value.length > 0) {
-      return clampUpstreamMessage(value);
-    }
-    if (value && typeof value === "object") {
-      const nested = value.message;
-      if (typeof nested === "string" && nested.length > 0) {
-        return clampUpstreamMessage(nested);
+  create = (input, opts = {}) => request(
+    this.client,
+    {
+      method: "POST",
+      path: "/v1/runs",
+      body: input,
+      signal: opts.signal
+    },
+    createRunResponseSchema
+  );
+  list = (params = {}, opts = {}) => {
+    if (params.limit === 0) {
+      if (opts.signal?.aborted) {
+        return Promise.reject(
+          new ZeroApiError("Request aborted by caller", { status: 0 })
+        );
+      }
+      if (params.cursor === void 0) {
+        return Promise.reject(
+          new ZeroApiError(
+            "runs.list({ limit: 0 }) requires a cursor \u2014 without one the empty page is indistinguishable from end-of-stream",
+            { status: 0 }
+          )
+        );
       }
+      return Promise.resolve({
+        runs: [],
+        nextCursor: params.cursor
+      });
     }
-  }
-  return void 0;
-};
-var buildUpstreamError = (status, bodyRaw, bodyEncoding) => {
-  if (status >= 200 && status < 300) return void 0;
-  if (bodyRaw === null || bodyRaw.length === 0) return void 0;
-  if (bodyEncoding === "base64") return void 0;
-  const snippet = bodyRaw.slice(0, ERROR_SNIPPET_BYTES);
-  return {
-    status,
-    message: extractUpstreamErrorMessage(bodyRaw),
-    snippetHash: crypto$1.createHash("sha256").update(snippet).digest("hex"),
-    snippetLength: snippet.length
-  };
-};
-var computeOutcome = (status, payment, warnings) => {
-  if (warnings.includes(FETCH_WARNINGS.mppSessionCloseFailed))
-    return "payment_close_failed";
-  if (status === 402 && payment !== null) return "payment_rejected";
-  if (status === 402) return "payment_failed";
-  if (status >= 400) return "server_error";
-  return "success";
-};
-var errorFetchResult = (startedAt, error, skipReason, capabilityIdRequested, outcome, status = null) => {
-  const result = {
-    runId: null,
-    ok: false,
-    status,
-    latencyMs: Date.now() - startedAt,
-    payment: null,
-    outcome,
-    body: null,
-    bodyRaw: null,
-    error
+    const query = {};
+    if (params.capabilityId !== void 0)
+      query.capabilityId = params.capabilityId;
+    if (params.unreviewed !== void 0) query.unreviewed = params.unreviewed;
+    if (params.limit !== void 0) query.limit = params.limit;
+    if (params.cursor !== void 0) query.cursor = params.cursor;
+    return request(
+      this.client,
+      {
+        method: "GET",
+        path: "/v1/runs",
+        query,
+        signal: opts.signal
+      },
+      listRunsResponseSchema
+    );
   };
-  if (capabilityIdRequested) result.runTrackingSkipped = [skipReason];
-  return result;
-};
-var resolveRecordingClient = (client, opts) => {
-  const credentials = client.getCredentials();
-  const recordingClient = opts.account ? client.withAccount(opts.account) : client;
-  const canRecord = opts.account !== void 0 || credentials.kind === "account" || credentials.kind === "session";
-  return { recordingClient, canRecord };
-};
-var recordErrorFetchRun = async (client, opts, result, capabilityIdOverride) => {
-  const effectiveCapId = opts.capabilityId;
-  if (effectiveCapId === void 0) return;
-  const { recordingClient, canRecord } = resolveRecordingClient(client, opts);
-  if (!canRecord) return;
-  const fetchOriginForRecord = opts.capabilityId === void 0 ? "direct_url" : opts.fetchOrigin;
-  try {
-    const created = await recordingClient.runs.create({
-      capabilityId: effectiveCapId,
-      ...opts.searchId && { searchId: opts.searchId },
-      ...fetchOriginForRecord && { fetchOrigin: fetchOriginForRecord },
-      ...result.status !== null && { status: result.status },
-      latencyMs: result.latencyMs,
-      ...opts.requestSchema && { requestSchema: opts.requestSchema }
-    });
-    result.runId = created.runId;
-    delete result.runTrackingSkipped;
-  } catch {
-  }
-};
-var recordTimeoutRun = async (client, opts, err, startedAt, capabilityIdRequested, capabilityIdOverride) => {
-  const result = errorFetchResult(
-    startedAt,
-    err.message,
-    "timeout",
-    capabilityIdRequested,
-    "network_error"
+  get = (runId, opts = {}) => request(
+    this.client,
+    {
+      method: "GET",
+      path: `/v1/runs/${runId}`,
+      signal: opts.signal
+    },
+    runDetailSchema
+  );
+  review = (input, opts = {}) => request(
+    this.client,
+    {
+      method: "POST",
+      path: "/v1/reviews",
+      body: input,
+      signal: opts.signal
+    },
+    createReviewResponseSchema
+  );
+  // Bulk review submission. The CLI's bulk JSONL parser stays CLI-side —
+  // SDK consumers pass already-parsed structured input.
+  createReviewsBatch = (reviews, opts = {}) => request(
+    this.client,
+    {
+      method: "POST",
+      path: "/v1/reviews/batch",
+      body: { reviews },
+      signal: opts.signal
+    },
+    batchReviewResponseSchema
   );
-  await recordErrorFetchRun(client, opts, result);
 };
-var sniffJsonShapeBytes = (buf) => {
-  let i = 0;
-  if (buf.length >= 3 && buf[0] === 239 && buf[1] === 187 && buf[2] === 191) {
-    i = 3;
-  }
-  while (i < buf.length && (buf[i] === 32 || buf[i] === 9 || buf[i] === 10 || buf[i] === 13)) {
-    i++;
+var USDC_BASE2 = "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913";
+var USDC_TEMPO2 = "0x20c000000000000000000000b9537d11c60e8b50";
+var TEMPO_CHAIN_ID2 = 4217;
+var baseChain = chains.base;
+var tempoChain2 = {
+  id: TEMPO_CHAIN_ID2,
+  name: "Tempo",
+  nativeCurrency: { name: "USD", symbol: "USD", decimals: 18 },
+  rpcUrls: {
+    default: { http: ["https://rpc.tempo.xyz"] }
   }
-  if (i >= buf.length) return false;
-  return buf[i] === 123 || buf[i] === 91;
 };
-var withDefaultContentType = (headers, body) => {
-  if (!headers && body === void 0) return void 0;
-  const next = headers ? { ...headers } : {};
-  if (body === void 0) return next;
-  const hasContentType = Object.keys(next).some(
-    (k) => k.toLowerCase() === "content-type"
-  );
-  if (!hasContentType) {
-    next["content-type"] = typeof body === "string" || sniffJsonShapeBytes(body) ? "application/json" : "application/octet-stream";
+var ERC20_BALANCE_ABI2 = [
+  {
+    inputs: [{ name: "account", type: "address" }],
+    name: "balanceOf",
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
   }
-  return next;
-};
-var clientFetch = async (client, url, opts = {}) => {
-  const startedAt = Date.now();
-  const capabilityIdRequested = opts.capabilityId !== void 0;
-  const normalized = normalizeTransportEnvelopeRequest(url, {
-    method: opts.method,
-    body: opts.body
-  });
-  const requestUrl = normalized.url;
-  const requestBody = normalized.body;
-  const method = normalized.method ?? (requestBody !== void 0 ? "POST" : "GET");
-  const { canRecord: canRecordForResolve } = resolveRecordingClient(
-    client,
-    opts
-  );
-  const resolvePromise = !capabilityIdRequested && canRecordForResolve ? client.capabilities.resolveByUrl(redactUrl(requestUrl), method).catch(() => null) : Promise.resolve(null);
-  const probeHeaders = withDefaultContentType(opts.headers, requestBody);
-  const requestInit = {
-    method,
-    headers: probeHeaders,
-    body: requestBody,
-    signal: opts.signal
-  };
-  const configuredFetch = buildConfiguredFetch(client, {
-    timeoutMs: opts.timeoutMs
-  });
-  let response;
-  let payment = null;
-  const skipReasons = [];
-  const warnings = [];
-  try {
-    response = await configuredFetch(requestUrl, requestInit);
-  } catch (err) {
-    if (err instanceof ZeroTimeoutError) {
-      await recordTimeoutRun(
-        client,
-        opts,
-        err,
-        startedAt,
-        capabilityIdRequested
-      );
-      throw err;
-    }
-    if (err instanceof ZeroError) throw err;
-    const errMessage = err instanceof Error ? err.message : String(err);
-    const result2 = errorFetchResult(
-      startedAt,
-      errMessage,
-      "fetch_failed_before_response",
-      capabilityIdRequested,
-      "network_error"
-    );
-    await recordErrorFetchRun(client, opts, result2);
-    return result2;
+];
+var USDC_DECIMALS = 6;
+
+// src/namespaces/wallet.ts
+var fundingUrlResponseSchema = zod.z.object({ url: zod.z.string() });
+var userWalletListSchema = zod.z.array(userWalletDtoSchema);
+var migrateAuthorizationResponseSchema = zod.z.object({
+  transactionHash: zod.z.string()
+});
+var errorMessage = (reason) => reason instanceof Error ? reason.message : String(reason);
+var Wallet = class {
+  constructor(client) {
+    this.client = client;
   }
-  if (response.status === 402) {
-    const requirement = await detectPaymentRequirement(response);
-    if (requirement?.protocol === "x402" || requirement?.protocol === "mpp") {
-      const payCall = requirement.protocol === "x402" ? client.payments.pay : client.payments.payMpp;
-      try {
-        const paid = await payCall({
-          url: requestUrl,
-          method,
-          // Fresh clone for the paid retry — same rationale as
-          // the probe-side clone above. Re-derives the default
-          // Content-Type so the paid leg matches the probe.
-          headers: withDefaultContentType(opts.headers, requestBody),
-          body: requestBody,
-          maxPay: opts.maxPay,
-          account: opts.account,
-          signal: opts.signal,
-          timeoutMs: opts.timeoutMs,
-          ...opts.displayCostAmount && {
-            displayCostAmount: opts.displayCostAmount
-          }
-        });
-        response = paid.response;
-        payment = paid.payment;
-        if (paid.warnings) warnings.push(...paid.warnings);
-      } catch (err) {
-        if (err instanceof ZeroSessionCloseFailedError) {
-          response = err.response;
-          payment = {
-            protocol: "mpp",
-            chain: tempoChainLabelFromId(err.session.chainId),
-            txHash: null,
-            amount: err.capturedAmount,
-            asset: "USDC",
-            session: err.session
-          };
-          warnings.push(FETCH_WARNINGS.mppSessionCloseFailed);
-        } else if (err instanceof ZeroInsufficientFundsError) {
-          return errorFetchResult(
-            startedAt,
-            err.message,
-            FETCH_SKIP_REASONS.insufficientFunds,
-            capabilityIdRequested,
-            "insufficient_funds",
-            null
-          );
-        } else if (err instanceof ZeroPaymentError || err instanceof ZeroAuthError) {
-          const result2 = errorFetchResult(
-            startedAt,
-            err.message,
-            "payment_failed",
-            capabilityIdRequested,
-            "payment_failed",
-            402
-          );
-          await recordErrorFetchRun(client, opts, result2);
-          return result2;
-        } else if (err instanceof ZeroTimeoutError) {
-          await recordTimeoutRun(
-            client,
-            opts,
-            err,
-            startedAt,
-            capabilityIdRequested
-          );
-          throw err;
-        } else {
-          throw err;
-        }
-      }
-    } else if (requirement?.protocol === "unknown") {
-      const result2 = errorFetchResult(
-        startedAt,
-        "Capability returned 402 with an unrecognized payment protocol. Neither x402 nor MPP markers were detected in the response headers or body.",
-        "unrecognized_402_protocol",
-        capabilityIdRequested,
-        "payment_failed",
-        402
-      );
-      await recordErrorFetchRun(client, opts, result2);
-      return result2;
-    }
+  clients = {};
+  // The configured wallet address, or null if the client wasn't constructed
+  // with an account. Stable read — does not hit the network.
+  get address() {
+    const credentials = this.client.getCredentials();
+    if (credentials.kind !== "account") return null;
+    return credentials.account.address;
   }
-  const latencyMs = Date.now() - startedAt;
-  const maxResponseBytes = opts.maxResponseBytes ?? MAX_RESPONSE_BYTES;
-  let body;
-  let bodyRaw;
-  let bodyEncoding;
-  try {
-    const parsed = await parseResponseBody(response, maxResponseBytes);
-    body = parsed.body;
-    bodyRaw = parsed.bodyRaw;
-    bodyEncoding = parsed.bodyEncoding;
-    if (parsed.truncated) warnings.push(FETCH_WARNINGS.bodyTruncated);
-  } catch (err) {
-    if (err instanceof Error && err.name === "AbortError") {
-      throw new ZeroApiError("Request aborted by caller", {
-        status: 0,
-        cause: err
-      });
+  balance = async (opts = {}) => {
+    const target = opts.address ?? this.address;
+    if (!target) {
+      throw new ZeroWalletError(
+        "balance() requires either an `address` option or a client constructed with an account"
+      );
     }
-    const message = err instanceof Error ? err.message : String(err);
-    const skips = [];
-    const settledLocally = paymentHasAnchor(payment);
-    if (settledLocally && response.status === 402) {
-      warnings.push(FETCH_WARNINGS.paidButStill402NotRecorded);
-      skips.push(FETCH_WARNINGS.paidButStill402NotRecorded);
+    const chain = opts.chain ?? "total";
+    if (chain !== "total") {
+      const raw = await this.readChainBalance(chain, target);
+      return { amount: viem.formatUnits(raw, USDC_DECIMALS), asset: "USDC" };
     }
-    if (payment !== null && !settledLocally) {
-      warnings.push(FETCH_WARNINGS.paymentSettlementUnconfirmed);
-      skips.push(FETCH_WARNINGS.paymentSettlementUnconfirmed);
+    const chains = ["base", "tempo"];
+    const settled = await Promise.allSettled(
+      chains.map((c) => this.readChainBalance(c, target))
+    );
+    let sum = 0n;
+    const errors = [];
+    for (let i = 0; i < settled.length; i++) {
+      const result = settled[i];
+      const chainName = chains[i];
+      if (!result || !chainName) continue;
+      if (result.status === "fulfilled") {
+        sum += result.value;
+      } else {
+        errors.push({ chain: chainName, message: errorMessage(result.reason) });
+      }
     }
-    if (payment !== null && payment.amount === "unknown") {
-      warnings.push(FETCH_WARNINGS.paymentAmountUnknown);
+    if (errors.length === settled.length) {
+      throw new ZeroWalletError(
+        `balance() failed for every chain: ${errors.map((e) => `${e.chain} (${e.message})`).join(", ")}`
+      );
     }
-    skips.push(FETCH_SKIP_REASONS.bodyReadFailed);
-    const result2 = {
-      runId: null,
-      ok: false,
-      status: response.status,
-      latencyMs: Date.now() - startedAt,
-      payment,
-      outcome: computeOutcome(response.status, payment, warnings),
-      body: null,
-      bodyRaw: null,
-      error: message
+    const balance = {
+      amount: viem.formatUnits(sum, USDC_DECIMALS),
+      asset: "USDC"
     };
-    if (capabilityIdRequested) result2.runTrackingSkipped = skips;
-    if (warnings.length > 0) result2.warnings = warnings;
-    return result2;
-  }
-  const settled = paymentHasAnchor(payment);
-  const paidButStill402 = settled && response.status === 402;
-  const settlementUnconfirmed = payment !== null && !settled;
-  if (paidButStill402) warnings.push(FETCH_WARNINGS.paidButStill402NotRecorded);
-  if (settlementUnconfirmed)
-    warnings.push(FETCH_WARNINGS.paymentSettlementUnconfirmed);
-  if (payment !== null && payment.amount === "unknown") {
-    warnings.push(FETCH_WARNINGS.paymentAmountUnknown);
-  }
-  let runId = null;
-  const closeFailed = warnings.includes(FETCH_WARNINGS.mppSessionCloseFailed);
-  const upstreamErrorForRecord = buildUpstreamError(
-    response.status,
-    bodyRaw,
-    bodyEncoding
+    if (errors.length > 0) balance.errors = errors;
+    return balance;
+  };
+  // All wallets linked to the authenticated session user. Session-only.
+  list = (opts = {}) => request(
+    this.client,
+    {
+      method: "GET",
+      path: "/v1/users/me/wallets",
+      signal: opts.signal
+    },
+    userWalletListSchema
   );
-  if (capabilityIdRequested) {
-    if (paidButStill402)
-      skipReasons.push(FETCH_WARNINGS.paidButStill402NotRecorded);
-    else if (closeFailed)
-      skipReasons.push(FETCH_SKIP_REASONS.mppSessionCloseFailedNotRecorded);
-  }
-  const resolvedCap = await resolvePromise;
-  const effectiveCapabilityId = opts.capabilityId ?? resolvedCap?.capabilityId;
-  const capabilityResolution = !capabilityIdRequested && canRecordForResolve ? resolvedCap !== null ? {
-    resolved: true,
-    capabilityId: resolvedCap.capabilityId,
-    capabilitySlug: resolvedCap.capabilitySlug,
-    matchedVia: resolvedCap.matchedVia
-  } : { resolved: false } : void 0;
-  if (effectiveCapabilityId !== void 0 && !paidButStill402 && !closeFailed) {
-    const { recordingClient, canRecord } = resolveRecordingClient(client, opts);
-    if (!canRecord) {
-      skipReasons.push("no_credentials");
-    } else {
-      const knownAmount = payment !== null && payment.amount !== "unknown";
-      try {
-        let derived;
-        if (opts.deriveRunMetadata) {
-          try {
-            derived = opts.deriveRunMetadata({
-              status: response.status,
-              ok: response.ok,
-              bodyRaw,
-              ...bodyEncoding && { bodyEncoding }
-            });
-          } catch {
-          }
-        }
-        const result2 = await recordingClient.runs.create({
-          capabilityId: effectiveCapabilityId,
-          searchId: opts.searchId,
-          // Auto-resolved runs are always direct_url — they only fire when
-          // no capabilityId was supplied (the direct_url path by definition).
-          ...opts.capabilityId === void 0 ? { fetchOrigin: "direct_url" } : opts.fetchOrigin && { fetchOrigin: opts.fetchOrigin },
-          status: response.status,
-          latencyMs,
-          ...opts.requestSchema && { requestSchema: opts.requestSchema },
-          ...derived?.responseSchema && {
-            responseSchema: derived.responseSchema
-          },
-          ...upstreamErrorForRecord && {
-            errorSnippetHash: upstreamErrorForRecord.snippetHash,
-            errorSnippetLength: upstreamErrorForRecord.snippetLength
-          },
-          ...payment && {
-            ...knownAmount && {
-              costAmount: payment.amount,
-              costAsset: payment.asset
-            },
-            paymentProtocol: payment.protocol,
-            paymentChain: payment.chain,
-            paymentTxHash: payment.txHash ?? void 0,
-            paymentMode: payment.session ? "session" : "charge"
-          }
-        });
-        runId = result2.runId;
-      } catch (err) {
-        const errorMessage2 = err instanceof Error ? err.message : String(err);
-        const code = err instanceof ZeroError ? err.code : void 0;
-        const skipMsg = code ? `run_create_failed:${code}: ${errorMessage2}` : `run_create_failed: ${errorMessage2}`;
-        skipReasons.push(skipMsg);
-        client.logger?.({
-          level: "warn",
-          message: "Failed to record run for fetch",
-          meta: {
-            url: redactUrl(url),
-            capabilityId: effectiveCapabilityId,
-            error: errorMessage2,
-            errorCode: code
-          }
+  // Provision a managed (Privy-embedded) wallet for the session user.
+  // Idempotent server-side — repeat calls return the existing wallet.
+  provision = (opts = {}) => request(
+    this.client,
+    {
+      method: "POST",
+      path: "/v1/users/me/wallets/provision",
+      signal: opts.signal
+    },
+    userWalletDtoSchema
+  );
+  // Relays a BYO-wallet-signed EIP-3009 ReceiveWithAuthorization, sweeping
+  // USDC from the BYO wallet to the user's Zero wallet on Base via the
+  // gas-paying relayer. The SDK does not author the authorization (chain
+  // nonce + EIP-712 domain coupling stays caller-side); it only forwards
+  // the signed payload. Session-only.
+  migrateAuthorization = (authorization, opts = {}) => request(
+    this.client,
+    {
+      method: "POST",
+      path: "/v1/users/me/wallets/migrate",
+      body: { authorization },
+      signal: opts.signal
+    },
+    migrateAuthorizationResponseSchema
+  );
+  // Routes by identity: account mode signs EIP-191 against /v1/wallet/fund-url,
+  // session mode hits /v1/users/me/fund-url (Bearer-authed, wallet resolved
+  // server-side). Both honor `provider` (coinbase | stripe).
+  fundingUrl = async (opts = {}) => {
+    const credentials = this.client.getCredentials();
+    const path = credentials.kind === "account" ? "/v1/wallet/fund-url" : credentials.kind === "session" ? "/v1/users/me/fund-url" : null;
+    if (!path) {
+      throw new ZeroWalletError(
+        "fundingUrl() requires a client constructed with an account or session credentials"
+      );
+    }
+    const query = {
+      provider: opts.provider ?? "coinbase"
+    };
+    if (opts.amount) query.amount = opts.amount;
+    const { url } = await request(
+      this.client,
+      { method: "GET", path, query, signal: opts.signal },
+      fundingUrlResponseSchema
+    );
+    return url;
+  };
+  getPublicClient = (chain) => {
+    if (chain === "base") {
+      if (!this.clients.base) {
+        this.clients.base = viem.createPublicClient({
+          chain: baseChain,
+          transport: viem.http()
         });
       }
+      return this.clients.base;
     }
-  }
-  const result = {
-    runId,
-    ok: response.ok,
-    status: response.status,
-    latencyMs,
-    payment,
-    outcome: computeOutcome(response.status, payment, warnings),
-    body,
-    bodyRaw
+    if (!this.clients.tempo) {
+      this.clients.tempo = viem.createPublicClient({
+        // biome-ignore lint/suspicious/noExplicitAny: tempo is a custom chain object that viem's stricter Chain type rejects shape-wise but accepts at runtime
+        chain: tempoChain2,
+        transport: viem.http()
+      });
+    }
+    return this.clients.tempo;
   };
-  if (bodyEncoding) result.bodyEncoding = bodyEncoding;
-  if (!response.ok) {
-    const candidate = bodyRaw !== null && bodyRaw.length > 0 && bodyEncoding !== "base64" ? bodyRaw.slice(0, 240) : null;
-    result.error = candidate !== null && !requestBodyEchoed(candidate, opts.body) ? candidate : `HTTP ${response.status}`;
-    if (upstreamErrorForRecord) result.upstreamError = upstreamErrorForRecord;
-  }
-  if (capabilityIdRequested && skipReasons.length > 0) {
-    result.runTrackingSkipped = skipReasons;
-  }
-  if (warnings.length > 0) result.warnings = warnings;
-  if (capabilityResolution !== void 0)
-    result.capabilityResolution = capabilityResolution;
-  return result;
+  /**
+   * @internal
+   *
+   * Per-chain USDC balance read. Exposed (rather than private) so unit
+   * tests can stub it without standing up a real viem public client —
+   * viem's `http()` transport doesn't go through `client.fetchImpl`, so
+   * the standard mock-fetch trick doesn't cover this path.
+   */
+  readChainBalance = async (chain, address) => {
+    const publicClient = this.getPublicClient(chain);
+    const tokenAddress = chain === "base" ? USDC_BASE2 : USDC_TEMPO2;
+    const balance = await publicClient.readContract({
+      address: tokenAddress,
+      abi: ERC20_BALANCE_ABI2,
+      functionName: "balanceOf",
+      args: [address]
+    });
+    return balance;
+  };
+};
+
+// src/options.ts
+var DEFAULT_BASE_URL = "https://api.zero.xyz";
+var DEFAULT_TIMEOUT_MS = 18e4;
+var DEFAULT_MAX_RETRIES = 2;
+
+// src/auth/credentials.ts
+var noopRefresh = async () => {
 };
 var searchResultSchema = zod.z.object({
   id: zod.z.string(),
+  // Opaque attribution token (format: `z_{shortId}.{position}`). Optional
+  // so old API deploys that don't emit it still parse cleanly. Pass as
+  // capabilityId to client.fetch() for exact search attribution.
+  token: zod.z.string().nullable().optional(),
   position: zod.z.number(),
   slug: zod.z.string(),
   name: zod.z.string(),
@@ -2910,6 +2923,9 @@ var searchResultSchema = zod.z.object({
   cost: zod.z.object({ amount: zod.z.string(), asset: zod.z.string() }),
   reviewCount: zod.z.number().optional(),
   rating: ratingSchema,
+  // All-time activation count (non-deleted runs), mirroring capabilities.ts.
+  // Optional so a response from an older API deploy still parses (ZERO-385).
+  activationCount: zod.z.number().optional(),
   availabilityStatus: zod.z.enum(["healthy", "unknown", "down"]).nullable().optional(),
   /**
    * @deprecated The API no longer emits `displayStatus`; it has been replaced
@@ -3331,9 +3347,10 @@ exports.asSchemaNode = asSchemaNode;
 exports.coerceTempoChainId = coerceTempoChainId;
 exports.createManagedAccount = createManagedAccount;
 exports.extractInputEnvelope = extractInputEnvelope;
+exports.isShortToken = isShortToken;
 exports.normalizeTransportEnvelopeRequest = normalizeTransportEnvelopeRequest;
 exports.paymentHasAnchor = paymentHasAnchor;
 exports.tempoChainLabelFromId = tempoChainLabelFromId;
 exports.unwrapTransportEnvelope = unwrapTransportEnvelope;
-//# sourceMappingURL=chunk-UIK7QKNQ.cjs.map
-//# sourceMappingURL=chunk-UIK7QKNQ.cjs.map
+//# sourceMappingURL=chunk-72WCE7HE.cjs.map
+//# sourceMappingURL=chunk-72WCE7HE.cjs.map