@tinycloud/node-sdk 3.1.0-beta.9 → 3.2.0-beta.0

package/dist/core.d.cts

@@ -1,4 +1,4 @@
 export { ACCOUNT_REGISTRY_PATH, ACCOUNT_REGISTRY_SPACE, AccountApplication, AccountApplicationListOptions, AccountApplicationRegisterOptions, AccountDelegation, AccountDelegationListOptions, AccountDelegationRevokeOptions, AccountIndexEnsureResult, AccountIndexRebuildResult, AccountIndexStatus, AccountIndexedReadOptions, AccountService, AccountServiceConfig, AccountSpace, AccountSpaceListOptions, AccountStatus, AutoApproveSpaceCreationHandler, AutoRejectStrategy, AutoSignStrategy, BatchOptions, BatchResponse, CallbackStrategy, CanonicalAddress, CanonicalParsedNetworkId, CapabilityEntry, CapabilityKeyRegistry, CapabilityKeyRegistryErrorCode, CapabilityKeyRegistryErrorCodes, CaveatedDelegationUnsupportedError, ClientSession, ColumnInfo, ComposeManifestOptions, ComposedManifestRequest, CreateDelegationParams, DEFAULT_MANIFEST_SPACE, DEFAULT_MANIFEST_VERSION, DEFAULT_SIGNED_READ_URL_EXPIRY_MS, DataVaultConfig, DataVaultService, DatabaseHandle, DelegateReceivedShareParams, DelegatedShareAccess, Delegation, DelegationChain, DelegationChainV2, DelegationDirection, DelegationError, DelegationErrorCode, DelegationErrorCodes, DelegationFilters, DelegationManager, DelegationManagerConfig, DelegationRecord, DelegationResult, DidCacheKeyOptions, DidEqualsOptions, DuckDbAction, DuckDbActionType, DuckDbBatchOptions, DuckDbBatchResponse, DuckDbDatabaseHandle, DuckDbExecuteOptions, DuckDbExecuteResponse, DuckDbOptions, DuckDbQueryOptions, DuckDbQueryResponse, DuckDbService, DuckDbServiceConfig, DuckDbStatement, DuckDbValue, EncodedShareData, ExecuteOptions, ExecuteResponse, Extension, FetchFunction, GenerateShareParams, ICapabilityKeyRegistry, IDataVaultService, IDatabaseHandle, IDuckDbDatabaseHandle, IDuckDbService, IENSResolver, IKVService, INotificationHandler, IPrefixedKVService, ISQLService, ISecretsService, ISessionManager, ISessionStorage, ISharingService, ISigner, ISpace, ISpaceCreationHandler, ISpaceScopedDelegations, ISpaceScopedSharing, ISpaceService, IUserAuthorization, IWasmBindings, IdentityParseError, IngestOptions, InvokeFunction, JWK, KVBatchReadResponse, KVCreateSignedReadUrlOptions, KVResponse, KVService, KVServiceConfig, KVSignedReadUrlResponse, KeyInfo, KeyProvider, KeyType, Manifest, ManifestDefaults, ManifestRegistryRecord, ManifestSecretActions, ManifestValidationError, OpenKeyCallbackStrategy, OpenKeySigningRequestBody, OpenKeySigningResponseBody, OpenKeySigningStrategyOptions, ParsedSecretCatalogKey, PermissionEntry, PermissionNotInManifestError, PersistedSessionData, PkhDidParts, PrefixedKVService, ProtocolMismatchError, QueryOptions, QueryResponse, ReceiveOptions, RegisterBatchSuccess, RegisterPolicyV3Input, RegisterPolicyV3Receipt, ResolvedCapabilities, ResolvedDelegate, ResolvedSecretPath, ResourceCapability, SECRET_NAME_RE, SQLAction, SQLActionType, SQLService, SQLServiceConfig, SchemaInfo, SecretCatalogEntry, SecretPayload, SecretScopeOptions, SecretsError, SecretsService, ServiceContext, ServiceContextConfig, ServiceSession, SessionExpiredError, ShareAccess, ShareLink, ShareLinkData, ShareSchema, SharingService, SharingServiceConfig, SignCallback, SignInOptions, SignRequest, SignResponse, SilentNotificationHandler, Space, SpaceAbilitiesMap, SpaceConfig, SpaceCreationContext, SpaceErrorCode, SpaceErrorCodes, SpaceInfo, SpaceOwnership, SpaceService, SpaceServiceConfig, SqlStatement, SqlValue, StoredDelegationChain, TableInfo, TelemetryConfig, TelemetryEventHandler, TinyCloud, TinyCloudConfig, TinyCloudDebugEnableOptions, TinyCloudDebugEvent, TinyCloudDebugLevel, TinyCloudDebugLogger, TinyCloudDebugTimer, TinyCloudSession, UnsupportedFeatureError, VAULT_PERMISSION_SERVICE, VaultCrypto, VaultEntry, VaultError, VaultGetOptions, VaultGrantOptions, VaultHeaders, VaultListOptions, VaultNetworkReadResult, VaultPublicSpaceKVActions, VaultPutOptions, VersionCheckError, ViewInfo, WasmVaultFunctions, addressStorageKey, buildSpaceUri, canonicalizeAddress, canonicalizeDid, canonicalizeDidUrl, canonicalizeNetworkId, canonicalizeSecretScope, checkNodeInfo, clearTinyCloudDebugLogs, composeManifestRequest, createCapabilityKeyRegistry, createOpenKeyCallbackSigningStrategy, createSharingService, createSpaceService, createVaultCrypto, defaultSpaceCreationHandler, didCacheKey, didEquals, disableTinyCloudDebug, enableTinyCloudDebug, expandActionShortNames, expandPermissionEntries, expandPermissionEntry, getTinyCloudDebugLogs, installTinyCloudDebugGlobals, isCapabilitySubset, isEvmAddress, loadManifest, makePkhSpaceId, makePublicSpaceId, parseCanonicalNetworkId, parseExpiry, parsePkhDid, parseSecretCatalogKey, parseSpaceUri, pkhDid, principalDid, principalDidEquals, resolveManifest, resolveSecretListPrefix, resolveSecretPath, resourceCapabilitiesToSpaceAbilitiesMap, tinyCloudDebugLogger, validateManifest } from '@tinycloud/sdk-core';
-export { e as BootstrapWarning, C as CompactRuntimeDelegationInput, f as CreateOwnerDelegationParams, D as DelegateToOptions, g as DelegateToResult, h as DelegatedAccess, E as EnsureEncryptionNetworkOptions, F as FileSessionStorage, I as InvalidRestoredSessionError, M as MemorySessionStorage, N as NodeEventEmitterStrategy, j as NodeUserAuthorization, k as NodeUserAuthorizationConfig, O as OwnerDelegationReceipt, P as PortableDelegation, p as RuntimePermissionGrantOptions, S as SecretPermissionHint, q as SecretReadInput, r as SecretReadResult, t as SignStrategy, T as TinyCloudNode, u as TinyCloudNodeConfig, U as UnifiedOwnerRootInput, v as UnifiedOwnerRootReceipt, w as UnsupportedSessionRestoreError, V as ValidatedRuntimeDelegation, W as WasmKeyProvider, y as WasmKeyProviderConfig, z as activateCompactRuntimeDelegation, H as createWasmKeyProvider, J as defaultSignStrategy, K as deserializeDelegation, Q as serializeDelegation } from './core-CC7uDKZP.cjs';
+export { e as BootstrapWarning, C as CompactRuntimeDelegationInput, f as CreateOwnerDelegationParams, D as DelegateToOptions, g as DelegateToResult, h as DelegatedAccess, E as EnsureEncryptionNetworkOptions, F as FileSessionStorage, I as InvalidRestoredSessionError, M as MemorySessionStorage, N as NodeEventEmitterStrategy, j as NodeUserAuthorization, k as NodeUserAuthorizationConfig, O as OwnerDelegationReceipt, P as PortableDelegation, p as RuntimePermissionGrantOptions, S as SecretPermissionHint, q as SecretReadInput, r as SecretReadResult, t as SignStrategy, T as TinyCloudNode, u as TinyCloudNodeConfig, U as UnifiedOwnerRootInput, v as UnifiedOwnerRootReceipt, w as UnsupportedSessionRestoreError, V as ValidatedRuntimeDelegation, W as WasmKeyProvider, y as WasmKeyProviderConfig, z as activateCompactRuntimeDelegation, H as createWasmKeyProvider, J as defaultSignStrategy, K as deserializeDelegation, Q as serializeDelegation } from './core-AEx5vAa8.cjs';
 import 'events';
 import '@tinycloud/sdk-services';

package/dist/core.d.ts

@@ -1,4 +1,4 @@
 export { ACCOUNT_REGISTRY_PATH, ACCOUNT_REGISTRY_SPACE, AccountApplication, AccountApplicationListOptions, AccountApplicationRegisterOptions, AccountDelegation, AccountDelegationListOptions, AccountDelegationRevokeOptions, AccountIndexEnsureResult, AccountIndexRebuildResult, AccountIndexStatus, AccountIndexedReadOptions, AccountService, AccountServiceConfig, AccountSpace, AccountSpaceListOptions, AccountStatus, AutoApproveSpaceCreationHandler, AutoRejectStrategy, AutoSignStrategy, BatchOptions, BatchResponse, CallbackStrategy, CanonicalAddress, CanonicalParsedNetworkId, CapabilityEntry, CapabilityKeyRegistry, CapabilityKeyRegistryErrorCode, CapabilityKeyRegistryErrorCodes, CaveatedDelegationUnsupportedError, ClientSession, ColumnInfo, ComposeManifestOptions, ComposedManifestRequest, CreateDelegationParams, DEFAULT_MANIFEST_SPACE, DEFAULT_MANIFEST_VERSION, DEFAULT_SIGNED_READ_URL_EXPIRY_MS, DataVaultConfig, DataVaultService, DatabaseHandle, DelegateReceivedShareParams, DelegatedShareAccess, Delegation, DelegationChain, DelegationChainV2, DelegationDirection, DelegationError, DelegationErrorCode, DelegationErrorCodes, DelegationFilters, DelegationManager, DelegationManagerConfig, DelegationRecord, DelegationResult, DidCacheKeyOptions, DidEqualsOptions, DuckDbAction, DuckDbActionType, DuckDbBatchOptions, DuckDbBatchResponse, DuckDbDatabaseHandle, DuckDbExecuteOptions, DuckDbExecuteResponse, DuckDbOptions, DuckDbQueryOptions, DuckDbQueryResponse, DuckDbService, DuckDbServiceConfig, DuckDbStatement, DuckDbValue, EncodedShareData, ExecuteOptions, ExecuteResponse, Extension, FetchFunction, GenerateShareParams, ICapabilityKeyRegistry, IDataVaultService, IDatabaseHandle, IDuckDbDatabaseHandle, IDuckDbService, IENSResolver, IKVService, INotificationHandler, IPrefixedKVService, ISQLService, ISecretsService, ISessionManager, ISessionStorage, ISharingService, ISigner, ISpace, ISpaceCreationHandler, ISpaceScopedDelegations, ISpaceScopedSharing, ISpaceService, IUserAuthorization, IWasmBindings, IdentityParseError, IngestOptions, InvokeFunction, JWK, KVBatchReadResponse, KVCreateSignedReadUrlOptions, KVResponse, KVService, KVServiceConfig, KVSignedReadUrlResponse, KeyInfo, KeyProvider, KeyType, Manifest, ManifestDefaults, ManifestRegistryRecord, ManifestSecretActions, ManifestValidationError, OpenKeyCallbackStrategy, OpenKeySigningRequestBody, OpenKeySigningResponseBody, OpenKeySigningStrategyOptions, ParsedSecretCatalogKey, PermissionEntry, PermissionNotInManifestError, PersistedSessionData, PkhDidParts, PrefixedKVService, ProtocolMismatchError, QueryOptions, QueryResponse, ReceiveOptions, RegisterBatchSuccess, RegisterPolicyV3Input, RegisterPolicyV3Receipt, ResolvedCapabilities, ResolvedDelegate, ResolvedSecretPath, ResourceCapability, SECRET_NAME_RE, SQLAction, SQLActionType, SQLService, SQLServiceConfig, SchemaInfo, SecretCatalogEntry, SecretPayload, SecretScopeOptions, SecretsError, SecretsService, ServiceContext, ServiceContextConfig, ServiceSession, SessionExpiredError, ShareAccess, ShareLink, ShareLinkData, ShareSchema, SharingService, SharingServiceConfig, SignCallback, SignInOptions, SignRequest, SignResponse, SilentNotificationHandler, Space, SpaceAbilitiesMap, SpaceConfig, SpaceCreationContext, SpaceErrorCode, SpaceErrorCodes, SpaceInfo, SpaceOwnership, SpaceService, SpaceServiceConfig, SqlStatement, SqlValue, StoredDelegationChain, TableInfo, TelemetryConfig, TelemetryEventHandler, TinyCloud, TinyCloudConfig, TinyCloudDebugEnableOptions, TinyCloudDebugEvent, TinyCloudDebugLevel, TinyCloudDebugLogger, TinyCloudDebugTimer, TinyCloudSession, UnsupportedFeatureError, VAULT_PERMISSION_SERVICE, VaultCrypto, VaultEntry, VaultError, VaultGetOptions, VaultGrantOptions, VaultHeaders, VaultListOptions, VaultNetworkReadResult, VaultPublicSpaceKVActions, VaultPutOptions, VersionCheckError, ViewInfo, WasmVaultFunctions, addressStorageKey, buildSpaceUri, canonicalizeAddress, canonicalizeDid, canonicalizeDidUrl, canonicalizeNetworkId, canonicalizeSecretScope, checkNodeInfo, clearTinyCloudDebugLogs, composeManifestRequest, createCapabilityKeyRegistry, createOpenKeyCallbackSigningStrategy, createSharingService, createSpaceService, createVaultCrypto, defaultSpaceCreationHandler, didCacheKey, didEquals, disableTinyCloudDebug, enableTinyCloudDebug, expandActionShortNames, expandPermissionEntries, expandPermissionEntry, getTinyCloudDebugLogs, installTinyCloudDebugGlobals, isCapabilitySubset, isEvmAddress, loadManifest, makePkhSpaceId, makePublicSpaceId, parseCanonicalNetworkId, parseExpiry, parsePkhDid, parseSecretCatalogKey, parseSpaceUri, pkhDid, principalDid, principalDidEquals, resolveManifest, resolveSecretListPrefix, resolveSecretPath, resourceCapabilitiesToSpaceAbilitiesMap, tinyCloudDebugLogger, validateManifest } from '@tinycloud/sdk-core';
-export { e as BootstrapWarning, C as CompactRuntimeDelegationInput, f as CreateOwnerDelegationParams, D as DelegateToOptions, g as DelegateToResult, h as DelegatedAccess, E as EnsureEncryptionNetworkOptions, F as FileSessionStorage, I as InvalidRestoredSessionError, M as MemorySessionStorage, N as NodeEventEmitterStrategy, j as NodeUserAuthorization, k as NodeUserAuthorizationConfig, O as OwnerDelegationReceipt, P as PortableDelegation, p as RuntimePermissionGrantOptions, S as SecretPermissionHint, q as SecretReadInput, r as SecretReadResult, t as SignStrategy, T as TinyCloudNode, u as TinyCloudNodeConfig, U as UnifiedOwnerRootInput, v as UnifiedOwnerRootReceipt, w as UnsupportedSessionRestoreError, V as ValidatedRuntimeDelegation, W as WasmKeyProvider, y as WasmKeyProviderConfig, z as activateCompactRuntimeDelegation, H as createWasmKeyProvider, J as defaultSignStrategy, K as deserializeDelegation, Q as serializeDelegation } from './core-CC7uDKZP.js';
+export { e as BootstrapWarning, C as CompactRuntimeDelegationInput, f as CreateOwnerDelegationParams, D as DelegateToOptions, g as DelegateToResult, h as DelegatedAccess, E as EnsureEncryptionNetworkOptions, F as FileSessionStorage, I as InvalidRestoredSessionError, M as MemorySessionStorage, N as NodeEventEmitterStrategy, j as NodeUserAuthorization, k as NodeUserAuthorizationConfig, O as OwnerDelegationReceipt, P as PortableDelegation, p as RuntimePermissionGrantOptions, S as SecretPermissionHint, q as SecretReadInput, r as SecretReadResult, t as SignStrategy, T as TinyCloudNode, u as TinyCloudNodeConfig, U as UnifiedOwnerRootInput, v as UnifiedOwnerRootReceipt, w as UnsupportedSessionRestoreError, V as ValidatedRuntimeDelegation, W as WasmKeyProvider, y as WasmKeyProviderConfig, z as activateCompactRuntimeDelegation, H as createWasmKeyProvider, J as defaultSignStrategy, K as deserializeDelegation, Q as serializeDelegation } from './core-AEx5vAa8.js';
 import 'events';
 import '@tinycloud/sdk-services';

package/dist/core.js

@@ -2708,15 +2708,21 @@ var _TinyCloudNode = class _TinyCloudNode {
       if (!this.wasmBindings.invokeAny) {
         throw new Error("WASM binding does not support invokeAny");
       }
-      const operations = entries.flatMap((entry) => {
+      const routedEntries = entries;
+      const operations = routedEntries.flatMap((entry) => {
         const operation = this.operationFromInvokeAnyEntry(entry);
         return operation ? [operation] : [];
       });
-      const grant = this.findGrantForOperations(operations);
-      const invocationSession = !grant || grant.provenance === "primary" ? session : grant.session;
-      const caveatPreservingEntries = grant ? entries.map((entry) => {
+      const authorityCid = routedEntries.length === 1 ? routedEntries[0]?.revokeAuthorityCid : void 0;
+      const explicitGrant = authorityCid === void 0 ? void 0 : this.runtimePermissionGrants.find((grant2) => grant2.delegation.cid === authorityCid);
+      if (authorityCid !== void 0 && !explicitGrant) {
+        throw new Error(`Explicit revocation authority ${authorityCid} is not installed.`);
+      }
+      const grant = explicitGrant ?? this.findGrantForOperations(operations);
+      const invocationSession = explicitGrant ? explicitGrant.session : !grant || grant.provenance === "primary" ? session : grant.session;
+      const caveatPreservingEntries = routedEntries.map(({ revokeAuthorityCid: _cid, ...entry }) => {
         const requested = this.operationFromInvokeAnyEntry(entry);
-        const granted = requested && grant.operations.find(
+        const granted = grant && requested && grant.operations.find(
           (candidate) => this.operationCovers(candidate, requested)
         );
         if (!granted?.caveats?.length) {
@@ -2726,7 +2732,7 @@ var _TinyCloudNode = class _TinyCloudNode {
           throw new Error("Invocation caveats do not match signed ReCap authority.");
         }
         return { ...entry, caveats: cloneRecapCaveats(granted.caveats) };
-      }) : entries;
+      });
       return this.wasmBindings.invokeAny(invocationSession, caveatPreservingEntries, facts);
     };
     this.explicitHost = config.host;
@@ -3191,12 +3197,13 @@ var _TinyCloudNode = class _TinyCloudNode {
     if (!auth) {
       throw new Error("Account bootstrap requires an active wallet session");
     }
+    const accountSpaceId = this.ownedSpaceId(ACCOUNT_REGISTRY_SPACE2);
     const skipped = auth.lastActivationSkippedSpaceIds;
+    if (skipped.includes(accountSpaceId)) return { action: "run", mode: "fresh" };
     if (skipped.some((spaceId) => enshrinedSpaceIds.has(spaceId))) {
-      return { action: "run", mode: "fresh" };
+      return { action: "run", mode: "repair" };
     }
     try {
-      const accountSpaceId = this.ownedSpaceId(ACCOUNT_REGISTRY_SPACE2);
       const markerPermission = {
         service: "tinycloud.kv",
         space: accountSpaceId,
@@ -3208,7 +3215,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       }
       const marker = await this.readBootstrapCompletionMarker();
       if (marker.ok) {
-        if (this.isAcceptedBootstrapCompletionMarker(marker.data.data)) {
+        if (this.isAcceptedBootstrapCompletionMarker(marker.data.data, steps.map((step) => step.id))) {
           return { action: "skip" };
         }
         return { action: "run", mode: "repair" };
@@ -3258,12 +3265,16 @@ var _TinyCloudNode = class _TinyCloudNode {
       );
     }
   }
-  isAcceptedBootstrapCompletionMarker(value) {
+  /**
+   * A marker written before a canonical space was added triggers one bounded repair.
+   */
+  isAcceptedBootstrapCompletionMarker(value, canonicalStepIds) {
     if (typeof value !== "object" || value === null) return false;
     const entries = Object.entries(value);
     const markerValue = (name) => entries.find(([key]) => key === name)?.[1];
     const version = markerValue("v");
-    return typeof version === "number" && Number.isInteger(version) && ACCEPTED_MARKER_VERSIONS.some((acceptedVersion) => acceptedVersion === version);
+    const stepIds = markerValue("stepIds");
+    return typeof version === "number" && Number.isInteger(version) && ACCEPTED_MARKER_VERSIONS.some((acceptedVersion) => acceptedVersion === version) && Array.isArray(stepIds) && canonicalStepIds.every((stepId) => stepIds.includes(stepId));
   }
   markerReadIsUnhostedSpace(meta) {
     return meta?.status === 404;
@@ -3350,30 +3361,39 @@ var _TinyCloudNode = class _TinyCloudNode {
         }
       }
       if (step.kind === "seed-spaces") {
-        const registered = await this.account.spaces.registerBatch(
-          step.spaces.map((space) => ({
-            spaceId: space.spaceId,
-            name: space.name,
-            ownerDid: this.did,
-            type: "owned",
-            permissions: ["*"],
-            status: "active"
-          }))
-        );
-        if (!registered.ok) {
-          throw Object.assign(
-            new Error(`Failed to seed account spaces: ${registered.error.message}`),
-            { cause: registered.error }
-          );
-        }
-        const batchError = registered.data.recoveredFromBatchError;
-        if (batchError) {
-          warnings.push({
-            stepId: step.id,
-            kind: "batch-write-reconciled",
-            code: batchError.code,
-            message: batchError.message
-          });
+        const inputs = step.spaces.map((space) => ({
+          spaceId: space.spaceId,
+          name: space.name,
+          ownerDid: this.did,
+          type: "owned",
+          permissions: ["*"],
+          status: "active"
+        }));
+        if (mode === "fresh") {
+          const registered = await this.account.spaces.registerBatch(inputs);
+          if (!registered.ok) {
+            throw Object.assign(
+              new Error(`Failed to seed account spaces: ${registered.error.message}`),
+              { cause: registered.error }
+            );
+          }
+          const batchError = registered.data.recoveredFromBatchError;
+          if (batchError) {
+            warnings.push({
+              stepId: step.id,
+              kind: "batch-write-reconciled",
+              code: batchError.code,
+              message: batchError.message
+            });
+          }
+        } else {
+          const ensured = await this.account.spaces.registerMissing(inputs);
+          if (!ensured.ok) {
+            throw Object.assign(
+              new Error(`Failed to seed account spaces: ${ensured.error.message}`),
+              { cause: ensured.error }
+            );
+          }
         }
       }
       if (step.kind === "seed-applications") {
@@ -4058,6 +4078,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       stagedSessionExpiry,
       stagedRecap
     );
+    const stagedAccountSpaceId = stagedAddress ? this.wasmBindings.makeSpaceId(stagedAddress, stagedChainId, ACCOUNT_REGISTRY_SPACE2) : void 0;
     const stagedGraph = this.stageRestoredServiceGraph({
       host: stagedHost,
       manager: stagedManager,
@@ -4066,6 +4087,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       nodeDid: stagedNodeDid,
       address: stagedAddress,
       chainId: stagedChainId,
+      accountSpaceId: stagedAccountSpaceId,
       tinyCloudSession: stagedTcSession,
       sessionExpiry: stagedSessionExpiry,
       recap: stagedRecap
@@ -4231,6 +4253,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     }
     const delegationManager = new DelegationManager({
       hosts: [input.host],
+      accountSpaceId: input.accountSpaceId,
       session: input.serviceSession,
       invoke: graph.invoke,
       invokeAny: graph.invokeAny,
@@ -5935,6 +5958,14 @@ var _TinyCloudNode = class _TinyCloudNode {
       delegation.delegationHeader
     );
     if (!activateResult.success) {
+      if (this.operationsFromDelegation(delegation).some(
+        (operation) => operation.resource?.startsWith("urn:cid:") === true && operation.service === "delegation" && operation.action === "tinycloud.delegation/revoke"
+      ) && activateResult.status === 401 && /Cannot find parent delegation/i.test(activateResult.error ?? "")) {
+        throw Object.assign(
+          new Error("The host cannot activate a root raw-CID revoke authority without a parent delegation."),
+          { code: "RAW_RECAP_RESOURCE_UNSUPPORTED", cause: activateResult }
+        );
+      }
       throw Object.assign(
         new Error(`Failed to activate runtime permission delegation: ${describeHostFailure2(activateResult)}`),
         { cause: activateResult }
@@ -5982,10 +6013,10 @@ var _TinyCloudNode = class _TinyCloudNode {
     }
     this.assertDelegationCaveatsPreservable(expanded);
     const rawEntries = expanded.filter(
-      (entry) => this.isEncryptionPermissionEntry(entry)
+      (entry) => this.isEncryptionPermissionEntry(entry) || this.isRawRevocationPermissionEntry(entry)
     );
     const spaceEntries = expanded.filter(
-      (entry) => !this.isEncryptionPermissionEntry(entry)
+      (entry) => !this.isEncryptionPermissionEntry(entry) && !this.isRawRevocationPermissionEntry(entry)
     );
     const bySpace = /* @__PURE__ */ new Map();
     for (const entry of spaceEntries) {
@@ -6012,17 +6043,29 @@ var _TinyCloudNode = class _TinyCloudNode {
       }
       const delegatedEntries = [...entries, ...rawForDelegation];
       const abilities = this.permissionsToAbilities(entries);
-      const prepared = this.wasmBindings.prepareSession({
-        abilities,
-        ...rawForDelegation.length > 0 ? { rawAbilities: this.permissionsToRawAbilities(rawForDelegation) } : {},
-        address: this.wasmBindings.ensureEip55(session.address),
-        chainId: session.chainId,
-        domain: this.siweDomain,
-        issuedAt: now.toISOString(),
-        expirationTime: expiresAt.toISOString(),
-        spaceId,
-        jwk: session.jwk
-      });
+      const prepared = (() => {
+        try {
+          return this.wasmBindings.prepareSession({
+            abilities,
+            ...rawForDelegation.length > 0 ? { rawAbilities: this.permissionsToRawAbilities(rawForDelegation) } : {},
+            address: this.wasmBindings.ensureEip55(session.address),
+            chainId: session.chainId,
+            domain: this.siweDomain,
+            issuedAt: now.toISOString(),
+            expirationTime: expiresAt.toISOString(),
+            spaceId,
+            jwk: session.jwk
+          });
+        } catch (error) {
+          if (rawForDelegation.some((entry) => this.isRawRevocationPermissionEntry(entry)) && /invalid ReCap resource URI/i.test(error instanceof Error ? error.message : String(error))) {
+            throw Object.assign(
+              new Error("This WASM build cannot encode raw urn:cid ReCap resources."),
+              { code: "RAW_RECAP_RESOURCE_UNSUPPORTED", cause: error }
+            );
+          }
+          throw error;
+        }
+      })();
       const signature = await this.signer.signMessage(prepared.siwe);
       const delegatedSession = this.wasmBindings.completeSessionSetup({
         ...prepared,
@@ -6033,6 +6076,12 @@ var _TinyCloudNode = class _TinyCloudNode {
         delegatedSession.delegationHeader
       );
       if (!activateResult.success) {
+        if (rawForDelegation.some((entry) => this.isRawRevocationPermissionEntry(entry)) && activateResult.status === 401 && /Cannot find parent delegation/i.test(activateResult.error ?? "")) {
+          throw Object.assign(
+            new Error("The host cannot activate a root raw-CID revoke authority without a parent delegation."),
+            { code: "RAW_RECAP_RESOURCE_UNSUPPORTED", cause: activateResult }
+          );
+        }
         throw Object.assign(
           new Error(`Failed to activate runtime permission delegation: ${describeHostFailure2(activateResult)}`),
           { cause: activateResult }
@@ -6385,8 +6434,18 @@ var _TinyCloudNode = class _TinyCloudNode {
    * @throws {@link PermissionNotInManifestError} when any requested
    *   entry is not a subset of the granted session capabilities and
    *   `forceWalletSign` is not set.
+   * @throws when `onPrepared` is combined with `forceWalletSign: true`,
+   *   before anything is signed.
+   * @throws the `onPrepared` rejection, unchanged, without activating the
+   *   delegation.
    */
   async delegateTo(did, permissions, options) {
+    const onPrepared = options?.onPrepared;
+    if (onPrepared && options?.forceWalletSign) {
+      throw new Error(
+        "delegateTo: onPrepared cannot be combined with forceWalletSign=true; the wallet-signed path activates the delegation before it could be handed to onPrepared."
+      );
+    }
     const session = this.currentTinyCloudSession();
     if (!session) {
       throw new SessionExpiredError(/* @__PURE__ */ new Date(0));
@@ -6445,7 +6504,8 @@ var _TinyCloudNode = class _TinyCloudNode {
           expandedEntries,
           runtimeExpiration,
           runtimeGrant,
-          runtimeOperations
+          runtimeOperations,
+          onPrepared
         );
         return { delegation: delegation2, prompted: false };
       }
@@ -6455,7 +6515,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       did,
       expandedEntries,
       effectiveExpiration,
-      session
+      session,
+      onPrepared
     );
     return { delegation, prompted: false };
   }
@@ -6509,7 +6570,7 @@ var _TinyCloudNode = class _TinyCloudNode {
    *
    * @internal
    */
-  async createDelegationViaWasmPath(did, entries, expirationTime, session) {
+  async createDelegationViaWasmPath(did, entries, expirationTime, session, onPrepared) {
     if (entries.length === 0) {
       throw new Error(
         "createDelegationViaWasmPath requires a non-empty entries array"
@@ -6572,17 +6633,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     });
     const primary = result.resources[0];
     const delegationHeader = { Authorization: result.delegation };
-    const activateResult = await activateSessionWithHost2(
-      this.config.host,
-      delegationHeader
-    );
-    if (!activateResult.success) {
-      throw Object.assign(
-        new Error(`Failed to activate delegation with host: ${describeHostFailure2(activateResult)}`),
-        { cause: activateResult }
-      );
-    }
-    return {
+    const delegation = {
       cid: result.cid,
       delegationHeader,
       spaceId,
@@ -6596,8 +6647,22 @@ var _TinyCloudNode = class _TinyCloudNode {
       chainId: session.chainId,
       host: this.config.host
     };
+    if (onPrepared) {
+      await onPrepared(delegation);
+    }
+    const activateResult = await activateSessionWithHost2(
+      this.config.host,
+      delegationHeader
+    );
+    if (!activateResult.success) {
+      throw Object.assign(
+        new Error(`Failed to activate delegation with host: ${describeHostFailure2(activateResult)}`),
+        { cause: activateResult }
+      );
+    }
+    return delegation;
   }
-  async createDelegationViaRuntimeGrant(did, entries, expirationTime, grant, requestedOperations) {
+  async createDelegationViaRuntimeGrant(did, entries, expirationTime, grant, requestedOperations, onPrepared) {
     this.assertRuntimeGrantCaveatsPreservable(entries, requestedOperations, grant);
     this.assertDelegationCaveatsPreservable(entries);
     const result = this.createDelegationWrapper({
@@ -6610,17 +6675,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     const primary = result.resources[0];
     const delegationHeader = { Authorization: result.delegation };
     const targetHost = grant.delegation.host ?? this.config.host;
-    const activateResult = await activateSessionWithHost2(
-      targetHost,
-      delegationHeader
-    );
-    if (!activateResult.success) {
-      throw Object.assign(
-        new Error(`Failed to activate delegation with host: ${describeHostFailure2(activateResult)}`),
-        { cause: activateResult }
-      );
-    }
-    return {
+    const delegation = {
       cid: result.cid,
       delegationHeader,
       spaceId: grant.session.spaceId,
@@ -6634,6 +6689,20 @@ var _TinyCloudNode = class _TinyCloudNode {
       chainId: grant.delegation.chainId,
       host: targetHost
     };
+    if (onPrepared) {
+      await onPrepared(delegation);
+    }
+    const activateResult = await activateSessionWithHost2(
+      targetHost,
+      delegationHeader
+    );
+    if (!activateResult.success) {
+      throw Object.assign(
+        new Error(`Failed to activate delegation with host: ${describeHostFailure2(activateResult)}`),
+        { cause: activateResult }
+      );
+    }
+    return delegation;
   }
   resolvePermissionSpace(space, session) {
     if (space === void 0) {
@@ -6734,6 +6803,7 @@ var _TinyCloudNode = class _TinyCloudNode {
   permissionsToAbilities(entries) {
     const abilities = {};
     for (const entry of entries) {
+      if (this.isRawRevocationPermissionEntry(entry)) continue;
       const service = this.shortServiceName(entry.service);
       abilities[service] ?? (abilities[service] = {});
       const existing = abilities[service][entry.path] ?? [];
@@ -6751,9 +6821,16 @@ var _TinyCloudNode = class _TinyCloudNode {
   isEncryptionPermissionEntry(entry) {
     return entry.service === ENCRYPTION_PERMISSION_SERVICE2 && this.isEncryptionNetworkOperation("encryption", entry.path, entry.space);
   }
+  isRawRevocationPermissionEntry(entry) {
+    return entry.service === "tinycloud.delegation" && entry.path === "" && entry.space?.startsWith("urn:cid:") === true && entry.actions.includes("tinycloud.delegation/revoke");
+  }
   permissionsToRawAbilities(entries) {
     const rawAbilities = {};
     for (const entry of entries) {
+      if (this.isRawRevocationPermissionEntry(entry)) {
+        rawAbilities[entry.space] = [...new Set(entry.actions)];
+        continue;
+      }
       if (!this.isEncryptionPermissionEntry(entry)) {
         continue;
       }
@@ -6773,7 +6850,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     return entries.flatMap((entry) => {
       const service = this.shortServiceName(entry.service);
       return entry.actions.map((action) => ({
-        ...this.isEncryptionNetworkOperation(service, entry.path, entry.space) ? { resource: entry.path } : { spaceId },
+        ...this.isRawRevocationPermissionEntry(entry) ? { resource: entry.space } : this.isEncryptionNetworkOperation(service, entry.path, entry.space) ? { resource: entry.path } : { spaceId },
         service,
         path: entry.path,
         action,
@@ -6783,11 +6860,13 @@ var _TinyCloudNode = class _TinyCloudNode {
   }
   /** Raw network authority cannot be covered by a nested encryption space. */
   signedCapabilitySubset(requested, granted) {
-    const rawGranted = granted.filter((entry) => this.isEncryptionPermissionEntry(entry)).map((entry) => ({ ...entry, space: "encryption" }));
-    const spaceGranted = granted.filter((entry) => !this.isEncryptionPermissionEntry(entry));
+    const rawGranted = granted.filter((entry) => this.isEncryptionPermissionEntry(entry) || this.isRawRevocationPermissionEntry(entry)).map((entry) => this.isEncryptionPermissionEntry(entry) ? { ...entry, space: "encryption" } : entry);
+    const spaceGranted = granted.filter(
+      (entry) => !this.isEncryptionPermissionEntry(entry) && !this.isRawRevocationPermissionEntry(entry)
+    );
     const missing = requested.filter((entry) => {
-      const raw = this.isEncryptionPermissionEntry(entry);
-      const comparable = raw ? { ...entry, space: "encryption" } : entry;
+      const raw = this.isEncryptionPermissionEntry(entry) || this.isRawRevocationPermissionEntry(entry);
+      const comparable = raw && this.isEncryptionPermissionEntry(entry) ? { ...entry, space: "encryption" } : entry;
       return !isCapabilitySubset([comparable], raw ? rawGranted : spaceGranted).subset;
     });
     return { subset: missing.length === 0, missing };
@@ -6802,10 +6881,11 @@ var _TinyCloudNode = class _TinyCloudNode {
   }
   permissionEntriesToOperations(entries, session) {
     return entries.flatMap((entry) => {
-      const spaceId = this.resolvePermissionSpace(entry.space, session);
+      const rawRevocation = this.isRawRevocationPermissionEntry(entry);
+      const spaceId = rawRevocation ? void 0 : this.resolvePermissionSpace(entry.space, session);
       const service = this.shortServiceName(entry.service);
       return entry.actions.map((action) => ({
-        ...this.isEncryptionNetworkOperation(service, entry.path, entry.space) ? { resource: entry.path } : { spaceId },
+        ...rawRevocation ? { resource: entry.space } : this.isEncryptionNetworkOperation(service, entry.path, entry.space) ? { resource: entry.path } : { spaceId },
         service,
         path: entry.path,
         action,
@@ -6884,7 +6964,7 @@ var _TinyCloudNode = class _TinyCloudNode {
   delegatedResourcesForEntries(entries, spaceId) {
     return entries.map((entry) => ({
       service: this.shortServiceName(entry.service),
-      space: this.isEncryptionPermissionEntry(entry) ? "encryption" : spaceId,
+      space: this.isRawRevocationPermissionEntry(entry) ? entry.space : this.isEncryptionPermissionEntry(entry) ? "encryption" : spaceId,
       path: entry.path,
       actions: [...entry.actions],
       ...entry.caveats === void 0 ? {} : { caveats: cloneRecapCaveats(entry.caveats) }
@@ -6894,8 +6974,9 @@ var _TinyCloudNode = class _TinyCloudNode {
     const resources = delegation.resources !== void 0 && delegation.resources.length > 0 ? delegation.resources : this.flatDelegationResources(delegation);
     return resources.flatMap((resource) => {
       const service = this.invocationServiceName(resource.service);
+      const rawRevocation = service === "delegation" && resource.space.startsWith("urn:cid:") && resource.path === "";
       return resource.actions.map((action) => ({
-        ...this.isEncryptionNetworkOperation(service, resource.path, resource.space) ? { resource: resource.path } : { spaceId: resource.space },
+        ...rawRevocation ? { resource: resource.space } : this.isEncryptionNetworkOperation(service, resource.path, resource.space) ? { resource: resource.path } : { spaceId: resource.space },
         service,
         path: resource.path,
         action,
@@ -6941,7 +7022,7 @@ var _TinyCloudNode = class _TinyCloudNode {
    * @internal
    */
   buildActivationAbilities(delegation) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d;
     const resources = delegation.resources !== void 0 && delegation.resources.length > 0 ? delegation.resources : this.flatDelegationResources(delegation);
     const abilities = {};
     const rawAbilities = {};
@@ -6961,13 +7042,18 @@ var _TinyCloudNode = class _TinyCloudNode {
         addActions(rawAbilities[resource.path], resource.actions);
         continue;
       }
+      if (service === "delegation" && resource.space.startsWith("urn:cid:") && resource.path === "") {
+        rawAbilities[_b = resource.space] ?? (rawAbilities[_b] = []);
+        addActions(rawAbilities[resource.space], resource.actions);
+        continue;
+      }
       if (resource.space !== delegation.spaceId) {
         throw new Error(
           `useDelegation: resource targets space '${resource.space}' but the delegation activates space '${delegation.spaceId}'. Multi-space delegations cannot be activated in a single useDelegation call.`
         );
       }
       abilities[service] ?? (abilities[service] = {});
-      (_b = abilities[service])[_c = resource.path] ?? (_b[_c] = []);
+      (_c = abilities[service])[_d = resource.path] ?? (_c[_d] = []);
       addActions(abilities[service][resource.path], resource.actions);
     }
     return { abilities, rawAbilities };