@run402/sdk 1.52.0 → 1.53.1

package/README.md

@@ -25,6 +25,19 @@ await r.blobs.put(project.project_id, "hello.txt", { content: "hi" });
 
 That's it — credentials are read, x402 payments are signed, results are typed.
 
+### Project-scoped sub-client
+
+If you're working on a single project for the duration of a script, bind it once and skip the id arg on every call:
+
+```ts
+const p = await r.useProject(projectId);                                  // persists active project + returns scoped handle
+await p.blobs.put("hello.txt", { content: "hi" });                        // no projectId arg
+await p.functions.list();
+await p.deploy.apply({ site: { replace: files({ "index.html": "<h1>hi</h1>" }) } });
+```
+
+`r.useProject(id)` writes the active project to the keystore (shared with concurrent CLI runs). For transient in-script scoping that does NOT mutate that state, use `r.project(id)` (or `r.project()` with no arg to resolve from whatever the keystore currently considers active).
+
 ## Quick start (isomorphic)
 
 ```ts
@@ -45,38 +58,66 @@ The `CredentialsProvider` interface has two required methods (`getAuth`, `getPro
 
 | Namespace | Highlights |
 |---|---|
-| `projects` | `provision`, `delete`, `list`, `getUsage`, `getSchema`, `info`, `keys`, `use`, `pin` |
-| `deploy` | **The unified deploy primitive (v1.34+).** `apply` / `start` / `resume` / `status` / `getRelease` / `diff` / `plan` / `upload` / `commit` |
-| `sites` | `deployDir` (Node entry only) — thin wrapper over `r.deploy.apply` |
-| `blobs` | `put` (returns `AssetRef` with `cdn_url`/`sri`/`etag`), `get`, `ls`, `rm`, `sign`, `diagnoseUrl`, `waitFresh` |
-| `functions` | `deploy`, `invoke`, `getLogs`, `update`, `list`, `delete` |
+| `projects` | `provision`, `delete`, `list`, `getUsage`, `getSchema`, `info`, `keys`, `use`, `active`, `pin`, `getQuote` |
+| `deploy` | **The unified deploy primitive (v1.34+).** `apply` / `start` / `resume` / `status` / `list` / `events` / `getRelease` / `diff` / `plan` / `upload` / `commit` |
+| `sites` | `deployDir` — Node entry only (`@run402/sdk/node`); thin wrapper over `r.deploy.apply` |
+| `blobs` | `put` (returns `AssetRef` with `cdnUrl` / `sri` / `etag` / `cacheKind` and `scriptTag()`/`linkTag()`/`imgTag()` emitters), `get`, `ls`, `rm`, `sign`, `diagnoseUrl`, `waitFresh` |
+| `functions` | `deploy`, `invoke`, `logs`, `update`, `list`, `delete` |
 | `secrets` | `set`, `list`, `delete` |
-| `subdomains` | `claim`, `list`, `delete` |
+| `subdomains` | `claim`, `list`, `delete` (most agents declare subdomains in `r.deploy.apply({ subdomains: { set: [...] } })` instead) |
 | `domains` | `add`, `list`, `status`, `remove` |
-| `email` | `createMailbox`, `sendEmail`, `listEmails`, `getEmail`, `getEmailRaw`, `webhooks.*` |
+| `email` | `createMailbox`, `getMailbox`, `deleteMailbox`, `send`, `list`, `get`, `getRaw`, `webhooks.*` |
 | `senderDomain` | `register`, `status`, `remove`, `enableInbound`, `disableInbound` |
-| `auth` | `magicLink`, `verifyMagicLink`, `setUserPassword`, `settings`, `providers` |
-| `apps` | `browse`, `get`, `fork`, `publish`, `versions.*`, `bundleDeploy` (legacy shim → routes through `deploy`) |
-| `tier` | `set`, `status`, `quote` |
+| `auth` | `requestMagicLink`, `verifyMagicLink`, `setUserPassword`, `settings`, `promote`, `demote` |
+| `apps` | `browse`, `getApp`, `fork`, `publish`, `listVersions`, `updateVersion`, `deleteVersion`, `bundleDeploy` (legacy shim → routes through `deploy`) |
+| `tier` | `set`, `status` (tier pricing lives on `r.projects.getQuote()`) |
 | `billing` | `createEmailAccount`, `linkWallet`, `tierCheckout`, `buyEmailPack`, `setAutoRecharge`, `balance`, `history`, `createCheckout` |
-| `contracts` | `provisionWallet`, `getWallet`, `listWallets`, `setRecoveryAddress`, `setLowBalanceAlert`, `call`, `read`, `getCallStatus`, `drainWallet`, `deleteWallet` |
-| `ai` | `translate`, `moderate`, `usage` |
-| `allowance` | `status`, `create`, `export`, `requestFaucet`, `checkBalance` |
+| `contracts` | `provisionWallet`, `getWallet`, `listWallets`, `setRecovery`, `setLowBalanceAlert`, `call`, `read`, `callStatus`, `drain`, `deleteWallet` |
+| `ai` | `translate`, `moderate`, `usage`, `generateImage` |
+| `allowance` | `status`, `create`, `export`, `faucet` |
 | `service` | `status`, `health` (no auth, no setup — works on a fresh install) |
 | `admin` | Admin-only endpoints (pinning, lifecycle reactivation, dispute resolution) |
 
+### Casing in returned shapes
+
+Two casings coexist by design — agents reading the type surface should
+classify a field by the SHAPE it belongs to:
+
+- **Raw API result shapes preserve the gateway's snake_case fields.** Examples:
+  `ProvisionResult.project_id`, `ProvisionResult.anon_key`,
+  `ProvisionResult.service_key`, `ProvisionResult.schema_slot`,
+  `ProjectInfo.project_id`, `ProjectSummary.lease_expires_at`,
+  `UsageReport.api_calls`, `SchemaReport.schema`. These mirror the HTTP
+  response bodies one-to-one.
+- **SDK-specific helper shapes use camelCase.** Examples:
+  `AssetRef.cdnUrl` / `AssetRef.cacheKind` / `AssetRef.contentSha256`,
+  `Run402DeployError.safeToRetry` / `operationId` / `mutationState`,
+  every `DeployEvent` variant's discriminator (`type`, plus per-variant
+  fields like `releaseId`, `urls`).
+
+This split is intentional and stays through `1.x`. Doc examples in this
+README and in `llms-sdk.txt` use the exact field names the types export —
+copy them verbatim. CI fails any TypeScript-fenced example that accesses a
+field that does not exist on the actual type.
+
+> **Reference tables (in `llms-sdk.txt`) use plain code fences, not `ts`
+> fences.** They document the type surface in compact form for visual
+> scanning — they are not runnable programs and are exempt from CI
+> type-checking. Runnable example snippets still use ```` ```ts ```` and are
+> CI-gated against the published types.
+
 ## Patterns
 
 ### Paste-and-go assets — content-addressed URLs with SRI
 
-`r.blobs.put` returns an `AssetRef`. The `cdn_url` is content-addressed (`pr-<public_id>.run402.com/_blob/<key>-<8hex>.<ext>`), served through CloudFront, and never needs cache invalidation. The browser refuses execution on byte mismatch via SRI:
+`r.blobs.put` returns an `AssetRef`. The `cdnUrl` is content-addressed (`pr-<public_id>.run402.com/_blob/<key>-<8hex>.<ext>`), served through CloudFront, and never needs cache invalidation. The browser refuses execution on byte mismatch via SRI:
 
 ```ts
 const logo = await r.blobs.put(projectId, "logo.png", { bytes });
-//   logo.cdn_url   → drop into <img src="…">
-//   logo.sri       → "sha256-…" for <script integrity="…">
-//   logo.etag      → strong "sha256-<hex>"
-//   logo.cache_kind → "immutable" | "mutable" | "private"
+//   logo.cdnUrl     → drop into <img src="…">
+//   logo.sri        → "sha256-…" for <script integrity="…">
+//   logo.etag       → strong "sha256-<hex>"
+//   logo.cacheKind  → "immutable" | "mutable" | "private"
 ```
 
 `immutable: true` is the default since v1.45 — pass `false` only when you specifically want to skip the SHA-256 pass on a very large upload.
@@ -89,9 +130,9 @@ The canonical primitive for any deploy (database + migrations + manifest + secre
 // One-shot — most agents use this.
 const result = await r.deploy.apply(spec);
 
-// Long-running with progress events.
+// Long-running with progress events. Events are a discriminated union on `type`.
 const op = await r.deploy.start(spec);
-for await (const e of op.events()) console.log(e.phase);
+for await (const ev of op.events()) console.log(ev.type);
 const final = await op.result();
 
 // Resume a previously-started deploy by id.
@@ -99,7 +140,7 @@ const resumed = await r.deploy.resume(operationId);
 ```
 
 - **All bytes ride through CAS.** The plan request body never carries inline bytes — only `ContentRef` objects. When the spec exceeds 5 MB JSON, the SDK uploads the manifest itself as a CAS object (`manifest_ref` escape hatch).
-- **Replace vs patch semantics per resource.** `site.replace` = "this is the whole site" (files absent are removed); `site.patch.put` / `patch.delete` = surgical updates. Same shape for `functions`, `secrets`, `subdomains`. Top-level absence = leave untouched.
+- **Per-resource semantics on the spec.** `site.replace` = "this is the whole site" (files absent are removed). `site.patch.put` / `patch.delete` are surgical updates. `functions.replace` / `functions.patch.set` / `functions.patch.delete` mirror that. `secrets.set` / `secrets.delete` / `secrets.replace_all` and `subdomains.set` / `subdomains.add` / `subdomains.remove` use their own shapes (see `ReleaseSpec` types). Top-level absence = leave untouched.
 - **Server-authoritative manifest digest** — no byte-for-byte canonicalize requirement on the client.
 - The Node entry adds `fileSetFromDir(path)` for filesystem byte sources:
 
@@ -107,42 +148,109 @@ const resumed = await r.deploy.resume(operationId);
   import { run402, fileSetFromDir } from "@run402/sdk/node";
   const r = run402();
   await r.deploy.apply({
-    project_id,
-    site: { replace: { files: await fileSetFromDir("./dist") } },
-    subdomains: { replace: [{ name: "my-app" }] },
+    project: projectId,
+    site: { replace: await fileSetFromDir("./dist") },
+    subdomains: { set: ["my-app"] },
   });
   ```
 
 ### Errors
 
-All failures throw subclasses of `Run402Error`:
+All failures throw subclasses of `Run402Error`. Every subclass carries a stable
+`kind` discriminator string and an `isRun402Error` brand:
+
+| Class | `kind` | When | Notable fields |
+|---|---|---|---|
+| `PaymentRequired` | `"payment_required"` | HTTP 402 | x402 payment requirements in `body` |
+| `ProjectNotFound` | `"project_not_found"` | Project ID not in the credential provider | `projectId` |
+| `Unauthorized` | `"unauthorized"` | HTTP 401 / 403 | — |
+| `ApiError` | `"api_error"` | Other non-2xx responses | `status`, `body` |
+| `NetworkError` | `"network_error"` | Fetch rejected with no HTTP response | `cause` |
+| `LocalError` | `"local_error"` | Local-host issues (filesystem, signing) | `cause` |
+| `Run402DeployError` | `"deploy_error"` | Structured envelope from the deploy state machine (v1.34+) | `code`, `phase`, `operationId`, `safeToRetry`, `mutationState`, `nextActions` |
+
+**Branch with type guards, not `instanceof`.** `instanceof X` is an identity
+check on the class object — it fails silently when the consumer's runtime
+holds a different copy of the SDK (duplicate npm installs, bundler chunk
+splits, ESM/CJS interop, V8-isolate realms). The exported guards
+(`isPaymentRequired`, `isDeployError`, …) check `isRun402Error` + `kind`,
+which is identity-free and survives all of those scenarios. `instanceof`
+continues to work for back-compat in the simple single-copy case.
 
-| Class | When | Notable fields |
-|---|---|---|
-| `PaymentRequired` | HTTP 402 | x402 payment requirements |
-| `ProjectNotFound` | Project ID not in the credential provider | — |
-| `Unauthorized` | HTTP 401 / 403 | — |
-| `ApiError` | Other non-2xx responses | `status`, `body` |
-| `NetworkError` | Fetch rejected with no HTTP response | — |
-| `LocalError` | Local-host issues (filesystem, signing) | — |
-| `Run402DeployError` | Structured envelope from the deploy state machine (v1.34+) | `code`, `phase`, `operation_id`, `safe_to_retry`, `mutation_state`, `next_actions` |
+```ts
+import {
+  run402,
+  isPaymentRequired,
+  isDeployError,
+  type ReleaseSpec,
+} from "@run402/sdk/node";
+
+declare const spec: ReleaseSpec;
+const r = run402();
 
-Branch on the structured fields, not English `message` text:
+try {
+  await r.deploy.apply(spec);
+} catch (e) {
+  if (isPaymentRequired(e)) {
+    // e is narrowed to PaymentRequired
+    // present payment requirements to the user — read e.body, e.context, etc.
+  } else if (isDeployError(e) && e.safeToRetry) {
+    // e is narrowed to Run402DeployError; it's safe to retry with the same idempotency key
+  } else throw e;
+}
+```
+
+`Run402Error.toJSON()` returns a canonical envelope, so `JSON.stringify(e)`
+produces a populated structured object instead of the empty `"{}"` plain
+`Error` produces. Use this for telemetry, MCP tool results, CLI JSON output,
+and any inter-process boundary where the error needs to survive serialization.
+
+#### Retry idempotent operations with `withRetry`
+
+`withRetry(fn, opts?)` wraps any async call with exponential backoff. It uses
+`isRetryableRun402Error` (the canonical "should I retry this?" policy: 408 /
+425 / 429 / 5xx / `NetworkError` / gateway-flagged `retryable` or
+`safeToRetry`) by default. Pair it with the SDK method's own
+`idempotencyKey` so retried mutations dedup server-side:
 
 ```ts
-import { PaymentRequired, Run402DeployError } from "@run402/sdk";
+import {
+  run402,
+  withRetry,
+  isPaymentRequired,
+  isDeployError,
+  type ReleaseSpec,
+} from "@run402/sdk/node";
+
+declare const spec: ReleaseSpec;
+const r = run402();
 
 try {
-  await r.deploy.apply(spec);
+  const release = await withRetry(
+    () => r.deploy.apply(spec, { idempotencyKey: "deploy-2026-05-01" }),
+    {
+      attempts: 3,
+      onRetry: (e, attempt, delayMs) =>
+        process.stderr.write(`retry ${attempt} in ${delayMs}ms\n`),
+    },
+  );
+  console.log(release.urls);
 } catch (e) {
-  if (e instanceof PaymentRequired) {
-    // present payment requirements to the user
-  } else if (e instanceof Run402DeployError && e.safe_to_retry) {
-    // safe to retry — same idempotency key
+  if (isPaymentRequired(e)) {
+    // ... present payment
+  } else if (isDeployError(e)) {
+    // log structured envelope for triage
+    process.stderr.write(JSON.stringify(e) + "\n");
   } else throw e;
 }
 ```
 
+Defaults: 3 attempts (1 initial + 2 retries), 250 ms base delay, 5 s cap. Pass
+a custom `retryIf` to override the default policy (e.g., retry on
+`PaymentRequired` if your sandbox auto-funds). After exhausting attempts
+`withRetry` throws the LAST error — your catch handler sees the original
+structured envelope, not a wrapper.
+
 The SDK never calls `process.exit`. Each interface (MCP tools, CLI, your code) wraps with its own error behavior.
 
 ## Stability

package/dist/errors.d.ts

@@ -2,8 +2,34 @@
  * Error hierarchy for the Run402 SDK. Every failure throws a subclass of
  * {@link Run402Error}. Consumers (MCP handlers, CLI commands, user functions)
  * translate these into their native error shapes at the edge.
+ *
+ * Branch on {@link Run402Error.kind} (or the exported `is*` type guards) rather
+ * than `instanceof`. Discriminator-based checks survive duplicate SDK installs,
+ * bundler chunk splits, ESM/CJS interop, and V8-isolate realm boundaries —
+ * any setting where a class object's identity might differ from the consumer's
+ * own class object reference. `instanceof X` continues to work for callers
+ * holding a single SDK copy (back-compat); the guards are the recommended path.
+ */
+/**
+ * Stable string discriminator on every {@link Run402Error} subclass. Use this
+ * (or the exported `is*` guards) to branch on errors safely across SDK copies
+ * and realms — value comparison, no class-identity dependency.
  */
+export type Run402ErrorKind = "payment_required" | "project_not_found" | "unauthorized" | "api_error" | "network_error" | "local_error" | "deploy_error";
 export declare abstract class Run402Error extends Error {
+    /**
+     * Structural brand. Always `true` on any {@link Run402Error} subclass
+     * instance, regardless of which SDK copy created it. The exported
+     * {@link isRun402Error} guard checks this field instead of `instanceof`,
+     * so cross-realm and cross-bundle errors still match.
+     */
+    readonly isRun402Error: true;
+    /**
+     * Stable string discriminator. Branch on `e.kind === "..."` (or the
+     * exported subclass guards) rather than `e instanceof X`. Equality on
+     * `kind` survives duplicate SDK copies and cross-realm errors.
+     */
+    abstract readonly kind: Run402ErrorKind;
     /** HTTP status, or null for local/network failures that produced no response. */
     readonly status: number | null;
     /** Parsed response body, or null when no body was received. */
@@ -27,28 +53,42 @@ export declare abstract class Run402Error extends Error {
     /** Advisory next actions from the gateway. Rendering them must not execute them. */
     readonly nextActions?: unknown[];
     constructor(message: string, status: number | null, body: unknown, context: string);
+    /**
+     * Canonical structured envelope for `JSON.stringify`. Without this, an
+     * `Error` instance serializes as `"{}"` (its built-in fields are
+     * non-enumerable), losing every structured detail an agent needs for
+     * triage. Subclasses with extra fields (e.g. {@link Run402DeployError})
+     * override and spread `super.toJSON()`.
+     */
+    toJSON(): Record<string, unknown>;
 }
 /** HTTP 402 — the gateway requires payment (lease expired, insufficient balance, or x402 quote). */
 export declare class PaymentRequired extends Run402Error {
+    readonly kind: "payment_required";
 }
 /** Project ID is not present in the credential provider (local miss) or the gateway returned 404. */
 export declare class ProjectNotFound extends Run402Error {
+    readonly kind: "project_not_found";
     readonly projectId: string;
     constructor(projectId: string, context: string, status?: number | null, body?: unknown);
 }
 /** HTTP 401 or 403 — authentication missing, invalid, or insufficient for the operation. */
 export declare class Unauthorized extends Run402Error {
+    readonly kind: "unauthorized";
 }
 /** Any other non-2xx HTTP response from the gateway. */
 export declare class ApiError extends Run402Error {
+    readonly kind: "api_error";
 }
 /** The underlying `fetch` threw before producing a response (DNS, connection reset, offline). */
 export declare class NetworkError extends Run402Error {
+    readonly kind: "network_error";
     readonly cause: unknown;
     constructor(message: string, cause: unknown, context: string);
 }
 /** Local/filesystem error — input validation, missing path, unreadable dir. No HTTP involved. */
 export declare class LocalError extends Run402Error {
+    readonly kind: "local_error";
     readonly cause?: unknown;
     constructor(message: string, context: string, cause?: unknown);
 }
@@ -69,6 +109,7 @@ export interface Run402DeployErrorFix {
     [key: string]: unknown;
 }
 export declare class Run402DeployError extends Run402Error {
+    readonly kind: "deploy_error";
     readonly code: Run402DeployErrorCode;
     readonly phase: string | null;
     readonly resource: string | null;
@@ -92,5 +133,37 @@ export declare class Run402DeployError extends Run402Error {
         body?: unknown;
         context: string;
     });
+    toJSON(): Record<string, unknown>;
 }
+/** True if `e` is any {@link Run402Error} subclass instance, regardless of which SDK copy created it. */
+export declare function isRun402Error(e: unknown): e is Run402Error;
+/** True if `e` is a {@link PaymentRequired}. Survives duplicate SDK copies and realms. */
+export declare function isPaymentRequired(e: unknown): e is PaymentRequired;
+/** True if `e` is a {@link ProjectNotFound}. */
+export declare function isProjectNotFound(e: unknown): e is ProjectNotFound;
+/** True if `e` is an {@link Unauthorized}. */
+export declare function isUnauthorized(e: unknown): e is Unauthorized;
+/** True if `e` is an {@link ApiError}. */
+export declare function isApiError(e: unknown): e is ApiError;
+/** True if `e` is a {@link NetworkError}. */
+export declare function isNetworkError(e: unknown): e is NetworkError;
+/** True if `e` is a {@link LocalError}. */
+export declare function isLocalError(e: unknown): e is LocalError;
+/** True if `e` is a {@link Run402DeployError}. */
+export declare function isDeployError(e: unknown): e is Run402DeployError;
+/**
+ * Canonical "should I retry this?" policy. Returns true when `e` is a
+ * {@link Run402Error} AND any of:
+ *   - `e.retryable === true` (gateway flagged it)
+ *   - `e.safeToRetry === true` (gateway flagged it)
+ *   - `e.kind === "network_error"` (fetch never produced a response)
+ *   - `e.status` is 408 (Request Timeout), 425 (Too Early), or 429 (Too Many
+ *     Requests)
+ *   - `e.status` is a 5xx server error
+ *
+ * Returns false for non-Run402 errors so it can be safely called with
+ * `unknown` from a catch block. Used as the default `retryIf` in
+ * {@link withRetry}.
+ */
+export declare function isRetryableRun402Error(e: unknown): boolean;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/errors.js

@@ -2,8 +2,22 @@
  * Error hierarchy for the Run402 SDK. Every failure throws a subclass of
  * {@link Run402Error}. Consumers (MCP handlers, CLI commands, user functions)
  * translate these into their native error shapes at the edge.
+ *
+ * Branch on {@link Run402Error.kind} (or the exported `is*` type guards) rather
+ * than `instanceof`. Discriminator-based checks survive duplicate SDK installs,
+ * bundler chunk splits, ESM/CJS interop, and V8-isolate realm boundaries —
+ * any setting where a class object's identity might differ from the consumer's
+ * own class object reference. `instanceof X` continues to work for callers
+ * holding a single SDK copy (back-compat); the guards are the recommended path.
  */
 export class Run402Error extends Error {
+    /**
+     * Structural brand. Always `true` on any {@link Run402Error} subclass
+     * instance, regardless of which SDK copy created it. The exported
+     * {@link isRun402Error} guard checks this field instead of `instanceof`,
+     * so cross-realm and cross-bundle errors still match.
+     */
+    isRun402Error = true;
     /** HTTP status, or null for local/network failures that produced no response. */
     status;
     /** Parsed response body, or null when no body was received. */
@@ -51,6 +65,31 @@ export class Run402Error extends Error {
         if (Array.isArray(envelope?.next_actions))
             this.nextActions = envelope.next_actions;
     }
+    /**
+     * Canonical structured envelope for `JSON.stringify`. Without this, an
+     * `Error` instance serializes as `"{}"` (its built-in fields are
+     * non-enumerable), losing every structured detail an agent needs for
+     * triage. Subclasses with extra fields (e.g. {@link Run402DeployError})
+     * override and spread `super.toJSON()`.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            kind: this.kind,
+            message: this.message,
+            status: this.status,
+            code: this.code,
+            category: this.category,
+            retryable: this.retryable,
+            safeToRetry: this.safeToRetry,
+            mutationState: this.mutationState,
+            traceId: this.traceId,
+            context: this.context,
+            details: this.details,
+            nextActions: this.nextActions,
+            body: this.body,
+        };
+    }
 }
 function canonicalEnvelope(body) {
     return body && typeof body === "object" && !Array.isArray(body)
@@ -59,9 +98,11 @@ function canonicalEnvelope(body) {
 }
 /** HTTP 402 — the gateway requires payment (lease expired, insufficient balance, or x402 quote). */
 export class PaymentRequired extends Run402Error {
+    kind = "payment_required";
 }
 /** Project ID is not present in the credential provider (local miss) or the gateway returned 404. */
 export class ProjectNotFound extends Run402Error {
+    kind = "project_not_found";
     projectId;
     constructor(projectId, context, status = null, body = null) {
         super(`Project ${projectId} not found`, status, body, context);
@@ -70,12 +111,15 @@ export class ProjectNotFound extends Run402Error {
 }
 /** HTTP 401 or 403 — authentication missing, invalid, or insufficient for the operation. */
 export class Unauthorized extends Run402Error {
+    kind = "unauthorized";
 }
 /** Any other non-2xx HTTP response from the gateway. */
 export class ApiError extends Run402Error {
+    kind = "api_error";
 }
 /** The underlying `fetch` threw before producing a response (DNS, connection reset, offline). */
 export class NetworkError extends Run402Error {
+    kind = "network_error";
     cause;
     constructor(message, cause, context) {
         super(message, null, null, context);
@@ -84,6 +128,7 @@ export class NetworkError extends Run402Error {
 }
 /** Local/filesystem error — input validation, missing path, unreadable dir. No HTTP involved. */
 export class LocalError extends Run402Error {
+    kind = "local_error";
     cause;
     constructor(message, context, cause) {
         super(message, null, null, context);
@@ -92,6 +137,7 @@ export class LocalError extends Run402Error {
     }
 }
 export class Run402DeployError extends Run402Error {
+    kind = "deploy_error";
     code;
     phase;
     resource;
@@ -113,5 +159,87 @@ export class Run402DeployError extends Run402Error {
         this.logs = init.logs ?? null;
         this.rolledBack = init.rolledBack ?? false;
     }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            phase: this.phase,
+            resource: this.resource,
+            operationId: this.operationId,
+            planId: this.planId,
+            fix: this.fix,
+            logs: this.logs,
+            rolledBack: this.rolledBack,
+            retryable: this.retryable,
+        };
+    }
+}
+// ─── Type guards ─────────────────────────────────────────────────────────────
+//
+// Identity-free guards. Each one checks the structural brand and (for subclass
+// guards) the `kind` discriminator. Use these instead of `instanceof X` so the
+// check survives duplicate SDK installs, bundler chunk splits, ESM/CJS interop,
+// and V8-isolate realm boundaries — anywhere the consumer's class object
+// reference might differ from the throw site's.
+/** True if `e` is any {@link Run402Error} subclass instance, regardless of which SDK copy created it. */
+export function isRun402Error(e) {
+    return Boolean(e &&
+        typeof e === "object" &&
+        e.isRun402Error === true);
+}
+/** True if `e` is a {@link PaymentRequired}. Survives duplicate SDK copies and realms. */
+export function isPaymentRequired(e) {
+    return isRun402Error(e) && e.kind === "payment_required";
+}
+/** True if `e` is a {@link ProjectNotFound}. */
+export function isProjectNotFound(e) {
+    return isRun402Error(e) && e.kind === "project_not_found";
+}
+/** True if `e` is an {@link Unauthorized}. */
+export function isUnauthorized(e) {
+    return isRun402Error(e) && e.kind === "unauthorized";
+}
+/** True if `e` is an {@link ApiError}. */
+export function isApiError(e) {
+    return isRun402Error(e) && e.kind === "api_error";
+}
+/** True if `e` is a {@link NetworkError}. */
+export function isNetworkError(e) {
+    return isRun402Error(e) && e.kind === "network_error";
+}
+/** True if `e` is a {@link LocalError}. */
+export function isLocalError(e) {
+    return isRun402Error(e) && e.kind === "local_error";
+}
+/** True if `e` is a {@link Run402DeployError}. */
+export function isDeployError(e) {
+    return isRun402Error(e) && e.kind === "deploy_error";
+}
+/**
+ * Canonical "should I retry this?" policy. Returns true when `e` is a
+ * {@link Run402Error} AND any of:
+ *   - `e.retryable === true` (gateway flagged it)
+ *   - `e.safeToRetry === true` (gateway flagged it)
+ *   - `e.kind === "network_error"` (fetch never produced a response)
+ *   - `e.status` is 408 (Request Timeout), 425 (Too Early), or 429 (Too Many
+ *     Requests)
+ *   - `e.status` is a 5xx server error
+ *
+ * Returns false for non-Run402 errors so it can be safely called with
+ * `unknown` from a catch block. Used as the default `retryIf` in
+ * {@link withRetry}.
+ */
+export function isRetryableRun402Error(e) {
+    if (!isRun402Error(e))
+        return false;
+    if (e.retryable === true || e.safeToRetry === true)
+        return true;
+    if (e.kind === "network_error")
+        return true;
+    const s = e.status;
+    if (s === 408 || s === 425 || s === 429)
+        return true;
+    if (typeof s === "number" && s >= 500)
+        return true;
+    return false;
 }
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}