@tinycloud/node-sdk 3.0.1-beta.0 → 3.1.0-beta.10

package/dist/index.js

@@ -4409,19 +4409,19 @@ var init_lib4 = __esm({
           resolve(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve, reject) {
+      return new (P || (P = Promise))(function(resolve, reject2) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function rejected(value) {
           try {
             step(generator["throw"](value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function step(result) {
@@ -8045,19 +8045,19 @@ var init_typed_data = __esm({
           resolve(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve, reject) {
+      return new (P || (P = Promise))(function(resolve, reject2) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function rejected(value) {
           try {
             step(generator["throw"](value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function step(result) {
@@ -14903,14 +14903,14 @@ var require_scrypt = __commonJS({
       }
       const lib = {
         scrypt: function(password, salt, N2, r2, p, dkLen, progressCallback) {
-          return new Promise(function(resolve, reject) {
+          return new Promise(function(resolve, reject2) {
             let lastProgress = 0;
             if (progressCallback) {
               progressCallback(0);
             }
             _scrypt(password, salt, N2, r2, p, dkLen, function(error, progress, key2) {
               if (error) {
-                reject(error);
+                reject2(error);
               } else if (key2) {
                 if (progressCallback && lastProgress !== 1) {
                   progressCallback(1);
@@ -15299,19 +15299,19 @@ var init_keystore = __esm({
           resolve(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve, reject) {
+      return new (P || (P = Promise))(function(resolve, reject2) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function rejected(value) {
           try {
             step(generator["throw"](value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function step(result) {
@@ -15612,19 +15612,19 @@ var init_lib25 = __esm({
           resolve(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve, reject) {
+      return new (P || (P = Promise))(function(resolve, reject2) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function rejected(value) {
           try {
             step(generator["throw"](value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function step(result) {
@@ -15694,19 +15694,19 @@ var init_lib26 = __esm({
           resolve(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve, reject) {
+      return new (P || (P = Promise))(function(resolve, reject2) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function rejected(value) {
           try {
             step(generator["throw"](value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function step(result) {
@@ -16016,19 +16016,19 @@ var init_lib27 = __esm({
           resolve(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve, reject) {
+      return new (P || (P = Promise))(function(resolve, reject2) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function rejected(value) {
           try {
             step(generator["throw"](value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function step(result) {
@@ -16254,19 +16254,19 @@ var init_geturl = __esm({
           resolve(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve, reject) {
+      return new (P || (P = Promise))(function(resolve, reject2) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function rejected(value) {
           try {
             step(generator["throw"](value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function step(result) {
@@ -16407,14 +16407,14 @@ function _fetchData(connection, body, processFunc) {
   options.headers = flatHeaders;
   const runningTimeout = (function() {
     let timer = null;
-    const promise = new Promise(function(resolve, reject) {
+    const promise = new Promise(function(resolve, reject2) {
       if (timeout) {
         timer = setTimeout(() => {
           if (timer == null) {
             return;
           }
           timer = null;
-          reject(logger28.makeError("timeout", Logger.errors.TIMEOUT, {
+          reject2(logger28.makeError("timeout", Logger.errors.TIMEOUT, {
             requestBody: bodyify(options.body, flatHeaders["content-type"]),
             requestMethod: options.method,
             timeout,
@@ -16577,7 +16577,7 @@ function poll(func, options) {
   if (options.interval == null) {
     options.interval = 250;
   }
-  return new Promise(function(resolve, reject) {
+  return new Promise(function(resolve, reject2) {
     let timer = null;
     let done = false;
     const cancel = () => {
@@ -16593,7 +16593,7 @@ function poll(func, options) {
     if (options.timeout) {
       timer = setTimeout(() => {
         if (cancel()) {
-          reject(new Error("timeout"));
+          reject2(new Error("timeout"));
         }
       }, options.timeout);
     }
@@ -16613,7 +16613,7 @@ function poll(func, options) {
           attempt++;
           if (attempt > retryLimit) {
             if (cancel()) {
-              reject(new Error("retry limit reached"));
+              reject2(new Error("retry limit reached"));
             }
             return;
           }
@@ -16629,7 +16629,7 @@ function poll(func, options) {
         return null;
       }, function(error) {
         if (cancel()) {
-          reject(error);
+          reject2(error);
         }
       });
     }
@@ -16653,19 +16653,19 @@ var init_lib28 = __esm({
           resolve(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve, reject) {
+      return new (P || (P = Promise))(function(resolve, reject2) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function rejected(value) {
           try {
             step(generator["throw"](value));
           } catch (e) {
-            reject(e);
+            reject2(e);
           }
         }
         function step(result) {
@@ -17035,6 +17035,7 @@ import {
   prepareSession,
   completeSessionSetup,
   validatePersistedSession,
+  validateSessionGrant,
   ensureEip55,
   makeSpaceId,
   createDelegation,
@@ -17084,6 +17085,9 @@ var _NodeWasmBindings = class _NodeWasmBindings {
   validatePersistedSession(proof) {
     return validatePersistedSession(proof);
   }
+  validateSessionGrant(proof) {
+    return validateSessionGrant(proof);
+  }
   createSessionManager() {
     return new TCWSessionManager();
   }
@@ -17162,6 +17166,8 @@ var PrivateKeySigner = class {
 import {
   TinyCloud,
   activateSessionWithHost as activateSessionWithHost2,
+  authorizationVerdictOf,
+  httpResponseError,
   KVService as KVService2,
   SQLService as SQLService2,
   DuckDbService as DuckDbService2,
@@ -17195,6 +17201,7 @@ import {
   recapCaveatsEqual,
   expandPermissionEntries as expandPermissionEntriesCore,
   isCapabilitySubset,
+  isExplicitOnlyAction,
   parseRecapCapabilities,
   SERVICE_LONG_TO_SHORT,
   SERVICE_SHORT_TO_LONG,
@@ -17217,7 +17224,10 @@ import {
   CREDENTIAL_INVITATION_REQUEST_DOMAIN,
   validateShareDeliveryAuthorizationV3Bytes,
   verifyEip191MessageSignature,
-  signCompactUcanRootAuthorization
+  signCompactUcanRootAuthorization,
+  isStorageFullError,
+  STORAGE_FULL_MESSAGE,
+  STORAGE_WRITE_TOO_LARGE_MESSAGE
 } from "@tinycloud/sdk-core";
 import {
   parsePermissionHint
@@ -17337,6 +17347,10 @@ var MemorySessionStorage = class {
 // src/authorization/NodeUserAuthorization.ts
 var DECRYPT_ACTION = ENCRYPTION.DECRYPT;
 var NETWORK_CREATE_ACTION = ENCRYPTION.NETWORK_CREATE;
+function describeHostFailure(result) {
+  const text = result.error?.trim();
+  return text ? `${result.status} - ${text}` : `${result.status}`;
+}
 function canonicalizeOpenKeyManifestJson(value) {
   const json = JSON.stringify(value);
   if (json === void 0) {
@@ -17801,21 +17815,28 @@ var NodeUserAuthorization = class {
     });
     const signature2 = await this.signMessage(siwe, purpose);
     const headers = this.wasm.siweToDelegationHeaders({ siwe, signature: signature2 });
-    const result = await submitHostDelegation(host, headers);
-    return result.success;
+    return submitHostDelegation(host, headers);
   }
   /**
    * Create a specific space on the server via host delegation.
    * Used for lazy creation of additional spaces (e.g., public).
    */
   async hostPublicSpace(spaceId) {
-    return this.hostSpace(spaceId);
+    return (await this.hostSpace(spaceId)).success;
   }
   /**
    * Create a specific owned space on the server via host delegation.
    * Used by manifest registry setup for the account space.
    */
   async hostOwnedSpace(spaceId, purpose) {
+    return (await this.hostOwnedSpaceResult(spaceId, purpose)).success;
+  }
+  /**
+   * {@link hostOwnedSpace} with the full host-delegation result, so a failure
+   * keeps its HTTP status (e.g. a typed 401/403) instead of collapsing to
+   * `false`.
+   */
+  async hostOwnedSpaceResult(spaceId, purpose) {
     return this.hostSpace(spaceId, purpose);
   }
   /**
@@ -17859,9 +17880,11 @@ var NodeUserAuthorization = class {
       }
       try {
         const created = await this.hostSpace();
-        if (!created) {
-          const err = new Error(`Failed to create space: ${primarySpaceId}`);
-          handler.onSpaceCreationFailed?.(creationContext, err);
+        if (!created.success) {
+          const err = Object.assign(
+            new Error(`Failed to create space ${primarySpaceId}: ${describeHostFailure(created)}`),
+            { cause: created }
+          );
           throw err;
         }
       } catch (error) {
@@ -17877,8 +17900,9 @@ var NodeUserAuthorization = class {
         this._tinyCloudSession.delegationHeader
       );
       if (!retryResult.success) {
-        const err = new Error(
-          `Failed to activate session after creating space: ${retryResult.error}`
+        const err = Object.assign(
+          new Error(`Failed to activate session after creating space: ${describeHostFailure(retryResult)}`),
+          { cause: retryResult }
         );
         handler.onSpaceCreationFailed?.(creationContext, err);
         throw err;
@@ -17896,9 +17920,11 @@ var NodeUserAuthorization = class {
       }
       try {
         const created = await this.hostSpace();
-        if (!created) {
-          const err = new Error(`Failed to create space: ${primarySpaceId}`);
-          handler.onSpaceCreationFailed?.(creationContext, err);
+        if (!created.success) {
+          const err = Object.assign(
+            new Error(`Failed to create space ${primarySpaceId}: ${describeHostFailure(created)}`),
+            { cause: created }
+          );
           throw err;
         }
       } catch (error) {
@@ -17914,8 +17940,9 @@ var NodeUserAuthorization = class {
         this._tinyCloudSession.delegationHeader
       );
       if (!retryResult.success) {
-        const err = new Error(
-          `Failed to activate session after creating space: ${retryResult.error}`
+        const err = Object.assign(
+          new Error(`Failed to activate session after creating space: ${describeHostFailure(retryResult)}`),
+          { cause: retryResult }
         );
         handler.onSpaceCreationFailed?.(creationContext, err);
         throw err;
@@ -17923,7 +17950,10 @@ var NodeUserAuthorization = class {
       handler.onSpaceCreated?.(creationContext);
       return;
     }
-    throw new Error(`Failed to activate session: ${result.error}`);
+    throw Object.assign(
+      new Error(`Failed to activate session: ${describeHostFailure(result)}`),
+      { cause: result }
+    );
   }
   recordActivationSkippedSpaces(result, primarySpaceId) {
     if (result.success) {
@@ -18713,14 +18743,14 @@ var NodeUserAuthorization = class {
    * Request signature via event emitter with timeout.
    */
   requestSignatureViaEmitter(request, emitter, timeout) {
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve, reject2) => {
       const timeoutId = setTimeout(() => {
-        reject(new Error("Sign request timed out"));
+        reject2(new Error("Sign request timed out"));
       }, timeout);
       const respond = async (response) => {
         clearTimeout(timeoutId);
         if (!response.approved) {
-          reject(
+          reject2(
             new Error(response.reason ?? "Sign request rejected via emitter")
           );
         } else {
@@ -19315,6 +19345,25 @@ function jsonFromVerifier(value) {
 function verifierRecapEntries(entries) {
   return entries.map((entry) => Array.isArray(entry.caveats) ? { ...entry, caveats: entry.caveats.map((caveat) => jsonFromVerifier(caveat)) } : entry);
 }
+function exactVerifiedRecap(verified) {
+  const exactRecap = Array.isArray(verified.verifiedRecap) ? verifierRecapEntries(verified.verifiedRecap) : verified.verifiedRecap;
+  if (!Array.isArray(exactRecap) || !exactRecap.every(
+    (entry) => entry !== null && typeof entry === "object" && typeof entry.service === "string" && typeof entry.space === "string" && typeof entry.path === "string" && Array.isArray(entry.actions) && entry.actions.every((action) => typeof action === "string") && Array.isArray(entry.caveats) && entry.caveats.every(
+      (caveat) => caveat !== null && typeof caveat === "object" && !Array.isArray(caveat)
+    )
+  )) {
+    throw new UnsupportedSessionRestoreError(
+      "it cannot reconstruct caveat-preserving persisted ReCap authority"
+    );
+  }
+  return exactRecap.map((entry) => ({
+    service: entry.service,
+    space: entry.space,
+    path: entry.path,
+    actions: [...entry.actions],
+    caveats: cloneRecapCaveats(entry.caveats)
+  }));
+}
 var ServiceGraphLifetime = class {
   constructor(invokeFn, invokeAnyFn, fetchFn) {
     this.invokeFn = invokeFn;
@@ -19410,6 +19459,10 @@ function persistedExpiry(value) {
 function sameInstant(left, right) {
   return left.getTime() === right.getTime();
 }
+function describeHostFailure2(result) {
+  const text = result.error?.trim();
+  return text ? `${result.status} - ${text}` : `${result.status}`;
+}
 function ownerDelegationPermissions(params) {
   const hasPermissions = Object.prototype.hasOwnProperty.call(params, "permissions");
   const hasLegacy = Object.prototype.hasOwnProperty.call(params, "path") || Object.prototype.hasOwnProperty.call(params, "actions");
@@ -20213,7 +20266,10 @@ var _TinyCloudNode = class _TinyCloudNode {
       marker
     );
     if (!written.ok) {
-      throw new Error(`Failed to write bootstrap completion marker: ${written.error.message}`);
+      throw Object.assign(
+        new Error(`Failed to write bootstrap completion marker: ${written.error.message}`),
+        { cause: written.error }
+      );
     }
   }
   isAcceptedBootstrapCompletionMarker(value) {
@@ -20259,17 +20315,23 @@ var _TinyCloudNode = class _TinyCloudNode {
           rawAbilities
         });
       } catch (err) {
-        throw new Error(
-          `Account bootstrap aborted: signature rejected for space "${step.space}". Cause: ${err instanceof Error ? err.message : String(err)}`
+        throw Object.assign(
+          new Error(
+            `Account bootstrap aborted: signature rejected for space "${step.space}". Cause: ${err instanceof Error ? err.message : String(err)}`
+          ),
+          { cause: err }
         );
       }
       sessions.set(step.space, session);
     }
     for (const step of steps) {
       if (step.kind !== "host") continue;
-      const hosted = await auth.hostOwnedSpace(step.spaceId, "bootstrap-host");
-      if (!hosted) {
-        throw new Error(`Failed to host bootstrap space: ${step.spaceId}`);
+      const hosted = await auth.hostOwnedSpaceResult(step.spaceId, "bootstrap-host");
+      if (!hosted.success) {
+        throw Object.assign(
+          new Error(`Failed to host bootstrap space ${step.spaceId}: ${describeHostFailure2(hosted)}`),
+          { cause: hosted }
+        );
       }
     }
     await new Promise((resolve) => setTimeout(resolve, 100));
@@ -20281,8 +20343,11 @@ var _TinyCloudNode = class _TinyCloudNode {
       }
       const activated = await activateSessionWithHost2(host, session.delegationHeader);
       if (!activated.success || activated.skipped?.includes(step.spaceId)) {
-        throw new Error(
-          `Failed to activate bootstrap session for ${step.spaceId}: ${activated.error ?? "space was skipped"}`
+        throw Object.assign(
+          new Error(
+            `Failed to activate bootstrap session for ${step.spaceId}: ${activated.success ? "space was skipped" : describeHostFailure2(activated)}`
+          ),
+          { cause: activated }
         );
       }
       this.registerBootstrapRuntimeGrant(
@@ -20295,7 +20360,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       if (step.kind === "account-index-schema") {
         const ensured = await this.account.index.ensure();
         if (!ensured.ok) {
-          throw new Error(`Failed to create account index schema: ${ensured.error.message}`);
+          throw Object.assign(new Error(`Failed to create account index schema: ${ensured.error.message}`), { cause: ensured.error });
         }
       }
       if (step.kind === "seed-spaces") {
@@ -20310,8 +20375,9 @@ var _TinyCloudNode = class _TinyCloudNode {
           }))
         );
         if (!registered.ok) {
-          throw new Error(
-            `Failed to seed account spaces: ${registered.error.message}`
+          throw Object.assign(
+            new Error(`Failed to seed account spaces: ${registered.error.message}`),
+            { cause: registered.error }
           );
         }
         const batchError = registered.data.recoveredFromBatchError;
@@ -20332,7 +20398,7 @@ var _TinyCloudNode = class _TinyCloudNode {
           { assumeUnregistered: true }
         );
         if (!registered.ok) {
-          throw new Error(`Failed to seed bootstrap applications: ${registered.error.message}`);
+          throw Object.assign(new Error(`Failed to seed bootstrap applications: ${registered.error.message}`), { cause: registered.error });
         }
       }
       if (step.kind === "encryption-network-create") {
@@ -20350,8 +20416,9 @@ var _TinyCloudNode = class _TinyCloudNode {
           ]
         });
         if (!migrated.ok) {
-          throw new Error(
-            `Failed to create secret_records schema: ${migrated.error.message}`
+          throw Object.assign(
+            new Error(`Failed to create secret_records schema: ${migrated.error.message}`),
+            { cause: migrated.error }
           );
         }
       }
@@ -20523,8 +20590,9 @@ var _TinyCloudNode = class _TinyCloudNode {
     await this.ensureOwnedSpaceHostedById(accountSpaceId);
     const result = await this.account.applications.register(request.manifests);
     if (!result.ok) {
-      throw new Error(
-        `Failed to write manifest registry records: ${result.error.message}`
+      throw Object.assign(
+        new Error(`Failed to write manifest registry records: ${result.error.message}`),
+        { cause: result.error }
       );
     }
   }
@@ -20549,7 +20617,10 @@ var _TinyCloudNode = class _TinyCloudNode {
         if (this.currentSessionCanListSpaces()) {
           const spaces = await this.account.spaces.syncAccessible();
           if (!spaces.ok) {
-            throw new Error(`Failed to sync account spaces: ${spaces.error.message}`);
+            throw Object.assign(
+              new Error(`Failed to sync account spaces: ${spaces.error.message}`),
+              { cause: spaces.error }
+            );
           }
         }
       });
@@ -20604,14 +20675,20 @@ var _TinyCloudNode = class _TinyCloudNode {
         await task();
         return;
       } catch (error) {
+        const verdict = authorizationVerdictOf(error);
         const message = error instanceof Error ? error.message : String(error);
-        if (/Unauthorized Action|\b(?:401|403)\b/.test(message)) {
+        const isAuthorizationVerdict = verdict === void 0 ? /Unauthorized Action|\b(?:401|403)\b/.test(message) : verdict !== "other";
+        if (isAuthorizationVerdict) {
           console.warn(
             "TinyCloud account registry sync stopped: authorization verdict is not retryable",
             error
           );
           return;
         }
+        if (isStorageFullError(error) || isStorageFullError(error?.cause) || message.includes(STORAGE_FULL_MESSAGE) || message.includes(STORAGE_WRITE_TOO_LARGE_MESSAGE)) {
+          console.warn("TinyCloud account registry sync stopped: storage is full", error);
+          return;
+        }
         lastError = error;
         if (attempt < delays.length - 1) {
           await new Promise((resolve) => setTimeout(resolve, delays[attempt]));
@@ -20685,19 +20762,26 @@ var _TinyCloudNode = class _TinyCloudNode {
       return;
     }
     if (!activation.success && activation.status !== 404) {
-      throw new Error(
-        `Failed to check owned space ${spaceId}: ${activation.error ?? activation.status}`
+      throw Object.assign(
+        new Error(`Failed to check owned space ${spaceId}: ${describeHostFailure2(activation)}`),
+        { cause: activation }
       );
     }
-    const created = await this.auth.hostOwnedSpace(spaceId);
-    if (!created) {
-      throw new Error(`Failed to create owned space: ${spaceId}`);
+    const created = await this.auth.hostOwnedSpaceResult(spaceId);
+    if (!created.success) {
+      throw Object.assign(
+        new Error(`Failed to create owned space ${spaceId}: ${describeHostFailure2(created)}`),
+        { cause: created }
+      );
     }
     await new Promise((resolve) => setTimeout(resolve, 100));
     const retry = await activateSessionWithHost2(host, session.delegationHeader);
     if (!retry.success || retry.skipped?.includes(spaceId)) {
-      throw new Error(
-        `Failed to activate session after creating owned space ${spaceId}: ${retry.error ?? "space was skipped"}`
+      throw Object.assign(
+        new Error(
+          `Failed to activate session after creating owned space ${spaceId}: ${retry.success ? "space was skipped" : describeHostFailure2(retry)}`
+        ),
+        { cause: retry }
       );
     }
     this.confirmedHostedSpaceIds.add(spaceId);
@@ -20732,19 +20816,23 @@ var _TinyCloudNode = class _TinyCloudNode {
     if (!host) {
       throw new Error("Owned space hosting requires a TinyCloud host");
     }
-    const hosted = await this.auth.hostOwnedSpace(
-      spaceId
-    );
-    if (!hosted) {
-      throw new Error(`Failed to host owned space: ${spaceId}`);
+    const hosted = await this.auth.hostOwnedSpaceResult(spaceId);
+    if (!hosted.success) {
+      throw Object.assign(
+        new Error(`Failed to host owned space ${spaceId}: ${describeHostFailure2(hosted)}`),
+        { cause: hosted }
+      );
     }
     const activation = await activateSessionWithHost2(
       host,
       session.delegationHeader
     );
     if (!activation.success || activation.skipped?.includes(spaceId)) {
-      throw new Error(
-        `Failed to activate session for owned space ${spaceId}: ${activation.error ?? "space was skipped"}`
+      throw Object.assign(
+        new Error(
+          `Failed to activate session for owned space ${spaceId}: ${activation.success ? "space was skipped" : describeHostFailure2(activation)}`
+        ),
+        { cause: activation }
       );
     }
     try {
@@ -20940,23 +21028,7 @@ var _TinyCloudNode = class _TinyCloudNode {
           throw new InvalidRestoredSessionError(error instanceof Error ? error.message : String(error));
         }
       })();
-      const exactRecap = Array.isArray(verified.verifiedRecap) ? verifierRecapEntries(verified.verifiedRecap) : verified.verifiedRecap;
-      if (!Array.isArray(exactRecap) || !exactRecap.every(
-        (entry) => entry !== null && typeof entry === "object" && typeof entry.service === "string" && typeof entry.space === "string" && typeof entry.path === "string" && Array.isArray(entry.actions) && entry.actions.every((action) => typeof action === "string") && Array.isArray(entry.caveats) && entry.caveats.every(
-          (caveat) => caveat !== null && typeof caveat === "object" && !Array.isArray(caveat)
-        )
-      )) {
-        throw new UnsupportedSessionRestoreError(
-          "it cannot reconstruct caveat-preserving persisted ReCap authority"
-        );
-      }
-      stagedRecap = exactRecap.map((entry) => ({
-        service: entry.service,
-        space: entry.space,
-        path: entry.path,
-        actions: [...entry.actions],
-        caveats: cloneRecapCaveats(entry.caveats)
-      }));
+      stagedRecap = exactVerifiedRecap(verified);
       const signedExpiry = verified.expiresAt === void 0 ? void 0 : persistedExpiry(verified.expiresAt);
       const persistedPolicyExpiry = sessionData.expiresAt === void 0 ? void 0 : persistedExpiry(sessionData.expiresAt);
       if (signedExpiry && persistedPolicyExpiry && !sameInstant(signedExpiry, persistedPolicyExpiry)) {
@@ -21760,7 +21832,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     if (cached) return cached;
     const response = await fetch(`${this.config.host}/info`);
     if (!response.ok) {
-      throw new Error(`Failed to fetch node info: HTTP ${response.status}`);
+      throw await httpResponseError(response, "Failed to fetch node info");
     }
     const info = await response.json();
     if (typeof info.nodeId !== "string" || info.nodeId.length === 0) {
@@ -21810,9 +21882,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     );
     if (response.status === 404) return null;
     if (!response.ok) {
-      throw new Error(
-        `Failed to fetch encryption network ${networkId}: HTTP ${response.status} ${await response.text()}`
-      );
+      throw await httpResponseError(response, `Failed to fetch encryption network ${networkId}`);
     }
     const body = await response.json();
     return "descriptor" in body && body.descriptor ? body.descriptor : body;
@@ -22245,7 +22315,10 @@ var _TinyCloudNode = class _TinyCloudNode {
     const activation = await activateSessionWithHost2(host, delegationSession.delegationHeader);
     assertOwnerGraphActive();
     if (!activation.success) {
-      throw new Error(`Owner delegation import failed: ${activation.status} ${activation.error ?? ""}`.trim());
+      throw Object.assign(
+        new Error(`Owner delegation import failed: ${activation.status} ${activation.error ?? ""}`.trim()),
+        { cause: activation }
+      );
     }
     const delegation = {
       cid: delegationSession.delegationCid,
@@ -22310,7 +22383,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       headers: { accept: "application/json", "content-type": "application/json", authorization },
       body: canonicalizeEncryptionJson(request)
     });
-    if (!response.ok) throw new Error(`V3 share delivery authorization failed: ${response.status}`);
+    if (!response.ok) throw await httpResponseError(response, "V3 share delivery authorization failed");
     const verified = validateShareDeliveryAuthorizationV3Bytes(new Uint8Array(await response.arrayBuffer()), {
       request,
       senderKeyDid: this.credentialHolderDid,
@@ -22532,9 +22605,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       );
     }
     if (!response.ok) {
-      throw new Error(
-        `Failed to create encryption network ${networkId}: HTTP ${response.status} ${await response.text()}`
-      );
+      throw await httpResponseError(response, `Failed to create encryption network ${networkId}`);
     }
     const created = await response.json();
     return created.descriptor;
@@ -22818,6 +22889,42 @@ var _TinyCloudNode = class _TinyCloudNode {
       (left, right) => left.service.localeCompare(right.service) || (left.space ?? "").localeCompare(right.space ?? "") || left.path.localeCompare(right.path) || left.actions.join("\0").localeCompare(right.actions.join("\0"))
     );
   }
+  /**
+   * Verify a wallet-signed session grant (a CACAO built from a SIWE and its
+   * EIP-191 signature) issued to this instance's live session key. The
+   * verifier rebuilds the CACAO from `siwe` and `signature`, so the grant is
+   * accepted only when its authorization bytes and CID are exactly that CACAO,
+   * its signer is `address`, its audience is this session key, it is valid
+   * now, and its ReCap covers `spaceId` or names only raw encryption networks
+   * (a decrypt-only grant has no space). Returns the signed ReCap and expiry.
+   * Bindings without `validateSessionGrant` fall back to the session verifier,
+   * which also refuses decrypt-only grants.
+   */
+  verifySessionGrant(grant) {
+    const bindings = this.wasmBindings;
+    const validate5 = typeof bindings.validateSessionGrant === "function" ? bindings.validateSessionGrant.bind(bindings) : bindings.validatePersistedSession?.bind(bindings);
+    if (validate5 === void 0) {
+      throw new UnsupportedSessionRestoreError("it cannot verify persisted SIWE authority");
+    }
+    const verified = validate5({
+      delegationHeader: { Authorization: grant.delegationHeader.Authorization },
+      delegationCid: grant.delegationCid,
+      spaceId: grant.spaceId,
+      jwk: this.sessionKeyJwk,
+      address: canonicalizeAddress2(grant.address),
+      chainId: grant.chainId,
+      siwe: grant.siwe,
+      signature: grant.signature
+    });
+    if (typeof verified.expiresAt !== "string") {
+      throw new Error("Session grant has no signed expiry.");
+    }
+    const expiresAt = new Date(verified.expiresAt);
+    if (!Number.isFinite(expiresAt.getTime())) {
+      throw new Error("Session grant has an invalid signed expiry.");
+    }
+    return { recap: exactVerifiedRecap(verified), expiresAt };
+  }
   /**
    * Install a portable runtime permission delegation into this SDK instance so
    * matching service calls and downstream `delegateTo()` calls can use it.
@@ -22842,8 +22949,9 @@ var _TinyCloudNode = class _TinyCloudNode {
       delegation.delegationHeader
     );
     if (!activateResult.success) {
-      throw new Error(
-        `Failed to activate runtime permission delegation: ${activateResult.error}`
+      throw Object.assign(
+        new Error(`Failed to activate runtime permission delegation: ${describeHostFailure2(activateResult)}`),
+        { cause: activateResult }
       );
     }
     this.runtimePermissionGrants = this.runtimePermissionGrants.filter(
@@ -22939,8 +23047,9 @@ var _TinyCloudNode = class _TinyCloudNode {
         delegatedSession.delegationHeader
       );
       if (!activateResult.success) {
-        throw new Error(
-          `Failed to activate runtime permission delegation: ${activateResult.error}`
+        throw Object.assign(
+          new Error(`Failed to activate runtime permission delegation: ${describeHostFailure2(activateResult)}`),
+          { cause: activateResult }
         );
       }
       const delegation = this.runtimeDelegationFromSession(
@@ -22948,7 +23057,8 @@ var _TinyCloudNode = class _TinyCloudNode {
         delegatedEntries,
         spaceId,
         session,
-        expiresAt
+        expiresAt,
+        { siwe: prepared.siwe, signature: signature2 }
       );
       this.runtimePermissionGrants.push({
         session: {
@@ -23125,7 +23235,10 @@ var _TinyCloudNode = class _TinyCloudNode {
       delegationSession.delegationHeader
     );
     if (!activateResult.success) {
-      throw new Error(`Failed to activate public space delegation: ${activateResult.error}`);
+      throw Object.assign(
+        new Error(`Failed to activate public space delegation: ${describeHostFailure2(activateResult)}`),
+        { cause: activateResult }
+      );
     }
     if (this._capabilityRegistry && this.session) {
       const sessionKey = {
@@ -23478,8 +23591,9 @@ var _TinyCloudNode = class _TinyCloudNode {
       delegationHeader
     );
     if (!activateResult.success) {
-      throw new Error(
-        `Failed to activate delegation with host: ${activateResult.error}`
+      throw Object.assign(
+        new Error(`Failed to activate delegation with host: ${describeHostFailure2(activateResult)}`),
+        { cause: activateResult }
       );
     }
     return {
@@ -23515,8 +23629,9 @@ var _TinyCloudNode = class _TinyCloudNode {
       delegationHeader
     );
     if (!activateResult.success) {
-      throw new Error(
-        `Failed to activate delegation with host: ${activateResult.error}`
+      throw Object.assign(
+        new Error(`Failed to activate delegation with host: ${describeHostFailure2(activateResult)}`),
+        { cause: activateResult }
       );
     }
     return {
@@ -23729,7 +23844,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     }
     return grants;
   }
-  runtimeDelegationFromSession(delegatedSession, entries, spaceId, session, expiresAt) {
+  runtimeDelegationFromSession(delegatedSession, entries, spaceId, session, expiresAt, siweProof) {
     const resources = this.delegatedResourcesForEntries(entries, spaceId);
     const primary = resources[0];
     return {
@@ -23744,7 +23859,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       delegateDID: session.verificationMethod,
       ownerAddress: session.address,
       chainId: session.chainId,
-      host: this.config.host
+      host: this.config.host,
+      siweProof
     };
   }
   runtimeGrantFromDelegation(delegation, session) {
@@ -23937,6 +24053,9 @@ var _TinyCloudNode = class _TinyCloudNode {
     if (grantedAction === requestedAction) {
       return true;
     }
+    if (isExplicitOnlyAction(requestedAction)) {
+      return false;
+    }
     if (grantedAction.endsWith("/*")) {
       const prefix = grantedAction.slice(0, -2);
       return requestedAction.startsWith(`${prefix}/`);
@@ -24123,7 +24242,10 @@ var _TinyCloudNode = class _TinyCloudNode {
       delegationSession.delegationHeader
     );
     if (!activateResult.success) {
-      throw new Error(`Failed to activate delegation: ${activateResult.error}`);
+      throw Object.assign(
+        new Error(`Failed to activate delegation: ${describeHostFailure2(activateResult)}`),
+        { cause: activateResult }
+      );
     }
     const result = {
       cid: delegationSession.delegationCid,
@@ -24273,7 +24395,10 @@ var _TinyCloudNode = class _TinyCloudNode {
       invokerSession.delegationHeader
     );
     if (!activateResult.success) {
-      throw new Error(`Failed to activate delegated session: ${activateResult.error}`);
+      throw Object.assign(
+        new Error(`Failed to activate delegated session: ${describeHostFailure2(activateResult)}`),
+        { cause: activateResult }
+      );
     }
     const session = {
       address: mySession.address,
@@ -24390,7 +24515,10 @@ var _TinyCloudNode = class _TinyCloudNode {
       subDelegationSession.delegationHeader
     );
     if (!activateResult.success) {
-      throw new Error(`Failed to activate sub-delegation: ${activateResult.error}`);
+      throw Object.assign(
+        new Error(`Failed to activate sub-delegation: ${describeHostFailure2(activateResult)}`),
+        { cause: activateResult }
+      );
     }
     return {
       cid: subDelegationSession.delegationCid,
@@ -24459,7 +24587,10 @@ import {
   disableTinyCloudDebug,
   getTinyCloudDebugLogs,
   clearTinyCloudDebugLogs,
-  installTinyCloudDebugGlobals
+  installTinyCloudDebugGlobals,
+  isStorageFullError as isStorageFullError2,
+  STORAGE_FULL_MESSAGE as STORAGE_FULL_MESSAGE2,
+  STORAGE_WRITE_TOO_LARGE_MESSAGE as STORAGE_WRITE_TOO_LARGE_MESSAGE2
 } from "@tinycloud/sdk-core";
 
 // src/storage/FileSessionStorage.ts
@@ -24655,6 +24786,29 @@ import {
   decodeBase64Url,
   principalDidEquals as principalDidEquals3
 } from "@tinycloud/sdk-core";
+var RUNTIME_DELEGATION_REJECTIONS = [
+  "host_mismatch",
+  "expired",
+  "cid_mismatch",
+  "authority_invalid",
+  "proof_missing",
+  "proof_invalid",
+  "owner_mismatch",
+  "audience_mismatch",
+  "resources_mismatch",
+  "unsupported",
+  "activation_rejected"
+];
+var RuntimeDelegationRejectedError = class extends Error {
+  constructor(reason, message) {
+    super(message);
+    this.name = "RuntimeDelegationRejectedError";
+    this.reason = reason;
+  }
+};
+function reject(reason, message) {
+  throw new RuntimeDelegationRejectedError(reason, message);
+}
 var SERVICE_BY_SHORT_NAME = {
   kv: "tinycloud.kv",
   sql: "tinycloud.sql",
@@ -24801,6 +24955,15 @@ function signedAuthorityFromCompactUcan(authorization) {
       abilities
     ));
   }
+  return canonicalSignedAuthority({
+    issuer: payload.iss,
+    audience: payload.aud,
+    expiry,
+    proofs: [...payload.prf],
+    ...remainingRedelegationDepth === void 0 ? {} : { remainingRedelegationDepth }
+  }, permissions);
+}
+function canonicalSignedAuthority(signed2, permissions) {
   if (permissions.length === 0) {
     throw new Error("Validated runtime delegation has no signed capabilities.");
   }
@@ -24812,15 +24975,84 @@ function signedAuthorityFromCompactUcan(authorization) {
     actions: [...permission.actions],
     ...permission.caveats === void 0 ? {} : { caveats: permission.caveats }
   }));
-  return {
-    issuer: payload.iss,
-    audience: payload.aud,
-    expiry,
-    proofs: [...payload.prf],
-    ...remainingRedelegationDepth === void 0 ? {} : { remainingRedelegationDepth },
-    permissions: canonicalPermissions,
-    resources: canonicalResources
-  };
+  return { ...signed2, permissions: canonicalPermissions, resources: canonicalResources };
+}
+var RAW_ENCRYPTION_PREFIX = "urn:tinycloud:encryption:";
+var PKH_SPACE = /^tinycloud:pkh:eip155:(\d+):(0x[0-9a-fA-F]{40}):(.+)$/;
+function comparableSpace(space) {
+  const match = PKH_SPACE.exec(space);
+  return match ? `tinycloud:pkh:eip155:${match[1]}:${match[2].toLowerCase()}:${match[3]}` : space;
+}
+function signedAuthorityFromSessionGrant(node, delegation, authorization, cid) {
+  const proof = delegation.siweProof;
+  if (proof === void 0 || proof === null || typeof proof !== "object" || typeof proof.siwe !== "string" || typeof proof.signature !== "string") {
+    reject(
+      "proof_missing",
+      "Runtime delegation is a wallet-signed session grant stored without its signed SIWE proof, so its authority cannot be verified."
+    );
+  }
+  if (typeof node.verifySessionGrant !== "function") {
+    reject("unsupported", "This runtime cannot verify wallet-signed session grants.");
+  }
+  const owner = `did:pkh:eip155:${delegation.chainId}:${delegation.ownerAddress}`;
+  if (typeof node.did !== "string" || !didPrincipalsMatch(owner, node.did)) {
+    reject("owner_mismatch", "Runtime delegation is not signed by this session's owner.");
+  }
+  let verified;
+  try {
+    verified = node.verifySessionGrant({
+      delegationHeader: { Authorization: authorization },
+      delegationCid: cid,
+      spaceId: delegation.spaceId,
+      address: delegation.ownerAddress,
+      chainId: delegation.chainId,
+      siwe: proof.siwe,
+      signature: proof.signature
+    });
+  } catch (error) {
+    reject("proof_invalid", error instanceof Error ? error.message : String(error));
+  }
+  const space = comparableSpace(delegation.spaceId);
+  const spaceOwner = PKH_SPACE.exec(delegation.spaceId);
+  if (!spaceOwner || !didPrincipalsMatch(`did:pkh:eip155:${spaceOwner[1]}:${spaceOwner[2]}`, owner)) {
+    reject("authority_invalid", "Runtime delegation space is not owned by its signer.");
+  }
+  const groups = /* @__PURE__ */ new Map();
+  for (const entry of verified.recap) {
+    const service = entry.service.startsWith("tinycloud.") ? entry.service : `tinycloud.${entry.service}`;
+    const raw = entry.space === "encryption";
+    if (raw) {
+      if (service !== "tinycloud.encryption" || !entry.path.startsWith(RAW_ENCRYPTION_PREFIX)) {
+        reject("authority_invalid", "Runtime delegation has an unsupported signed raw resource.");
+      }
+      const networkOwner = entry.path.slice(RAW_ENCRYPTION_PREFIX.length, entry.path.lastIndexOf(":"));
+      if (!didPrincipalsMatch(networkOwner, owner)) {
+        reject("authority_invalid", "Runtime delegation names an encryption network its signer does not own.");
+      }
+    } else if (service === "tinycloud.encryption" || comparableSpace(entry.space) !== space) {
+      reject("authority_invalid", "Runtime delegation has signed authority outside its space.");
+    }
+    const caveats = signedCaveats(entry.caveats ?? []);
+    const key2 = JSON.stringify([service, raw ? "" : entry.space, entry.path, canonicalizeRecapCaveats2(caveats)]);
+    const group = groups.get(key2) ?? {
+      service,
+      ...raw ? {} : { space: entry.space },
+      path: entry.path,
+      actions: [],
+      ...caveats === void 0 ? {} : { caveats }
+    };
+    for (const action of entry.actions) {
+      if (!group.actions.includes(action)) group.actions.push(action);
+    }
+    groups.set(key2, group);
+  }
+  return canonicalSignedAuthority({
+    issuer: owner,
+    // The verifier bound the SIWE audience to this runtime's own session key.
+    audience: node.sessionDid,
+    expiry: verified.expiresAt,
+    proofs: []
+  }, [...groups.values()]);
 }
 function canonicalResourcesFromPortableDelegation(delegation) {
   if (delegation.resources !== void 0 && delegation.resources.length > 0) {
@@ -24856,46 +25088,58 @@ function resourcesMatch(actual, expected) {
 async function activateValidatedRuntimeDelegation(node, delegation, options) {
   const host = normalizedHost(options.host);
   if (delegation.host !== void 0 && normalizedHost(delegation.host) !== host) {
-    throw new Error(
+    reject(
+      "host_mismatch",
       `Runtime delegation host '${delegation.host}' does not match expected host '${options.host}'.`
     );
   }
   if (!(delegation.expiry instanceof Date) || Number.isNaN(delegation.expiry.getTime())) {
-    throw new Error("Runtime delegation has an invalid expiry.");
+    reject("authority_invalid", "Runtime delegation has an invalid expiry.");
   }
   if (delegation.expiry.getTime() <= Date.now()) {
-    throw new Error("Runtime delegation is expired.");
+    reject("expired", "Runtime delegation is expired.");
   }
   const authorization = delegation.delegationHeader?.Authorization;
   if (typeof authorization !== "string" || authorization.length === 0) {
-    throw new Error("Runtime delegation is missing authorization bytes.");
+    reject("authority_invalid", "Runtime delegation is missing authorization bytes.");
   }
   const cid = node.computeDelegationCid(authorization);
   if (cid !== delegation.cid) {
-    throw new Error("Runtime delegation CID does not match authorization bytes.");
+    reject("cid_mismatch", "Runtime delegation CID does not match authorization bytes.");
+  }
+  const compact = authorizationWithoutBearer(authorization).split(".").length === 3;
+  let signed2;
+  try {
+    signed2 = compact ? signedAuthorityFromCompactUcan(authorization) : signedAuthorityFromSessionGrant(node, delegation, authorization, cid);
+  } catch (error) {
+    if (error instanceof RuntimeDelegationRejectedError) throw error;
+    reject("authority_invalid", error instanceof Error ? error.message : String(error));
   }
-  const signed2 = signedAuthorityFromCompactUcan(authorization);
   if (signed2.expiry.getTime() <= Date.now()) {
-    throw new Error("Runtime delegation is expired.");
+    reject("expired", "Runtime delegation is expired.");
   }
   if (delegation.expiry.getTime() !== signed2.expiry.getTime()) {
-    throw new Error("Runtime delegation expiry does not match signed authority.");
+    reject("authority_invalid", "Runtime delegation expiry does not match signed authority.");
   }
   if (!didPrincipalsMatch(signed2.audience, node.sessionDid)) {
-    throw new Error(
+    reject(
+      "audience_mismatch",
       `Runtime delegation targets ${signed2.audience} but this session is ${node.sessionDid}.`
     );
   }
   if (!didPrincipalsMatch(delegation.delegateDID, signed2.audience)) {
-    throw new Error("Runtime delegation audience does not match signed authority.");
+    reject("audience_mismatch", "Runtime delegation audience does not match signed authority.");
+  }
+  if (compact && !resourcesMatch(canonicalResourcesFromPortableDelegation(delegation), signed2.resources)) {
+    reject("resources_mismatch", "Runtime delegation resources do not match signed authority.");
   }
-  const declaredResources = canonicalResourcesFromPortableDelegation(delegation);
-  if (!resourcesMatch(declaredResources, signed2.resources)) {
-    throw new Error("Runtime delegation resources do not match signed authority.");
+  if (options.authorize !== void 0 && !options.authorize(signed2.permissions)) {
+    throw new Error("Runtime delegation is not authorized for this runtime.");
   }
   const previouslyInstalled = node.getRuntimePermissionDelegations().find((candidate) => candidate.cid === cid);
   if (previouslyInstalled !== void 0 && previouslyInstalled.delegationHeader.Authorization !== authorization) {
-    throw new Error(
+    reject(
+      "cid_mismatch",
       "A different authorization is already installed for this runtime delegation CID."
     );
   }
@@ -24925,22 +25169,28 @@ async function activateValidatedRuntimeDelegation(node, delegation, options) {
     })),
     expiry: new Date(signed2.expiry),
     delegateDID: signed2.audience,
-    host
+    host,
+    ...compact ? {} : { siweProof: delegation.siweProof }
   };
-  if (node.isSessionOnly === true && typeof node.did === "string" && principalDidEquals3(node.did, node.sessionDid) && typeof node.useDelegation === "function") {
-    await node.useDelegation(installedCandidate);
-  } else {
-    await node.useRuntimeDelegation(installedCandidate);
+  try {
+    if (node.isSessionOnly === true && typeof node.did === "string" && principalDidEquals3(node.did, node.sessionDid) && typeof node.useDelegation === "function") {
+      await node.useDelegation(installedCandidate);
+    } else {
+      await node.useRuntimeDelegation(installedCandidate);
+    }
+  } catch (error) {
+    reject("activation_rejected", error instanceof Error ? error.message : String(error));
   }
   const installed = node.getRuntimePermissionDelegations().find((candidate) => candidate.cid === cid);
   if (!installed) {
-    throw new Error("Runtime delegation activation did not install the validated authority.");
+    reject("activation_rejected", "Runtime delegation activation did not install the validated authority.");
   }
   if (installed.delegationHeader.Authorization !== authorization || !didPrincipalsMatch(installed.delegateDID, signed2.audience) || installed.expiry.getTime() !== signed2.expiry.getTime() || !resourcesMatch(
     canonicalResourcesFromPortableDelegation(installed),
     signed2.resources
   ) || normalizedHost(installed.host ?? "") !== host) {
-    throw new Error(
+    reject(
+      "activation_rejected",
       "Runtime delegation activation installed authority that differs from the validated authority."
     );
   }
@@ -25171,9 +25421,13 @@ export {
   PrefixedKVService,
   PrivateKeySigner,
   ProtocolMismatchError,
+  RUNTIME_DELEGATION_REJECTIONS,
+  RuntimeDelegationRejectedError,
   SECRET_NAME_RE,
   SQLAction,
   SQLService3 as SQLService,
+  STORAGE_FULL_MESSAGE2 as STORAGE_FULL_MESSAGE,
+  STORAGE_WRITE_TOO_LARGE_MESSAGE2 as STORAGE_WRITE_TOO_LARGE_MESSAGE,
   SecretsService2 as SecretsService,
   ServiceContext3 as ServiceContext,
   SessionExpiredError2 as SessionExpiredError,
@@ -25249,6 +25503,7 @@ export {
   isCapabilitySubset2 as isCapabilitySubset,
   isEvmAddress,
   isNetworkId,
+  isStorageFullError2 as isStorageFullError,
   loadManifest,
   makePkhSpaceId2 as makePkhSpaceId,
   makePublicSpaceId2 as makePublicSpaceId,