@tinycloud/node-sdk 3.4.0 → 3.5.0-beta.1

package/dist/{TinyCloudNode-DeV-L_14.d.cts → TinyCloudNode-N4mfZI_k.d.cts}

@@ -1,8 +1,8 @@
 import * as _tinycloud_sdk_core from '@tinycloud/sdk-core';
 import { AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, CapabilityPresentationEnvelopeV1, IUserAuthorization, ISigner, ISessionStorage, ISpaceCreationHandler, RegistryPolicy, RegistrySequenceStore, OnNodeNotFound, LocalNodeIdentityStore, IWasmBindings, ISessionManager, SiweConfig, Manifest, ComposedManifestRequest, ReplicationOptions, TinyCloudSession, PersistedSessionData, ClientSession, PermissionEntry, Extension, SignRequest, SpaceHostResult, SignInOptions, Delegation, DelegatedResource, TelemetryConfig, ServiceContext, IKVService, ISQLService, IDuckDbService, IHooksService, CreateOwnerDelegationParams as CreateOwnerDelegationParams$1, OwnerDelegationReceipt as OwnerDelegationReceipt$1, StorageFullEvent, IStorageService, INotificationHandler, IENSResolver, RetryPolicy, KVReplicaStorage, AccountService, InvokeAnyFunction as InvokeAnyFunction$1, UnifiedPolicyCapability, RegisterPolicyV3Input, RegisterPolicyV3Receipt, CanonicalJson, ShareDeliveryAuthorizationV3Receipt, IDataVaultService, IEncryptionService, NetworkDescriptor, ISecretsService, ICapabilityKeyRegistry, DelegationManager, ISpaceService, ISpace, ISharingService, DelegationResult, DelegationRevocationReceipt, DelegationStatus, ServiceSession, ReplicationControl, ResolvedDelegate } from '@tinycloud/sdk-core';
 import { ReplicaSessionStamp } from '@tinycloud/sdk-services/kv/replication';
+import { InvokeFunction, InvokeAnyFunction, FetchFunction, RequestSink, RequestLogReader } from '@tinycloud/sdk-services';
 import { EventEmitter } from 'events';
-import { InvokeFunction, InvokeAnyFunction, FetchFunction } from '@tinycloud/sdk-services';
 
 /**
  * Node.js-specific SignStrategy types for TinyCloud authorization.
@@ -1090,6 +1090,7 @@ declare class DelegatedAccess {
     constructor(session: TinyCloudSession, delegation: PortableDelegation, host: string, invoke: InvokeFunction, invokeAny?: InvokeAnyFunction, telemetry?: TelemetryConfig, lifetime?: {
         fetch: FetchFunction;
         track(context: ServiceContext): ServiceContext;
+        requestSink?: RequestSink;
     });
     /**
      * Get the delegation this access was created from.
@@ -1230,6 +1231,8 @@ interface TinyCloudNodeConfig {
     signStrategy?: SignStrategy;
     /** Explicit TinyCloud server URL. When omitted, signIn resolves the user's host. */
     host?: string;
+    /** Build a developer request log (sanitized, in-memory, bounded). Off by default. */
+    requestLog?: boolean;
     /** TinyCloud location registry URL. Default: https://registry.tinycloud.xyz. */
     tinycloudRegistryUrl?: string | null;
     /**
@@ -1517,6 +1520,7 @@ declare class TinyCloudNode {
     private wasmBindings;
     private sessionManager;
     private _serviceGraph;
+    private readonly _requestLog?;
     private _serviceContext?;
     private _kv?;
     private readonly replicationRuntime?;
@@ -1713,6 +1717,8 @@ declare class TinyCloudNode {
      */
     private setupAuth;
     private shouldUseBootstrapSignInRequest;
+    /** Sanitized developer request events; undefined unless the node was built with `requestLog: true`. */
+    get requests(): RequestLogReader | undefined;
     private createServiceGraphLifetime;
     private syncResolvedHostFromAuth;
     /**

package/dist/{TinyCloudNode-DeV-L_14.d.ts → TinyCloudNode-N4mfZI_k.d.ts}

@@ -1,8 +1,8 @@
 import * as _tinycloud_sdk_core from '@tinycloud/sdk-core';
 import { AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, CapabilityPresentationEnvelopeV1, IUserAuthorization, ISigner, ISessionStorage, ISpaceCreationHandler, RegistryPolicy, RegistrySequenceStore, OnNodeNotFound, LocalNodeIdentityStore, IWasmBindings, ISessionManager, SiweConfig, Manifest, ComposedManifestRequest, ReplicationOptions, TinyCloudSession, PersistedSessionData, ClientSession, PermissionEntry, Extension, SignRequest, SpaceHostResult, SignInOptions, Delegation, DelegatedResource, TelemetryConfig, ServiceContext, IKVService, ISQLService, IDuckDbService, IHooksService, CreateOwnerDelegationParams as CreateOwnerDelegationParams$1, OwnerDelegationReceipt as OwnerDelegationReceipt$1, StorageFullEvent, IStorageService, INotificationHandler, IENSResolver, RetryPolicy, KVReplicaStorage, AccountService, InvokeAnyFunction as InvokeAnyFunction$1, UnifiedPolicyCapability, RegisterPolicyV3Input, RegisterPolicyV3Receipt, CanonicalJson, ShareDeliveryAuthorizationV3Receipt, IDataVaultService, IEncryptionService, NetworkDescriptor, ISecretsService, ICapabilityKeyRegistry, DelegationManager, ISpaceService, ISpace, ISharingService, DelegationResult, DelegationRevocationReceipt, DelegationStatus, ServiceSession, ReplicationControl, ResolvedDelegate } from '@tinycloud/sdk-core';
 import { ReplicaSessionStamp } from '@tinycloud/sdk-services/kv/replication';
+import { InvokeFunction, InvokeAnyFunction, FetchFunction, RequestSink, RequestLogReader } from '@tinycloud/sdk-services';
 import { EventEmitter } from 'events';
-import { InvokeFunction, InvokeAnyFunction, FetchFunction } from '@tinycloud/sdk-services';
 
 /**
  * Node.js-specific SignStrategy types for TinyCloud authorization.
@@ -1090,6 +1090,7 @@ declare class DelegatedAccess {
     constructor(session: TinyCloudSession, delegation: PortableDelegation, host: string, invoke: InvokeFunction, invokeAny?: InvokeAnyFunction, telemetry?: TelemetryConfig, lifetime?: {
         fetch: FetchFunction;
         track(context: ServiceContext): ServiceContext;
+        requestSink?: RequestSink;
     });
     /**
      * Get the delegation this access was created from.
@@ -1230,6 +1231,8 @@ interface TinyCloudNodeConfig {
     signStrategy?: SignStrategy;
     /** Explicit TinyCloud server URL. When omitted, signIn resolves the user's host. */
     host?: string;
+    /** Build a developer request log (sanitized, in-memory, bounded). Off by default. */
+    requestLog?: boolean;
     /** TinyCloud location registry URL. Default: https://registry.tinycloud.xyz. */
     tinycloudRegistryUrl?: string | null;
     /**
@@ -1517,6 +1520,7 @@ declare class TinyCloudNode {
     private wasmBindings;
     private sessionManager;
     private _serviceGraph;
+    private readonly _requestLog?;
     private _serviceContext?;
     private _kv?;
     private readonly replicationRuntime?;
@@ -1713,6 +1717,8 @@ declare class TinyCloudNode {
      */
     private setupAuth;
     private shouldUseBootstrapSignInRequest;
+    /** Sanitized developer request events; undefined unless the node was built with `requestLog: true`. */
+    get requests(): RequestLogReader | undefined;
     private createServiceGraphLifetime;
     private syncResolvedHostFromAuth;
     /**

package/dist/{authority-BO2VqGnD.d.cts → authority-BgZpUFss.d.cts}

@@ -1,7 +1,7 @@
 import { ReplicationOptions, PermissionEntry, TinyCloudSession, KVReplicaStorage, ServiceContext, IWasmBindings, WasmRecapEntry } from '@tinycloud/sdk-core';
 import { ReplicaConsentAnchor, AuthorityRefusal, ReplicationAuthority } from '@tinycloud/sdk-services';
 import { ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-DeV-L_14.cjs';
+import { T as TinyCloudNode } from './TinyCloudNode-N4mfZI_k.cjs';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/{authority-CtsxSAoP.d.ts → authority-C670-9su.d.ts}

@@ -1,7 +1,7 @@
 import { ReplicationOptions, PermissionEntry, TinyCloudSession, KVReplicaStorage, ServiceContext, IWasmBindings, WasmRecapEntry } from '@tinycloud/sdk-core';
 import { ReplicaConsentAnchor, AuthorityRefusal, ReplicationAuthority } from '@tinycloud/sdk-services';
 import { ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-DeV-L_14.js';
+import { T as TinyCloudNode } from './TinyCloudNode-N4mfZI_k.js';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/core.cjs

@@ -2121,6 +2121,167 @@ var NodeUserAuthorization = class {
   }
 };
 
+// src/recordingServiceContext.ts
+var import_sdk_services2 = require("@tinycloud/sdk-services");
+var import_requestLog = require("@tinycloud/sdk-services/telemetry/requestLog");
+
+// src/recordingRegistry.ts
+var unrecordedFetches = /* @__PURE__ */ new WeakMap();
+function registerRecording(context, unrecordedFetch) {
+  unrecordedFetches.set(context, unrecordedFetch);
+}
+function unrecordedFetchOf(context) {
+  const unrecordedFetch = unrecordedFetches.get(context);
+  return unrecordedFetch ? unrecordedFetch() : context.fetch;
+}
+
+// src/recordingServiceContext.ts
+var SYNC_ABILITY = "tinycloud.kv/sync";
+var INFO_PATH = "/info";
+function outcomeCodeOf(response) {
+  return response === void 0 ? "ERROR" : response.ok ? "ok" : `HTTP_${response.status}`;
+}
+function replicationOp(url, meta) {
+  if (meta !== void 0) return meta.action === SYNC_ABILITY ? `${meta.service}/sync` : void 0;
+  return isInfoUrl(url) ? "sync/info" : void 0;
+}
+function isInfoUrl(url) {
+  try {
+    return new URL(url).pathname.replace(/\/+$/, "") === INFO_PATH;
+  } catch {
+    return false;
+  }
+}
+function replicationEvent(sample, op) {
+  return (0, import_requestLog.buildRequestEvent)({
+    service: "sync",
+    op,
+    url: sample.url,
+    bytes: (0, import_requestLog.requestBytesOf)(sample.init?.body, sample.response?.headers.get("content-length")),
+    durationMs: performance.now() - sample.clock,
+    attempts: sample.attempts ?? 1,
+    ok: sample.response?.ok === true,
+    code: outcomeCodeOf(sample.response),
+    at: sample.at
+  });
+}
+function createServiceContext(config) {
+  const { requestSink, ...base } = config;
+  return requestSink === void 0 ? new import_sdk_services2.ServiceContext(base) : new RecordingServiceContext(base, requestSink);
+}
+var RecordingServiceContext = class extends import_sdk_services2.ServiceContext {
+  constructor(config, sink) {
+    const pending = {};
+    super({
+      ...config,
+      invoke: rememberInvoke(config.invoke, sink, pending),
+      invokeAny: config.invokeAny ? rememberInvokeAny(config.invokeAny, sink, pending) : void 0
+    });
+    this.requestSink = sink;
+    this.pending = pending;
+    registerRecording(this, () => this.unrecordedFetch);
+  }
+  /** Per-call recording; `_fetch` is read at access time, so overrides apply. */
+  get fetch() {
+    const raw = super.fetch;
+    return (url, init) => this.recordCall(raw, url, init);
+  }
+  /** Transport without per-call recording. */
+  get unrecordedFetch() {
+    return super.fetch;
+  }
+  /**
+   * One event per logical request. The first resolved attempt's init is the logged request and
+   * `attempts` counts resolved builds. A retired context throws before the first build and records
+   * nothing, as master does.
+   */
+  async invokeWithRetry(url, build) {
+    const at = Date.now();
+    const clock = performance.now();
+    let reached = false;
+    let attempts = 0;
+    let first;
+    let firstMeta;
+    let response;
+    const attempt = async () => {
+      reached = true;
+      this.pending.meta = void 0;
+      const built = build();
+      const meta = this.pending.meta;
+      const init = await built;
+      attempts += 1;
+      if (first === void 0) {
+        first = init;
+        firstMeta = meta;
+      }
+      return init;
+    };
+    try {
+      response = await super.invokeWithRetry(url, attempt);
+      return response;
+    } finally {
+      if (reached) {
+        this.observeAttempt({ url, init: first, response, meta: firstMeta, at, clock, attempts });
+      }
+    }
+  }
+  async recordCall(fetchFn, url, init) {
+    const at = Date.now();
+    const clock = performance.now();
+    let response;
+    try {
+      response = await fetchFn(url, init);
+      return response;
+    } finally {
+      this.observeAttempt({ url, init, response, at, clock });
+    }
+  }
+  observeAttempt(sample) {
+    try {
+      const replication = replicationOp(sample.url, sample.meta ?? (0, import_requestLog.invocationMetaOf)(sample.init?.headers));
+      if (replication !== void 0) {
+        this.requestSink.record(replicationEvent(sample, replication));
+        return;
+      }
+      const headers = sample.init?.headers;
+      if (sample.meta !== void 0 && typeof headers === "object" && headers !== null) {
+        this.requestSink.remember(headers, sample.meta);
+      }
+      this.requestSink.observe({
+        url: sample.url,
+        requestHeaders: headers,
+        requestBody: sample.init?.body,
+        responseContentLength: sample.response?.headers.get("content-length"),
+        ok: sample.response?.ok === true,
+        code: outcomeCodeOf(sample.response),
+        durationMs: performance.now() - sample.clock,
+        attempts: sample.attempts ?? 1,
+        at: sample.at
+      });
+    } catch {
+    }
+  }
+};
+function rememberInvoke(invoke, sink, pending) {
+  return (session, service, path, action, facts) => {
+    const headers = invoke(session, service, path, action, facts);
+    const meta = { service, path, action, spaceId: session.spaceId };
+    pending.meta = meta;
+    sink.remember(headers, meta);
+    return headers;
+  };
+}
+function rememberInvokeAny(invokeAny, sink, pending) {
+  return (session, entries, facts) => {
+    const headers = invokeAny(session, entries, facts);
+    const first = entries[0];
+    const meta = first === void 0 ? void 0 : { service: first.service, path: first.path, action: first.action, spaceId: first.spaceId ?? session.spaceId };
+    pending.meta = meta;
+    if (meta !== void 0) sink.remember(headers, meta);
+    return headers;
+  };
+}
+
 // src/delegation.ts
 var import_sdk_core5 = require("@tinycloud/sdk-core");
 var RuntimeDelegationRejectedError = class extends Error {
@@ -2602,7 +2763,8 @@ function deserializeDelegation(data) {
 // src/TinyCloudNode.ts
 var import_siwe2 = require("siwe");
 var import_sdk_core10 = require("@tinycloud/sdk-core");
-var import_sdk_services2 = require("@tinycloud/sdk-services");
+var import_sdk_services3 = require("@tinycloud/sdk-services");
+var import_requestLog2 = require("@tinycloud/sdk-services/telemetry/requestLog");
 
 // src/account/AccountService.ts
 var import_sdk_core6 = require("@tinycloud/sdk-core");
@@ -2620,12 +2782,13 @@ var DelegatedAccess = class {
     this.session = session;
     this._delegation = delegation;
     this.host = host;
-    const context = new import_sdk_core7.ServiceContext({
+    const context = createServiceContext({
       invoke,
       invokeAny,
       fetch: lifetime?.fetch ?? globalThis.fetch.bind(globalThis),
       hosts: [host],
-      telemetry
+      telemetry,
+      requestSink: lifetime?.requestSink
     });
     this._serviceContext = lifetime ? lifetime.track(context) : context;
     const prefix = this._delegation.path.replace(/\/$/, "");
@@ -2820,6 +2983,16 @@ function legacyParamsToPermissionEntries(actions, path, spaceIdOverride) {
   return entries;
 }
 var DEFAULT_DELEGATION_EXPIRY_MS = import_sdk_core8.EXPIRY.SESSION_MS;
+var SHARE_NETWORK_NAME_RE = /^share-[a-z0-9][a-z0-9-]{15,35}$/;
+function grantsCappedDecrypt(path, actions) {
+  if (!actions.some((action) => (0, import_sdk_core8.actionContains)(action, import_sdk_core8.ENCRYPTION.DECRYPT))) {
+    return false;
+  }
+  return !((0, import_sdk_core8.isNetworkId)(path) && SHARE_NETWORK_NAME_RE.test((0, import_sdk_core8.parseNetworkId)(path).name));
+}
+function includesDecrypt(entries) {
+  return entries.some((entry) => grantsCappedDecrypt(entry.path, entry.actions));
+}
 function resolveExpiryMs(expiry) {
   if (expiry === void 0) {
     return DEFAULT_DELEGATION_EXPIRY_MS;
@@ -2987,6 +3160,15 @@ var NodeSecretsService = class {
     if (this.hasPermission(permissionEntries)) {
       return ok();
     }
+    let escalation;
+    try {
+      escalation = this.config.uncoveredEntries?.(permissionEntries) ?? permissionEntries;
+    } catch (error) {
+      return this.escalationError(action, target, error);
+    }
+    if (this.config.uncoveredEntries !== void 0 && escalation.length === 0) {
+      return ok();
+    }
     if (!this.config.canEscalate()) {
       return secretsError(
         import_sdk_core9.ErrorCodes.PERMISSION_DENIED,
@@ -2994,16 +3176,20 @@ var NodeSecretsService = class {
       );
     }
     try {
-      await this.config.grantPermissions(permissionEntries);
+      const grant = action === "get" && this.config.grantGetPermissions !== void 0 ? this.config.grantGetPermissions : this.config.grantPermissions;
+      await grant(escalation);
       return this.restoreUnlockAfterEscalation();
     } catch (error) {
-      return secretsError(
-        import_sdk_core9.ErrorCodes.PERMISSION_DENIED,
-        error instanceof Error ? error.message : `Autosign escalation for ${displayActionUrn(action)} on ${target} failed.`,
-        error instanceof Error ? error : void 0
-      );
+      return this.escalationError(action, target, error);
     }
   }
+  escalationError(action, target, error) {
+    return secretsError(
+      import_sdk_core9.ErrorCodes.PERMISSION_DENIED,
+      error instanceof Error ? error.message : `Autosign escalation for ${displayActionUrn(action)} on ${target} failed.`,
+      error instanceof Error ? error : void 0
+    );
+  }
   async restoreUnlockAfterEscalation() {
     if (!this.shouldRestoreUnlock) {
       return ok();
@@ -3215,11 +3401,12 @@ function createDefaultSessionKey(wasm) {
   return { manager, keyId, jwk: JSON.parse(jwkStr) };
 }
 var ServiceGraphLifetime = class {
-  constructor(invokeFn, invokeAnyFn, fetchFn, observeContext) {
+  constructor(invokeFn, invokeAnyFn, fetchFn, observeContext, requestSink) {
     this.invokeFn = invokeFn;
     this.invokeAnyFn = invokeAnyFn;
     this.fetchFn = fetchFn;
     this.observeContext = observeContext;
+    this.requestSink = requestSink;
     this.abortController = new AbortController();
     this.contexts = /* @__PURE__ */ new Set();
     this.retired = false;
@@ -3408,6 +3595,8 @@ function ownerPermissionsToAbilities(permissions) {
   return { abilities, rawAbilities };
 }
 var TERMINAL_DELEGATION_REQUIRES_SESSION_KEY = "disableSubDelegation requires a session-key delegation to a did:key (not did:pkh); use the session-key DID or drop the flag";
+var DECRYPT_GRANT_MAX_EXPIRY_MS = 60 * 60 * 1e3;
+var SECRET_GET_GRANT_EXPIRY_MS = 59 * 60 * 1e3;
 function base64UrlEncode(bytes) {
   const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
   let output = "";
@@ -3790,6 +3979,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     this.sessionManager = sessionKey.manager;
     this.sessionKeyId = sessionKey.keyId;
     this.sessionKeyJwk = sessionKey.jwk;
+    this._requestLog = config.requestLog === true ? new import_requestLog2.RequestLog() : void 0;
     this._serviceGraph = this.createServiceGraphLifetime();
     this._capabilityRegistry = new import_sdk_core10.CapabilityKeyRegistry();
     this._keyProvider = new WasmKeyProvider({
@@ -3961,7 +4151,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       createKVService: (config) => {
         const prefix = config.pathPrefix?.replace(/\/$/, "");
         const kvService = new import_sdk_core10.KVService({ prefix });
-        const kvContext = receiveOnlyGraph.track(new import_sdk_core10.ServiceContext({
+        const kvContext = receiveOnlyGraph.track(createServiceContext({
+          requestSink: receiveOnlyGraph.requestSink,
           invoke: config.invoke,
           fetch: config.fetch ?? globalThis.fetch.bind(globalThis),
           hosts: config.hosts,
@@ -4024,6 +4215,10 @@ var _TinyCloudNode = class _TinyCloudNode {
   shouldUseBootstrapSignInRequest(config) {
     return config.autoBootstrapAccount !== false && config.manifest === void 0 && config.capabilityRequest === void 0 && (config.prefix ?? "default") === "default" && isOpenKeyAutoSignStrategy(config.signStrategy);
   }
+  /** Sanitized developer request events; undefined unless the node was built with `requestLog: true`. */
+  get requests() {
+    return this._requestLog === void 0 ? void 0 : (0, import_requestLog2.readOnlyRequestLog)(this._requestLog);
+  }
   createServiceGraphLifetime() {
     return new ServiceGraphLifetime(
       this.invokeWithRuntimePermissions,
@@ -4034,7 +4229,9 @@ var _TinyCloudNode = class _TinyCloudNode {
       (url, init) => globalThis.fetch(url, init),
       (context) => {
         this.storageFull.observe(context);
-      }
+        if (this._requestLog) (0, import_requestLog2.observeReplicaReads)(context, this._requestLog);
+      },
+      this._requestLog
     );
   }
   syncResolvedHostFromAuth() {
@@ -4357,6 +4554,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     this.hostedOwnedSpaceIds.clear();
     this.cancelOwnedSpaceHosts();
     this.storageFull.clear();
+    this._requestLog?.clear();
     this._bootstrapSkipped = false;
     this._bootstrapStatus = { skipped: false };
     this.replicationDelegateSession = void 0;
@@ -4448,7 +4646,10 @@ var _TinyCloudNode = class _TinyCloudNode {
       const denial = await this.denyReplicaGate({ reason: "account_switch", principal: priorPrincipal, next: nextPrincipal });
       this.replicaRestoreGate = denial?.status === "unguarded" ? "gate_unavailable" : "stamp_stale";
     }
-    if (address !== this._address || chainId !== this._chainId) this.storageFull.clear();
+    if (address !== this._address || chainId !== this._chainId) {
+      this.storageFull.clear();
+      this._requestLog?.clear();
+    }
     this._address = address;
     this._chainId = chainId;
     this._kv = void 0;
@@ -5027,10 +5228,11 @@ var _TinyCloudNode = class _TinyCloudNode {
     const contexts = [context];
     const accountSpaceId = this.ownedSpaceId(import_sdk_core10.ACCOUNT_REGISTRY_SPACE);
     const createScopedContext = (spaceId) => {
-      const scoped = this._serviceGraph.track(new import_sdk_core10.ServiceContext({
+      const scoped = this._serviceGraph.track(createServiceContext({
+        requestSink: this._serviceGraph.requestSink,
         invoke: context.invoke,
         invokeAny: context.invokeAny,
-        fetch: context.fetch,
+        fetch: unrecordedFetchOf(context),
         hosts: context.hosts,
         telemetry: this.config.telemetry,
         retryPolicy: this.config.retryPolicy
@@ -5082,7 +5284,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     if (!this.currentSessionCoversAccountRegistry()) {
       if (!_TinyCloudNode.accountRegistrySkipLogged) {
         _TinyCloudNode.accountRegistrySkipLogged = true;
-        import_sdk_services2.tinyCloudDebugLogger.log("registry.skip");
+        import_sdk_services3.tinyCloudDebugLogger.log("registry.skip");
       }
       return;
     }
@@ -5094,10 +5296,11 @@ var _TinyCloudNode = class _TinyCloudNode {
     const promise = this.enqueueAccountRegistryOperation(session, async () => {
       const sharedContext = this._serviceContext;
       if (!sharedContext) return;
-      const context = this._serviceGraph.track(new import_sdk_core10.ServiceContext({
+      const context = this._serviceGraph.track(createServiceContext({
+        requestSink: this._serviceGraph.requestSink,
         invoke: sharedContext.invoke,
         invokeAny: sharedContext.invokeAny,
-        fetch: sharedContext.fetch,
+        fetch: unrecordedFetchOf(sharedContext),
         hosts: sharedContext.hosts,
         telemetry: this.config.telemetry,
         retryPolicy: this.config.retryPolicy
@@ -5831,6 +6034,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     if (resolvedHost) this.config.host = resolvedHost;
     if (spaceOwnerKey(serviceSession.spaceId) !== this.currentStorageOwner()) {
       this.storageFull.clear();
+      this._requestLog?.clear();
     }
     this._address = stagedAddress;
     this._chainId = stagedChainId;
@@ -5950,7 +6154,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       const coreContext = graph.track(core.serviceContext);
       coreContext.setSession(input.serviceSession);
     }
-    const serviceContext = graph.track(new import_sdk_core10.ServiceContext({
+    const serviceContext = graph.track(createServiceContext({
+      requestSink: graph.requestSink,
       invoke: graph.invoke,
       invokeAny: graph.invokeAny,
       fetch: graph.fetch,
@@ -6038,7 +6243,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       },
       createKVService: (config) => {
         const service = new import_sdk_core10.KVService({ prefix: config.pathPrefix?.replace(/\/$/, "") });
-        const context = graph.track(new import_sdk_core10.ServiceContext({
+        const context = graph.track(createServiceContext({
+          requestSink: graph.requestSink,
           invoke: config.invoke,
           fetch: config.fetch ?? globalThis.fetch.bind(globalThis),
           hosts: config.hosts,
@@ -6078,7 +6284,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       createKVService: (spaceId) => {
         graph.assertActive();
         const scopedKv = new import_sdk_core10.KVService({});
-        const context = graph.track(new import_sdk_core10.ServiceContext({
+        const context = graph.track(createServiceContext({
+          requestSink: graph.requestSink,
           invoke: graph.invoke,
           invokeAny: graph.invokeAny,
           fetch: graph.fetch,
@@ -6094,7 +6301,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       createVaultService: (spaceId) => {
         graph.assertActive();
         const scopedKv = new import_sdk_core10.KVService({});
-        const context = graph.track(new import_sdk_core10.ServiceContext({
+        const context = graph.track(createServiceContext({
+          requestSink: graph.requestSink,
           invoke: graph.invoke,
           invokeAny: graph.invokeAny,
           fetch: graph.fetch,
@@ -6493,7 +6701,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       this._serviceGraph.fetch
     );
     this._serviceGraph.track(this.tc.serviceContext);
-    this._serviceContext = this._serviceGraph.track(new import_sdk_core10.ServiceContext({
+    this._serviceContext = this._serviceGraph.track(createServiceContext({
+      requestSink: this._serviceGraph.requestSink,
       invoke: this._serviceGraph.invoke,
       invokeAny: this._serviceGraph.invokeAny,
       fetch: this._serviceGraph.fetch,
@@ -6541,10 +6750,11 @@ var _TinyCloudNode = class _TinyCloudNode {
   createSpaceScopedKVService(spaceId) {
     const kvService = new import_sdk_core10.KVService({});
     if (this._serviceContext) {
-      const spaceScopedContext = this._serviceGraph.track(new import_sdk_core10.ServiceContext({
+      const spaceScopedContext = this._serviceGraph.track(createServiceContext({
+        requestSink: this._serviceGraph.requestSink,
         invoke: this._serviceContext.invoke,
         invokeAny: this._serviceContext.invokeAny,
-        fetch: this._serviceContext.fetch,
+        fetch: unrecordedFetchOf(this._serviceContext),
         hosts: this._serviceContext.hosts,
         telemetry: this.config.telemetry,
         retryPolicy: this.config.retryPolicy
@@ -6732,7 +6942,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         );
         graph.assertActive();
         if (!response.ok) {
-          const permissionHint = response.status === 401 || response.status === 403 ? (0, import_sdk_services2.parsePermissionHint)({
+          const permissionHint = response.status === 401 || response.status === 403 ? (0, import_sdk_services3.parsePermissionHint)({
             service: "tinycloud.encryption",
             path: networkId,
             actions: ["tinycloud.encryption/decrypt"]
@@ -7010,7 +7220,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       createKVService: (config) => {
         graph.assertActive();
         const service = new import_sdk_core10.KVService({ prefix: config.pathPrefix?.replace(/\/$/, "") });
-        const context = graph.track(new import_sdk_core10.ServiceContext({
+        const context = graph.track(createServiceContext({
+          requestSink: graph.requestSink,
           invoke: config.invoke,
           fetch: config.fetch ?? graph.fetch,
           hosts: config.hosts,
@@ -7331,10 +7542,11 @@ var _TinyCloudNode = class _TinyCloudNode {
       throw new Error("Not signed in. Call signIn() first.");
     }
     const sql = new import_sdk_core10.SQLService({});
-    const spaceScopedContext = this._serviceGraph.track(new import_sdk_core10.ServiceContext({
+    const spaceScopedContext = this._serviceGraph.track(createServiceContext({
+      requestSink: this._serviceGraph.requestSink,
       invoke: this._serviceContext.invoke,
       invokeAny: this._serviceContext.invokeAny,
-      fetch: this._serviceContext.fetch,
+      fetch: unrecordedFetchOf(this._serviceContext),
       hosts: this._serviceContext.hosts,
       telemetry: this.config.telemetry,
       retryPolicy: this.config.retryPolicy
@@ -7362,10 +7574,11 @@ var _TinyCloudNode = class _TinyCloudNode {
       throw new Error("Not signed in. Call signIn() first.");
     }
     const kv = new import_sdk_core10.KVService({});
-    const spaceScopedContext = this._serviceGraph.track(new import_sdk_core10.ServiceContext({
+    const spaceScopedContext = this._serviceGraph.track(createServiceContext({
+      requestSink: this._serviceGraph.requestSink,
       invoke: this._serviceContext.invoke,
       invokeAny: this._serviceContext.invokeAny,
-      fetch: this._serviceContext.fetch,
+      fetch: unrecordedFetchOf(this._serviceContext),
       hosts: this._serviceContext.hosts
     }));
     spaceScopedContext.setSession({ ...this._serviceContext.session, spaceId });
@@ -7506,6 +7719,8 @@ var _TinyCloudNode = class _TinyCloudNode {
         getManifest: () => this.manifest,
         hasPermissions: (permissions) => this.hasRuntimePermissions(permissions),
         grantPermissions: (additional) => this.grantRuntimePermissions(additional),
+        grantGetPermissions: (additional) => this.grantRuntimePermissions(additional, { expiry: SECRET_GET_GRANT_EXPIRY_MS }),
+        uncoveredEntries: (permissions) => permissions.filter((entry) => !this.hasRuntimePermissions([entry])),
         canEscalate: () => this.signer !== void 0 && this.tc !== void 0,
         getEncryptionNetworkId: () => this.getEncryptionNetworkIdForSpace(resolvedSpace),
         resolveSpace: (space) => space.startsWith("tinycloud:") ? space : this.ownedSpaceId(space),
@@ -7528,7 +7743,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     );
     if (result.status !== "ok") {
       if (result.status === "permission_required") {
-        const hint = (0, import_sdk_services2.parsePermissionHint)(result.hint);
+        const hint = (0, import_sdk_services3.parsePermissionHint)(result.hint);
         if (hint === void 0) return { status: "read_failed" };
         return {
           status: "permission_required",
@@ -7853,6 +8068,13 @@ var _TinyCloudNode = class _TinyCloudNode {
       }
     }
     const expanded = this.expandPermissionEntries(permissions);
+    const requestsDecrypt = includesDecrypt(expanded);
+    const requestedExpiryMs = requestsDecrypt && options?.expiry === void 0 ? DECRYPT_GRANT_MAX_EXPIRY_MS : resolveExpiryMs(options?.expiry);
+    if (requestsDecrypt && requestedExpiryMs > DECRYPT_GRANT_MAX_EXPIRY_MS) {
+      throw Object.assign(new Error("decrypt grants last at most one hour"), {
+        code: "DECRYPT_EXPIRY_TOO_LONG"
+      });
+    }
     if (this.sessionCoversPermissionEntries(session, expanded)) {
       return [];
     }
@@ -7883,7 +8105,6 @@ var _TinyCloudNode = class _TinyCloudNode {
       bySpace.set(session.spaceId, []);
     }
     const now = /* @__PURE__ */ new Date();
-    const requestedExpiryMs = resolveExpiryMs(options?.expiry);
     let expiresAt = new Date(now.getTime() + requestedExpiryMs);
     if (sessionExpiry !== void 0 && sessionExpiry < expiresAt) {
       expiresAt = sessionExpiry;
@@ -8151,7 +8372,8 @@ var _TinyCloudNode = class _TinyCloudNode {
     }
     if (this._serviceContext) {
       const publicKV = new import_sdk_core10.KVService({ prefix: "" });
-      const publicContext = this._serviceGraph.track(new import_sdk_core10.ServiceContext({
+      const publicContext = this._serviceGraph.track(createServiceContext({
+        requestSink: this._serviceGraph.requestSink,
         invoke: this._serviceGraph.invoke,
         fetch: this._serviceGraph.fetch,
         hosts: this._serviceContext.hosts,