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

package/dist/index.js

@@ -17430,7 +17430,7 @@ __export(authority_exports, {
 });
 import { SiweMessage as SiweMessage4 } from "siwe";
 import {
-  actionContains,
+  actionContains as actionContains2,
   KV as KV4,
   canonicalizeRecapCaveats as canonicalizeRecapCaveats3,
   isCapabilitySubset as isCapabilitySubset3,
@@ -17546,7 +17546,7 @@ function ucanAttCovers(att, space, prefix, ability, options) {
     const path = kvPathInResource(resource, space);
     if (path === void 0) continue;
     for (const [granted, caveats] of Object.entries(abilities)) {
-      if (!actionContains(granted, ability)) continue;
+      if (!actionContains2(granted, ability)) continue;
       if (!isCapabilitySubset3(
         [{ service: KV_SERVICE2, space, path: prefix, actions: [ability] }],
         [{ service: KV_SERVICE2, space, path, actions: [granted] }]
@@ -17936,6 +17936,173 @@ var PrivateKeySigner = class {
   }
 };
 
+// src/recordingServiceContext.ts
+import {
+  ServiceContext
+} from "@tinycloud/sdk-services";
+import {
+  buildRequestEvent,
+  invocationMetaOf,
+  requestBytesOf
+} from "@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 buildRequestEvent({
+    service: "sync",
+    op,
+    url: sample.url,
+    bytes: 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, ...base2 } = config;
+  return requestSink === void 0 ? new ServiceContext(base2) : new RecordingServiceContext(base2, requestSink);
+}
+var RecordingServiceContext = class extends 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, init2) => this.recordCall(raw, url, init2);
+  }
+  /** 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 init2 = await built;
+      attempts += 1;
+      if (first === void 0) {
+        first = init2;
+        firstMeta = meta;
+      }
+      return init2;
+    };
+    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, init2) {
+    const at = Date.now();
+    const clock = performance.now();
+    let response;
+    try {
+      response = await fetchFn(url, init2);
+      return response;
+    } finally {
+      this.observeAttempt({ url, init: init2, response, at, clock });
+    }
+  }
+  observeAttempt(sample) {
+    try {
+      const replication = replicationOp(sample.url, sample.meta ?? 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(invoke2, sink, pending) {
+  return (session, service, path, action, facts) => {
+    const headers = invoke2(session, service, path, action, facts);
+    const meta = { service, path, action, spaceId: session.spaceId };
+    pending.meta = meta;
+    sink.remember(headers, meta);
+    return headers;
+  };
+}
+function rememberInvokeAny(invokeAny2, sink, pending) {
+  return (session, entries, facts) => {
+    const headers = invokeAny2(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
 import {
   canonicalizeRecapCaveats,
@@ -18511,7 +18678,6 @@ import {
   DecryptTransportResponseError,
   SecretsService,
   createVaultCrypto,
-  ServiceContext as ServiceContext2,
   SilentNotificationHandler,
   DelegationManager,
   SpaceService,
@@ -18542,7 +18708,7 @@ import {
   KV as KV3,
   SQL as SQL2,
   DUCKDB as DUCKDB2,
-  ENCRYPTION as ENCRYPTION2,
+  ENCRYPTION as ENCRYPTION3,
   EXPIRY as EXPIRY3,
   canonicalHashHex,
   canonicalizeEncryptionJson,
@@ -18554,7 +18720,7 @@ import {
   createInMemoryRegistrySequenceStore as createInMemoryRegistrySequenceStore2,
   publishLocationRecord,
   principalDidEquals as principalDidEquals3,
-  parseNetworkId as parseNetworkId2,
+  parseNetworkId as parseNetworkId3,
   resolveSecretPath as resolveSecretPath2,
   registerPolicyV3,
   CREDENTIAL_INVITATION_REQUEST_DOMAIN,
@@ -18575,6 +18741,7 @@ import {
   parsePermissionHint,
   tinyCloudDebugLogger
 } from "@tinycloud/sdk-services";
+import { RequestLog, observeReplicaReads, readOnlyRequestLog } from "@tinycloud/sdk-services/telemetry/requestLog";
 
 // src/authorization/NodeUserAuthorization.ts
 init_authority_sign_in();
@@ -20425,8 +20592,7 @@ import {
   KVService,
   HooksService,
   SQLService,
-  DuckDbService,
-  ServiceContext
+  DuckDbService
 } from "@tinycloud/sdk-core";
 var DelegatedAccess = class {
   /**
@@ -20439,12 +20605,13 @@ var DelegatedAccess = class {
     this.session = session;
     this._delegation = delegation;
     this.host = host;
-    const context = new ServiceContext({
+    const context = createServiceContext({
       invoke: invoke2,
       invokeAny: invokeAny2,
       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(/\/$/, "");
@@ -20608,7 +20775,11 @@ function createWasmKeyProvider(sessionManager) {
 
 // src/delegateToHelpers.ts
 import {
+  actionContains,
+  ENCRYPTION as ENCRYPTION2,
   parseExpiry,
+  isNetworkId,
+  parseNetworkId as parseNetworkId2,
   SiweMessage as SiweMessage2,
   EXPIRY as EXPIRY2
 } from "@tinycloud/sdk-core";
@@ -20643,6 +20814,16 @@ function legacyParamsToPermissionEntries(actions, path, spaceIdOverride) {
   return entries;
 }
 var DEFAULT_DELEGATION_EXPIRY_MS = EXPIRY2.SESSION_MS;
+var SHARE_NETWORK_NAME_RE = /^share-[a-z0-9][a-z0-9-]{15,35}$/;
+function grantsCappedDecrypt(path, actions) {
+  if (!actions.some((action) => actionContains(action, ENCRYPTION2.DECRYPT))) {
+    return false;
+  }
+  return !(isNetworkId(path) && SHARE_NETWORK_NAME_RE.test(parseNetworkId2(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;
@@ -20816,6 +20997,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(
         ErrorCodes.PERMISSION_DENIED,
@@ -20823,16 +21013,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(
-        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(
+      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();
@@ -20867,8 +21061,8 @@ var NodeSecretsService = class {
 // src/TinyCloudNode.ts
 var DEFAULT_HOST = "https://node.tinycloud.xyz";
 var DEFAULT_ENCRYPTION_NETWORK_NAME = "default";
-var NETWORK_CREATE_ACTION2 = ENCRYPTION2.NETWORK_CREATE;
-var DECRYPT_ACTION2 = ENCRYPTION2.DECRYPT;
+var NETWORK_CREATE_ACTION2 = ENCRYPTION3.NETWORK_CREATE;
+var DECRYPT_ACTION2 = ENCRYPTION3.DECRYPT;
 var BOOTSTRAP_COMPLETION_MARKER_KEY = "system/bootstrap/complete";
 var BOOTSTRAP_COMPLETION_MARKER_VERSION = 1;
 var ACCEPTED_MARKER_VERSIONS = [BOOTSTRAP_COMPLETION_MARKER_VERSION];
@@ -21044,11 +21238,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;
@@ -21214,7 +21409,7 @@ function ownerDelegationPermissions(params) {
     }
     if (permission.service === ENCRYPTION_PERMISSION_SERVICE2) {
       try {
-        parseNetworkId2(permission.path);
+        parseNetworkId3(permission.path);
       } catch {
         throw new Error("Owner delegation encryption permission requires a canonical network URN");
       }
@@ -21237,6 +21432,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 = "";
@@ -21619,6 +21816,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     this.sessionManager = sessionKey.manager;
     this.sessionKeyId = sessionKey.keyId;
     this.sessionKeyJwk = sessionKey.jwk;
+    this._requestLog = config.requestLog === true ? new RequestLog() : void 0;
     this._serviceGraph = this.createServiceGraphLifetime();
     this._capabilityRegistry = new CapabilityKeyRegistry();
     this._keyProvider = new WasmKeyProvider({
@@ -21790,7 +21988,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       createKVService: (config) => {
         const prefix = config.pathPrefix?.replace(/\/$/, "");
         const kvService = new KVService2({ prefix });
-        const kvContext = receiveOnlyGraph.track(new ServiceContext2({
+        const kvContext = receiveOnlyGraph.track(createServiceContext({
+          requestSink: receiveOnlyGraph.requestSink,
           invoke: config.invoke,
           fetch: config.fetch ?? globalThis.fetch.bind(globalThis),
           hosts: config.hosts,
@@ -21853,6 +22052,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 : readOnlyRequestLog(this._requestLog);
+  }
   createServiceGraphLifetime() {
     return new ServiceGraphLifetime(
       this.invokeWithRuntimePermissions,
@@ -21863,7 +22066,9 @@ var _TinyCloudNode = class _TinyCloudNode {
       (url, init2) => globalThis.fetch(url, init2),
       (context) => {
         this.storageFull.observe(context);
-      }
+        if (this._requestLog) observeReplicaReads(context, this._requestLog);
+      },
+      this._requestLog
     );
   }
   syncResolvedHostFromAuth() {
@@ -22186,6 +22391,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;
@@ -22277,7 +22483,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;
@@ -22856,10 +23065,11 @@ var _TinyCloudNode = class _TinyCloudNode {
     const contexts = [context];
     const accountSpaceId = this.ownedSpaceId(ACCOUNT_REGISTRY_SPACE2);
     const createScopedContext = (spaceId) => {
-      const scoped = this._serviceGraph.track(new ServiceContext2({
+      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
@@ -22923,10 +23133,11 @@ var _TinyCloudNode = class _TinyCloudNode {
     const promise = this.enqueueAccountRegistryOperation(session, async () => {
       const sharedContext = this._serviceContext;
       if (!sharedContext) return;
-      const context = this._serviceGraph.track(new ServiceContext2({
+      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
@@ -23131,7 +23342,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       return;
     }
     for (const networkId of this.requestedEncryptionNetworkIds()) {
-      const parsed = parseNetworkId2(networkId);
+      const parsed = parseNetworkId3(networkId);
       if (!didPrincipalMatches2(parsed.ownerDid, this.did)) {
         continue;
       }
@@ -23660,6 +23871,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;
@@ -23779,7 +23991,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       const coreContext = graph.track(core.serviceContext);
       coreContext.setSession(input.serviceSession);
     }
-    const serviceContext = graph.track(new ServiceContext2({
+    const serviceContext = graph.track(createServiceContext({
+      requestSink: graph.requestSink,
       invoke: graph.invoke,
       invokeAny: graph.invokeAny,
       fetch: graph.fetch,
@@ -23867,7 +24080,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       },
       createKVService: (config) => {
         const service = new KVService2({ prefix: config.pathPrefix?.replace(/\/$/, "") });
-        const context = graph.track(new ServiceContext2({
+        const context = graph.track(createServiceContext({
+          requestSink: graph.requestSink,
           invoke: config.invoke,
           fetch: config.fetch ?? globalThis.fetch.bind(globalThis),
           hosts: config.hosts,
@@ -23907,7 +24121,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       createKVService: (spaceId) => {
         graph.assertActive();
         const scopedKv = new KVService2({});
-        const context = graph.track(new ServiceContext2({
+        const context = graph.track(createServiceContext({
+          requestSink: graph.requestSink,
           invoke: graph.invoke,
           invokeAny: graph.invokeAny,
           fetch: graph.fetch,
@@ -23923,7 +24138,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       createVaultService: (spaceId) => {
         graph.assertActive();
         const scopedKv = new KVService2({});
-        const context = graph.track(new ServiceContext2({
+        const context = graph.track(createServiceContext({
+          requestSink: graph.requestSink,
           invoke: graph.invoke,
           invokeAny: graph.invokeAny,
           fetch: graph.fetch,
@@ -24322,7 +24538,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       this._serviceGraph.fetch
     );
     this._serviceGraph.track(this.tc.serviceContext);
-    this._serviceContext = this._serviceGraph.track(new ServiceContext2({
+    this._serviceContext = this._serviceGraph.track(createServiceContext({
+      requestSink: this._serviceGraph.requestSink,
       invoke: this._serviceGraph.invoke,
       invokeAny: this._serviceGraph.invokeAny,
       fetch: this._serviceGraph.fetch,
@@ -24370,10 +24587,11 @@ var _TinyCloudNode = class _TinyCloudNode {
   createSpaceScopedKVService(spaceId) {
     const kvService = new KVService2({});
     if (this._serviceContext) {
-      const spaceScopedContext = this._serviceGraph.track(new ServiceContext2({
+      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
@@ -24839,7 +25057,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       createKVService: (config) => {
         graph.assertActive();
         const service = new KVService2({ prefix: config.pathPrefix?.replace(/\/$/, "") });
-        const context = graph.track(new ServiceContext2({
+        const context = graph.track(createServiceContext({
+          requestSink: graph.requestSink,
           invoke: config.invoke,
           fetch: config.fetch ?? graph.fetch,
           hosts: config.hosts,
@@ -24942,7 +25161,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     if (!session) throw new Error("Owner session is required");
     const ownerDid = pkhDid2(session.address, session.chainId);
     for (const permission of permissions) {
-      if (permission.service === ENCRYPTION_PERMISSION_SERVICE2 && !principalDidEquals3(parseNetworkId2(permission.path).ownerDid, ownerDid)) {
+      if (permission.service === ENCRYPTION_PERMISSION_SERVICE2 && !principalDidEquals3(parseNetworkId3(permission.path).ownerDid, ownerDid)) {
         throw new Error("Owner delegation cannot grant a foreign encryption network");
       }
     }
@@ -25160,10 +25379,11 @@ var _TinyCloudNode = class _TinyCloudNode {
       throw new Error("Not signed in. Call signIn() first.");
     }
     const sql = new SQLService2({});
-    const spaceScopedContext = this._serviceGraph.track(new ServiceContext2({
+    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
@@ -25191,10 +25411,11 @@ var _TinyCloudNode = class _TinyCloudNode {
       throw new Error("Not signed in. Call signIn() first.");
     }
     const kv = new KVService2({});
-    const spaceScopedContext = this._serviceGraph.track(new ServiceContext2({
+    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 });
@@ -25302,7 +25523,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         return existing;
       }
     }
-    const parsed = parseNetworkId2(networkId);
+    const parsed = parseNetworkId3(networkId);
     if (!didPrincipalMatches2(parsed.ownerDid, this.did)) {
       throw new Error(
         `Cannot create encryption network ${networkId}: owner ${parsed.ownerDid} does not match signed-in DID ${this.did}`
@@ -25335,6 +25556,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),
@@ -25682,6 +25905,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 [];
     }
@@ -25712,7 +25942,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;
@@ -25980,7 +26209,8 @@ var _TinyCloudNode = class _TinyCloudNode {
     }
     if (this._serviceContext) {
       const publicKV = new KVService2({ prefix: "" });
-      const publicContext = this._serviceGraph.track(new ServiceContext2({
+      const publicContext = this._serviceGraph.track(createServiceContext({
+        requestSink: this._serviceGraph.requestSink,
         invoke: this._serviceGraph.invoke,
         fetch: this._serviceGraph.fetch,
         hosts: this._serviceContext.hosts,
@@ -27762,9 +27992,9 @@ import {
 import {
   EncryptionService as EncryptionService2,
   DecryptTransportResponseError as DecryptTransportResponseError2,
-  parseNetworkId as parseNetworkId3,
+  parseNetworkId as parseNetworkId4,
   buildNetworkId,
-  isNetworkId,
+  isNetworkId as isNetworkId2,
   networkDiscoveryKey,
   NetworkIdError,
   ENCRYPTION_NETWORK_URN_PREFIX,
@@ -27829,7 +28059,7 @@ import {
   UnsupportedFeatureError as UnsupportedFeatureError2,
   checkNodeInfo as checkNodeInfo3
 } from "@tinycloud/sdk-core";
-import { ServiceContext as ServiceContext4 } from "@tinycloud/sdk-core";
+import { ServiceContext as ServiceContext5 } from "@tinycloud/sdk-core";
 
 // src/replication/sqlite.ts
 init_authority();
@@ -27838,7 +28068,7 @@ import { createHash as createHash2, randomBytes as randomBytes2 } from "crypto";
 import { lstatSync, readFileSync as readFileSync2, statSync } from "fs";
 import { chmod, lstat, mkdir, open as openFile, readFile, readdir, realpath, rename, rm, rmdir, stat } from "fs/promises";
 import { basename, dirname as dirname2, join as join2, parse as parse2, resolve, sep } from "path";
-import { KVService as KVService3, ServiceContext as ServiceContext3, principalDid as principalDid2 } from "@tinycloud/sdk-core";
+import { KVService as KVService3, ServiceContext as ServiceContext4, principalDid as principalDid2 } from "@tinycloud/sdk-core";
 import {
   canonicalReplicationIdentity,
   replicationIdentityKey,
@@ -28999,7 +29229,7 @@ transports_fn = async function() {
     const device = __privateGet(this, _device);
     const fetch2 = spec.fetch ?? globalThis.fetch.bind(globalThis);
     return (grant) => {
-      const context = new ServiceContext3({
+      const context = new ServiceContext4({
         invoke: wasm.invoke,
         invokeAny: wasm.invokeAny,
         fetch: fetch2,
@@ -30406,7 +30636,7 @@ export {
   STORAGE_MANAGE_URL,
   STORAGE_WRITE_TOO_LARGE_MESSAGE2 as STORAGE_WRITE_TOO_LARGE_MESSAGE,
   SecretsService2 as SecretsService,
-  ServiceContext4 as ServiceContext,
+  ServiceContext5 as ServiceContext,
   SessionExpiredError2 as SessionExpiredError,
   SharingService2 as SharingService,
   SilentNotificationHandler2 as SilentNotificationHandler,
@@ -30483,7 +30713,7 @@ export {
   installTinyCloudDebugGlobals,
   isCapabilitySubset4 as isCapabilitySubset,
   isEvmAddress,
-  isNetworkId,
+  isNetworkId2 as isNetworkId,
   isStorageFullError2 as isStorageFullError,
   loadManifest,
   logoutPrincipalDigest,
@@ -30493,7 +30723,7 @@ export {
   openWrappedKey,
   parseCanonicalNetworkId,
   parseExpiry2 as parseExpiry,
-  parseNetworkId3 as parseNetworkId,
+  parseNetworkId4 as parseNetworkId,
   parsePkhDid,
   parseSecretCatalogKey,
   parseSpaceUri3 as parseSpaceUri,