@belonguniverseai/react-sdk 0.1.5 → 0.1.7

package/dist/api/agent-grants.d.ts

@@ -13,27 +13,29 @@ export declare const useAgentGrantStatus: (input: {
     readonly provider: string;
     readonly scopeExternalId: string;
 } | null) => import('@tanstack/react-query').UseQueryResult<NoInfer<AgentGrantStatusView>, Error>;
+/** Injectable timing/randomness so the backoff loop is deterministic in tests. */
+export type GrantRetryOptions = {
+    readonly maxRetries?: number;
+    readonly budgetMs?: number;
+    readonly sleep?: (ms: number) => Promise<void>;
+    readonly random?: () => number;
+    readonly now?: () => number;
+};
 /**
- * POST a grant create, with the connect self-heal. Two provider rejections
- * recover the same way:
- *
- *   - 409 (anti-replay): the cached web JWT already minted a grant (e.g. on a
- *     prior connect), so the provider refuses it.
- *   - 429 (session cap): the workspace is at its concurrent-session limit. The
- *     backend has just best-effort revoked-all the user's leaked sessions to
- *     free a slot (§ agent-grant.service.ts), so a retry now fits under the cap.
- *
- * Either way: force-mint a brand-new token (`forceRotateBelongToken` →
- * cacheMode:"off") and retry ONCE — the next request carries a JWT the provider
- * has never seen, into a now-under-cap workspace. A no-op for non-Auth0 hosts
- * (the retry re-sends the same token and fails identically, surfacing exactly
- * as before). Standalone so the retry is unit-testable (mirrors
- * `deleteSessionRequest`).
+ * POST a grant create with two layers of self-heal:
+ *   1. Per attempt — the 409/429 anti-replay / session-cap force-mint retry
+ *      (see `attemptGrantOnce`).
+ *   2. Across attempts — a bounded backoff retry for TRANSIENT infra failures
+ *      (502, 503 sandbox_unavailable, network errors — see `runGrantIteration` /
+ *      `isTransientGrantFailure`): up to `maxRetries` retries with full-jitter
+ *      backoff under a total time budget, so a passing Daytona runner blip or a
+ *      sandbox write hiccup self-heals instead of surfacing to the user.
+ * Injectable timing/randomness so the whole loop is unit-testable.
  */
 export declare const createAgentGrantRequest: (api: ApiClient, input: {
     readonly provider: string;
     readonly scopeExternalId: string;
-}) => Promise<unknown>;
+}, opts?: GrantRetryOptions) => Promise<unknown>;
 /**
  * BEL-79 fail-fast beacon: tell the backend a reactive reconnect has FAILED for
  * good (after `createAgentGrantRequest`'s own forceRotate+retry), so the worker's
@@ -52,10 +54,3 @@ export declare const useCreateAgentGrant: () => import('@tanstack/react-query').
     readonly provider: string;
     readonly scopeExternalId: string;
 }, unknown>;
-export declare const useRevokeAgentGrant: () => import('@tanstack/react-query').UseMutationResult<{
-    status: "revoked";
-}, Error, {
-    readonly grantId: string;
-    readonly provider: string;
-    readonly scopeExternalId: string;
-}, unknown>;