@tinycloud/node-sdk 3.2.0-beta.2 → 3.2.0-beta.4

package/dist/index.js

@@ -4,6 +4,9 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
   get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
 }) : x)(function(x) {
@@ -37,6 +40,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
 
 // ../../node_modules/bn.js/lib/bn.js
 var require_bn = __commonJS({
@@ -14355,8 +14363,8 @@ function searchPath(object, path) {
   }
   return currentChild;
 }
-function uuidV4(randomBytes2) {
-  const bytes = arrayify(randomBytes2);
+function uuidV4(randomBytes3) {
+  const bytes = arrayify(randomBytes3);
   bytes[6] = bytes[6] & 15 | 64;
   bytes[8] = bytes[8] & 63 | 128;
   const value = hexlify(bytes);
@@ -17027,6 +17035,477 @@ var require_utils2 = __commonJS({
   }
 });
 
+// src/replication/config.ts
+import { kvPrefixCovers } from "@tinycloud/sdk-services";
+function assertValidReplicationConfig(replication) {
+  if (replication === void 0 || replication.enabled !== true) return;
+  if (replication.storage === void 0 || replication.storage === null) {
+    throw new TypeError("replication.enabled requires replication.storage");
+  }
+  if (!Array.isArray(replication.prefixes) || replication.prefixes.length === 0) {
+    throw new TypeError("replication.prefixes must be a non-empty array");
+  }
+  for (const prefix of replication.prefixes) {
+    if (typeof prefix !== "string" || prefix === "") {
+      throw new TypeError("replication.prefixes must not contain an empty prefix");
+    }
+  }
+  for (const [index, prefix] of replication.prefixes.entries()) {
+    for (const other of replication.prefixes.slice(index + 1)) {
+      if (kvPrefixCovers(prefix, other) || kvPrefixCovers(other, prefix)) {
+        throw new TypeError(
+          `replication.prefixes must not overlap: ${JSON.stringify(prefix)} and ${JSON.stringify(other)}`
+        );
+      }
+    }
+    if (prefix.split("/", 1)[0] === "vault" && replication.allowSecrets !== true) {
+      throw new TypeError(
+        `replication prefix ${JSON.stringify(prefix)} overlaps the vault namespace; pass allowSecrets to opt in`
+      );
+    }
+  }
+}
+var init_config = __esm({
+  "src/replication/config.ts"() {
+    "use strict";
+  }
+});
+
+// src/replication/authority-sign-in.ts
+import {
+  grantPathsForSelector,
+  KV,
+  isCapabilitySubset
+} from "@tinycloud/sdk-core";
+import { requiresSecretsOptIn } from "@tinycloud/sdk-services";
+function hasUnrestrictedGetCoverage(entries, spaceId, prefix) {
+  const requiredPaths = grantPathsForSelector(prefix);
+  return isCapabilitySubset(
+    requiredPaths.map((path) => ({ service: KV_SERVICE, space: spaceId, path, actions: [KV_GET] })),
+    [...entries]
+  ).subset;
+}
+function augmentSignInEntriesWithReplication(input) {
+  const out = [];
+  const replication = input.replication;
+  if (replication === void 0) return out;
+  for (const prefix of replication.prefixes) {
+    if (requiresSecretsOptIn(input.primarySpaceId, prefix) && replication.allowSecrets !== true) {
+      continue;
+    }
+    if (!hasUnrestrictedGetCoverage(input.entries, input.primarySpaceId, prefix)) {
+      continue;
+    }
+    for (const path of grantPathsForSelector(prefix)) {
+      out.push({
+        service: KV_SERVICE,
+        space: input.primarySpaceId,
+        path,
+        actions: [KV_GET, KV_SYNC]
+      });
+    }
+  }
+  return out;
+}
+var KV_GET, KV_SYNC, KV_SERVICE;
+var init_authority_sign_in = __esm({
+  "src/replication/authority-sign-in.ts"() {
+    "use strict";
+    KV_GET = KV.GET;
+    KV_SYNC = KV.SYNC;
+    KV_SERVICE = "tinycloud.kv";
+  }
+});
+
+// src/replication/runtime.ts
+var runtime_exports = {};
+__export(runtime_exports, {
+  ReplicationRuntime: () => ReplicationRuntime
+});
+import { pkhDid as pkhDid3 } from "@tinycloud/sdk-core";
+function resolvedOptions(options) {
+  return {
+    ...options,
+    syncIntervalMs: options.syncIntervalMs ?? 6e4,
+    maxStalenessMs: options.maxStalenessMs ?? 12e4,
+    staleSyncTimeoutMs: options.staleSyncTimeoutMs ?? 5e3,
+    allowSecrets: options.allowSecrets === true,
+    verify: options.verify === true
+  };
+}
+var scheduler, ReplicationRuntime;
+var init_runtime = __esm({
+  "src/replication/runtime.ts"() {
+    "use strict";
+    scheduler = {
+      now: () => Date.now(),
+      setTimeout(fn, ms) {
+        const timer = setTimeout(fn, ms);
+        timer.unref?.();
+        return () => clearTimeout(timer);
+      }
+    };
+    ReplicationRuntime = class {
+      constructor(options, clock = scheduler) {
+        this.options = options;
+        this.clock = clock;
+        this.pending = /* @__PURE__ */ new Map();
+        this.attached = /* @__PURE__ */ new Map();
+        this.previous = Promise.resolve();
+        this.binding = Promise.resolve();
+        this.generation = 0;
+        this.bindingActive = false;
+        this.pendingPurgeSet = false;
+        this.closed = false;
+        this.control = {
+          status: async () => {
+            await this.binding;
+            return this.current ? this.current.status() : [];
+          },
+          sync: async (input) => {
+            await this.binding;
+            if (this.purgedGeneration === this.generation) return;
+            if (this.current) await this.current.sync(input);
+          },
+          purge: (input) => {
+            if (this.bindingActive) {
+              this.pendingPurge = input;
+              this.pendingPurgeSet = true;
+              const existing = this.current ?? this.lastController;
+              if (existing) {
+                this.pendingPurgeResult = existing.purge(input);
+                this.purgedGeneration = this.generation;
+              }
+              return this.binding.then(() => this.pendingPurgeResult ?? { purged: [], failed: [] });
+            }
+            const controller = this.current ?? this.lastController;
+            if (!controller) return Promise.resolve({ purged: [], failed: [] });
+            this.purgedGeneration = this.generation;
+            return controller.purge(input);
+          },
+          clearPending: async () => {
+            await this.binding;
+            if (this.current) return this.current.clearPending();
+            const pending = this.lastPending;
+            if (!pending) return 0;
+            return pending.update((state) => {
+              const before = state.records.length;
+              state.records = state.records.filter(
+                (record) => record.state === "committed" || record.state === "in_flight" && this.clock.now() - Date.parse(record.at) <= 10 * 6e4
+              );
+              return before - state.records.length;
+            });
+          },
+          close: async () => {
+            this.closed = true;
+            this.unbind();
+            await this.binding.catch(() => void 0);
+            await this.previous;
+          }
+        };
+      }
+      loadServices() {
+        return this.services ?? (this.services = import("@tinycloud/sdk-services/kv/replication"));
+      }
+      detachAll() {
+        for (const kv of this.attached.keys()) kv.setReadThrough(null);
+        this.attached.clear();
+      }
+      bind(input) {
+        if (this.closed || !this.options.enabled) return Promise.resolve();
+        this.bindingActive = true;
+        const generation = ++this.generation;
+        this.purgedGeneration = void 0;
+        const { context, session } = input;
+        const emit = (event) => {
+          try {
+            this.options.onEvent?.(event);
+          } catch {
+          }
+          const { type, ...data } = event;
+          context.emit(type, data);
+        };
+        const previous = this.current;
+        this.current = void 0;
+        for (const kv of this.attached.keys()) kv.setReadThrough(null);
+        this.primarySpace = session.spaceId;
+        const close = previous ? previous.close().catch(() => void 0) : Promise.resolve();
+        this.previous = this.previous.then(() => close);
+        const previousClose = this.previous;
+        this.binding = this.loadServices().then((services) => {
+          if (generation !== this.generation || this.closed) return;
+          let identity;
+          try {
+            identity = services.canonicalReplicationIdentity({
+              host: context.hosts[0],
+              space: session.spaceId,
+              principal: input.principal ?? pkhDid3(input.address, input.chainId)
+            });
+          } catch {
+            for (const prefix of this.options.prefixes) {
+              emit({ type: "replication.state", at: new Date(this.clock.now()).toISOString(), space: session.spaceId, replica: prefix, state: "unavailable", code: "CONFIG_INVALID" });
+            }
+            return;
+          }
+          const key2 = services.replicationIdentityKey(identity);
+          let pending = this.pending.get(key2);
+          if (!pending) {
+            pending = this.options.storage.pendingWrites?.(identity) ?? services.createMemoryPendingStore(identity);
+            this.pending.set(key2, pending);
+          }
+          this.lastPending = pending;
+          const controller = services.createKVReplication({
+            options: resolvedOptions(this.options),
+            mode: this.options.mode ?? "background",
+            storage: this.options.storage,
+            identity,
+            session: { id: session.delegationCid, did: session.verificationMethod, space: session.spaceId },
+            authority: input.authority,
+            pending,
+            scheduler: this.clock,
+            emit,
+            fetch: context.fetch,
+            previous: previousClose
+          });
+          this.current = controller;
+          this.lastController = controller;
+          this.lastIdentity = identity;
+          for (const [kv, space] of this.attached) {
+            kv.setReadThrough(space === this.primarySpace ? controller : null);
+          }
+          for (const scoped of input.primaryKV) this.attach(scoped.space, scoped.kv);
+          if (this.pendingPurgeSet) {
+            this.pendingPurgeResult = controller.purge(this.pendingPurge);
+            this.purgedGeneration = generation;
+            this.pendingPurge = void 0;
+            this.pendingPurgeSet = false;
+          }
+        }).finally(() => {
+          if (generation === this.generation) this.bindingActive = false;
+        });
+        for (const kv of this.attached.keys()) kv.setReadThroughReady?.(this.binding);
+        return this.binding;
+      }
+      attach(space, kv) {
+        this.attached.set(kv, space);
+        kv.setReadThrough(space === this.primarySpace ? this.current ?? null : null);
+        return this.binding.then(() => {
+          kv.setReadThrough(space === this.primarySpace ? this.current ?? null : null);
+        });
+      }
+      unbind() {
+        this.generation++;
+        this.bindingActive = false;
+        this.pendingPurgeSet = false;
+        const controller = this.current;
+        this.current = void 0;
+        this.primarySpace = void 0;
+        this.detachAll();
+        const binding = this.binding;
+        const close = binding.then(() => controller?.close()).catch(() => void 0);
+        this.previous = this.previous.then(() => close);
+        return this.previous;
+      }
+      get boundIdentity() {
+        return this.lastIdentity;
+      }
+    };
+  }
+});
+
+// src/replication/authority.ts
+var authority_exports = {};
+__export(authority_exports, {
+  AUTHORITY_EXPIRY_MARGIN_MS: () => AUTHORITY_EXPIRY_MARGIN_MS,
+  assertValidReplicationConfig: () => assertValidReplicationConfig,
+  augmentSignInEntriesWithReplication: () => augmentSignInEntriesWithReplication,
+  createReplicationAuthority: () => createReplicationAuthority,
+  hasUnrestrictedGetCoverage: () => hasUnrestrictedGetCoverage,
+  replicationScopeFromSignedSession: () => replicationScopeFromSignedSession,
+  ucanAttCovers: () => ucanAttCovers,
+  ucanAttUnconstrainedFor: () => ucanAttUnconstrainedFor
+});
+import {
+  grantPathsForSelector as grantPathsForSelector2,
+  actionContains,
+  KV as KV4,
+  canonicalizeRecapCaveats as canonicalizeRecapCaveats3,
+  isCapabilitySubset as isCapabilitySubset3,
+  parseSpaceUri as parseSpaceUri2
+} from "@tinycloud/sdk-core";
+import { parseUcanGrant as replicaParseUcanGrant } from "@tinycloud/replica";
+function replicationEntries(spaceId, prefix) {
+  return grantPathsForSelector2(prefix).map((path) => ({
+    service: KV_SERVICE2,
+    space: spaceId,
+    path,
+    actions: [KV_GET2, KV_SYNC2]
+  }));
+}
+function caveatBranchesUnconstrained(value) {
+  if (value === void 0 || value === null) return true;
+  if (typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 0) {
+    return true;
+  }
+  if (!Array.isArray(value)) return false;
+  try {
+    return canonicalizeRecapCaveats3(value) === canonicalizeRecapCaveats3(void 0);
+  } catch {
+    return false;
+  }
+}
+function kvPathInResource(resource, space) {
+  for (const base2 of [`${space}/kv/`, `tinycloud://${space}/kv/`]) {
+    if (resource.startsWith(base2)) return resource.slice(base2.length);
+  }
+  return void 0;
+}
+function ucanAttCovers(att, space, prefix, ability, options) {
+  const requiredPaths = prefix.endsWith("/") ? [prefix] : [prefix, `${prefix}/`];
+  return requiredPaths.every((requestedPath) => {
+    for (const [resource, abilities] of Object.entries(att)) {
+      const path = kvPathInResource(resource, space);
+      if (path === void 0) continue;
+      for (const [granted, caveats] of Object.entries(abilities)) {
+        if (!actionContains(granted, ability)) continue;
+        if (!isCapabilitySubset3(
+          [{ service: KV_SERVICE2, space, path: requestedPath, actions: [ability] }],
+          [{ service: KV_SERVICE2, space, path, actions: [granted] }]
+        ).subset) continue;
+        if (options?.ignoreCaveats === true || caveatBranchesUnconstrained(caveats)) return true;
+      }
+    }
+    return false;
+  });
+}
+function ucanAttUnconstrainedFor(att, space, prefix) {
+  return ucanAttCovers(att, space, prefix, KV_GET2) && ucanAttCovers(att, space, prefix, KV_SYNC2);
+}
+function replicationScopeFromSignedSession(input) {
+  let grant;
+  try {
+    grant = parseUcanGrant(input.delegationHeader.Authorization);
+  } catch {
+    return void 0;
+  }
+  const bareDid = (value) => value.split("#", 1)[0];
+  if (grant.cid !== input.delegationCid || bareDid(grant.audience) !== bareDid(input.verificationMethod)) return void 0;
+  for (const resource of Object.keys(grant.att)) {
+    const space = resource.match(/^(?:tinycloud:\/\/)?(.+?)\/kv\//)?.[1];
+    if (space !== input.persistedSpace) continue;
+    const owner = parseSpaceUri2(space);
+    if (owner?.owner && owner.address && owner.chainId) return { space, principal: owner.owner };
+  }
+  return void 0;
+}
+function createReplicationAuthority(host) {
+  const planOrRefusal = (entries) => {
+    const plan = host.planDelegation(entries);
+    if ("refused" in plan) return plan;
+    return { path: plan.path, parentCid: plan.parentCid, expiresAt: plan.expiresAt };
+  };
+  const sessionAudience = (value) => value.split("#", 1)[0];
+  const signedSessionGrant = (session) => {
+    const grant = parseUcanGrant(session.delegationHeader.Authorization);
+    if (grant.cid !== session.delegationCid || sessionAudience(grant.audience) !== sessionAudience(session.verificationMethod)) return void 0;
+    return grant;
+  };
+  const authority = {
+    get sessionOnly() {
+      const session = host.replicationSession();
+      return session !== void 0 && session.siwe === void 0;
+    },
+    sessionGrant(prefix) {
+      const session = host.replicationSession();
+      if (session === void 0) return { refused: "SESSION_EXPIRING" };
+      const siweExpiry = session.siwe ? host.siweExpiration(session.siwe)?.getTime() : void 0;
+      if (siweExpiry !== void 0 && siweExpiry <= Date.now() + AUTHORITY_EXPIRY_MARGIN_MS) {
+        return { refused: "SESSION_EXPIRING" };
+      }
+      let grant;
+      try {
+        const verified = signedSessionGrant(session);
+        if (!verified) return { refused: "NOT_COVERED" };
+        grant = verified;
+      } catch {
+        return { refused: "NOT_COVERED" };
+      }
+      const tokenExpiry = grant.expiresAt === null ? void 0 : grant.expiresAt * 1e3;
+      if (tokenExpiry === void 0 || tokenExpiry <= Date.now() + AUTHORITY_EXPIRY_MARGIN_MS) {
+        return { refused: "SESSION_EXPIRING" };
+      }
+      const covered = ucanAttCovers(grant.att, session.spaceId, prefix, KV_GET2, { ignoreCaveats: true }) && ucanAttCovers(grant.att, session.spaceId, prefix, KV_SYNC2, { ignoreCaveats: true });
+      if (!covered) return { refused: "NOT_COVERED" };
+      if (!ucanAttUnconstrainedFor(grant.att, session.spaceId, prefix)) {
+        return { refused: "CAVEATED_AUTHORITY" };
+      }
+      return {
+        ucan: grant.jwt,
+        device: { did: session.verificationMethod, jwk: session.jwk }
+      };
+    },
+    plan(prefix) {
+      const session = host.replicationSession();
+      if (session === void 0) return { refused: "SESSION_EXPIRING" };
+      const sessionGrant = this.sessionGrant(prefix);
+      if (!("refused" in sessionGrant)) {
+        const signed2 = signedSessionGrant(session);
+        if (!signed2 || signed2.expiresAt === null) return { refused: "NOT_COVERED" };
+        return {
+          path: "session",
+          parentCid: session.delegationCid,
+          expiresAt: signed2.expiresAt * 1e3
+        };
+      }
+      if (authority.sessionOnly) return sessionGrant;
+      return planOrRefusal(replicationEntries(session.spaceId, prefix));
+    },
+    async mint(deviceDid, prefix, signal) {
+      if (authority.sessionOnly) throw new Error("compact delegate sessions cannot mint device grants");
+      const session = host.replicationSession();
+      if (session === void 0) throw new Error("replication mint without a session");
+      const entries = replicationEntries(session.spaceId, prefix);
+      const plan = planOrRefusal(entries);
+      if ("refused" in plan) {
+        throw Object.assign(
+          new Error(`replication authority refused the mint: ${plan.refused}`),
+          { refused: plan.refused }
+        );
+      }
+      signal.throwIfAborted();
+      const minted = await new Promise((resolve, reject2) => {
+        const onAbort = () => reject2(signal.reason ?? new Error("replication mint aborted"));
+        signal.addEventListener("abort", onAbort, { once: true });
+        host.mintDelegation(deviceDid, entries).then(
+          (result) => {
+            signal.removeEventListener("abort", onAbort);
+            resolve(result);
+          },
+          (error) => {
+            signal.removeEventListener("abort", onAbort);
+            reject2(error instanceof Error ? error : new Error(String(error)));
+          }
+        );
+      });
+      return { ucan: minted.ucan, parentCid: plan.parentCid, expiresAt: minted.expiresAt };
+    }
+  };
+  return authority;
+}
+var parseUcanGrant, KV_GET2, KV_SYNC2, KV_SERVICE2, AUTHORITY_EXPIRY_MARGIN_MS;
+var init_authority = __esm({
+  "src/replication/authority.ts"() {
+    "use strict";
+    init_config();
+    init_authority_sign_in();
+    parseUcanGrant = replicaParseUcanGrant;
+    KV_GET2 = KV4.GET;
+    KV_SYNC2 = KV4.SYNC;
+    KV_SERVICE2 = "tinycloud.kv";
+    AUTHORITY_EXPIRY_MARGIN_MS = 6e4;
+  }
+});
+
 // src/NodeWasmBindings.ts
 import {
   invoke,
@@ -17688,6 +18167,21 @@ function deserializeDelegation(data) {
   };
 }
 
+// src/TinyCloudNode.ts
+init_config();
+
+// src/replication/module-registry.ts
+var nodeLoaders;
+function registerReplicationLoaders(loaders) {
+  nodeLoaders = loaders;
+}
+function getNodeReplicationLoaders() {
+  if (nodeLoaders === void 0) {
+    throw new Error("Replication requires registering replication controller loaders.");
+  }
+  return nodeLoaders;
+}
+
 // src/TinyCloudNode.ts
 import {
   TinyCloud,
@@ -17726,12 +18220,12 @@ import {
   canonicalizeRecapCaveats as canonicalizeRecapCaveats2,
   recapCaveatsEqual,
   expandPermissionEntries as expandPermissionEntriesCore,
-  isCapabilitySubset,
+  isCapabilitySubset as isCapabilitySubset2,
   isExplicitOnlyAction,
   parseRecapCapabilities,
   SERVICE_LONG_TO_SHORT,
   SERVICE_SHORT_TO_LONG,
-  KV as KV2,
+  KV as KV3,
   SQL as SQL2,
   DUCKDB as DUCKDB2,
   ENCRYPTION as ENCRYPTION2,
@@ -17741,6 +18235,7 @@ import {
   verifyDidKeyEd25519Signature,
   canonicalizeAddress as canonicalizeAddress2,
   pkhDid as pkhDid2,
+  principalDid,
   resolveTinyCloudHosts as resolveTinyCloudHosts2,
   publishLocationRecord,
   principalDidEquals as principalDidEquals3,
@@ -17760,6 +18255,7 @@ import {
 } from "@tinycloud/sdk-services";
 
 // src/authorization/NodeUserAuthorization.ts
+init_authority_sign_in();
 import { createHash } from "crypto";
 import { SiweMessage } from "siwe";
 import {
@@ -17787,7 +18283,7 @@ import {
   parseCanonicalRecapResource,
   ACCOUNT_REGISTRY_SPACE,
   ACCOUNT_MANIFEST_PERMISSIONS,
-  KV,
+  KV as KV2,
   SQL,
   DUCKDB,
   CAPABILITIES,
@@ -17941,7 +18437,7 @@ var NodeUserAuthorization = class {
     this.spacePrefix = config.spacePrefix ?? "default";
     this.defaultActions = config.defaultActions ?? {
       kv: {
-        "": [KV.PUT, KV.GET, KV.DEL, KV.LIST, KV.METADATA]
+        "": [KV2.PUT, KV2.GET, KV2.DEL, KV2.LIST, KV2.METADATA]
       },
       sql: {
         "": [SQL.READ, SQL.WRITE, SQL.SCHEMA, SQL.ADMIN, SQL.EXPORT]
@@ -17979,6 +18475,7 @@ var NodeUserAuthorization = class {
     this.nonce = config.nonce;
     this.siweConfig = config.siweConfig;
     this.includeAccountRegistryPermissions = config.includeAccountRegistryPermissions ?? true;
+    this.replication = config.replication?.enabled === true ? config.replication : void 0;
     this._manifest = config.manifest;
     this._capabilityRequest = config.capabilityRequest;
     this.sessionManager = config.sessionManager ?? this.wasm.createSessionManager();
@@ -18187,6 +18684,143 @@ var NodeUserAuthorization = class {
     }
     return makePkhSpaceId(address, chainId, space);
   }
+  /**
+   * The plain-session primary abilities: `defaultActions` (the shared table)
+   * unless the primary space IS the account space, where account-registry
+   * permissions merge into a private clone so the shared table is never
+   * mutated. Shared between `resolveSignInCapabilities` and
+   * `signInPermissionInputs` so sign-in and `replicationSignInEntries`
+   * can't disagree (§4.6).
+   */
+  primaryActionsForSignIn() {
+    const primaryActions = this.includeAccountRegistryPermissions && this.spacePrefix === ACCOUNT_REGISTRY_SPACE ? cloneAbilitiesMap(this.defaultActions) : this.defaultActions;
+    if (this.includeAccountRegistryPermissions && this.spacePrefix === ACCOUNT_REGISTRY_SPACE) {
+      const accountAbilities = resourceCapabilitiesToAbilitiesMap(
+        ACCOUNT_MANIFEST_PERMISSIONS
+      );
+      for (const [service, paths] of Object.entries(accountAbilities)) {
+        const existingPaths = primaryActions[service] ?? (primaryActions[service] = {});
+        for (const [path, actions] of Object.entries(paths)) {
+          const existingActions = existingPaths[path] ?? (existingPaths[path] = []);
+          for (const action of actions) {
+            if (!existingActions.includes(action)) existingActions.push(action);
+          }
+        }
+      }
+    }
+    return primaryActions;
+  }
+  /**
+   * The abilities a `spacePrefix: "secrets"` plain session actually requests
+   * for its primary space: the vault-secrets subtree only — the
+   * `defaultActions` root `get` is REPLACED, not merged (sign-in installs
+   * this map under the primary space id). Shared between
+   * `resolveSignInCapabilities` and `signInPermissionInputs` so the
+   * replication augmentation measures coverage against the effective
+   * pre-replication request, never the uninstalled `primaryActions` (§4.1).
+   */
+  secretsPrimaryAbilities() {
+    return {
+      kv: {
+        "vault/secrets/": [
+          KV2.GET,
+          KV2.PUT,
+          KV2.DEL,
+          KV2.LIST,
+          KV2.METADATA
+        ]
+      }
+    };
+  }
+  /**
+   * The effective sign-in request as `PermissionEntry`s plus the resolved
+   * primary space id — the inputs to the replication augmentation (§4.1).
+   * `resolveSignInCapabilities` merges the augmented entries into its
+   * abilities; `replicationSignInEntries()` returns them verbatim, so the
+   * entries the SIWE recap carries and the restore check sees are the same.
+   */
+  signInPermissionInputs(address, chainId) {
+    const request = this.getCapabilityRequest();
+    if (request === void 0) {
+      const primarySpaceId2 = makePkhSpaceId(address, chainId, this.spacePrefix);
+      const effectivePrimary = this.spacePrefix === "secrets" ? this.secretsPrimaryAbilities() : this.primaryActionsForSignIn();
+      const kvPaths = effectivePrimary["kv"] ?? {};
+      return {
+        primarySpaceId: primarySpaceId2,
+        entries: Object.entries(kvPaths).map(([path, actions]) => ({
+          service: "tinycloud.kv",
+          space: primarySpaceId2,
+          path,
+          actions: [...actions]
+        }))
+      };
+    }
+    const spaceResources = request.resources.filter(
+      (entry) => entry.service !== ENCRYPTION_PERMISSION_SERVICE
+    );
+    const primarySpaceName = spaceResources.find((entry) => entry.space !== "account")?.space ?? DEFAULT_MANIFEST_SPACE;
+    const primarySpaceId = this.resolveSpaceName(
+      primarySpaceName,
+      address,
+      chainId
+    );
+    return {
+      primarySpaceId,
+      entries: spaceResources.map((entry) => ({
+        service: entry.service,
+        space: this.resolveSpaceName(entry.space, address, chainId),
+        path: entry.path,
+        actions: [...entry.actions]
+      }))
+    };
+  }
+  /**
+   * Merge replication augmentation entries into a space's abilities map
+   * without mutating shared tables (`defaultActions` may back the base map):
+   * the primary entry in `spaceAbilities` is replaced with a copy whose `kv`
+   * paths gain `get`/`sync`. Returns the merged map for `abilities`.
+   */
+  mergeReplicationEntries(spaceAbilities, primarySpaceId, abilities, entries) {
+    var _a;
+    if (entries.length === 0) {
+      return abilities;
+    }
+    const base2 = spaceAbilities[primarySpaceId] ?? abilities;
+    const kv = {};
+    for (const [path, actions] of Object.entries(base2["kv"] ?? {})) {
+      kv[path] = [...actions];
+    }
+    for (const entry of entries) {
+      const list = kv[_a = entry.path] ?? (kv[_a] = []);
+      for (const action of entry.actions) {
+        if (!list.includes(action)) list.push(action);
+      }
+    }
+    const merged = { ...base2, kv };
+    spaceAbilities[primarySpaceId] = merged;
+    return merged;
+  }
+  /**
+   * The replication entries this authorization's sign-in request carries
+   * for the signed-in or restored address (TC-858 §4.1/§4.6): the output of
+   * the same augmentation `resolveSignInCapabilities` runs — one
+   * `{tinycloud.kv, primarySpace, prefix, [get, sync]}` per configured
+   * prefix that already has an unrestricted covering `get` and passes the
+   * secrets opt-in gate. Empty when replication is off or no address is
+   * known. Pure.
+   */
+  replicationSignInEntries() {
+    if (this.replication === void 0) return [];
+    const address = this._address ?? this._tinyCloudSession?.address;
+    const chainId = this._chainId ?? this._tinyCloudSession?.chainId;
+    if (address === void 0 || chainId === void 0) return [];
+    const { entries, primarySpaceId } = this.signInPermissionInputs(address, chainId);
+    return augmentSignInEntriesWithReplication({
+      entries,
+      primarySpaceId,
+      replication: this.replication
+    });
+  }
   defaultEncryptionNetworkId(address, chainId) {
     return `urn:tinycloud:encryption:${pkhDid(address, chainId)}:default`;
   }
@@ -18196,39 +18830,25 @@ var NodeUserAuthorization = class {
       const defaultNetworkId = this.defaultEncryptionNetworkId(address, chainId);
       const primarySpaceId2 = makePkhSpaceId(address, chainId, this.spacePrefix);
       const secretsSpaceId = makePkhSpaceId(address, chainId, "secrets");
-      const primaryActions = this.includeAccountRegistryPermissions && this.spacePrefix === ACCOUNT_REGISTRY_SPACE ? cloneAbilitiesMap(this.defaultActions) : this.defaultActions;
+      const primaryActions = this.primaryActionsForSignIn();
       const spaceAbilities2 = {
         [primarySpaceId2]: primaryActions,
-        [secretsSpaceId]: {
-          kv: {
-            "vault/secrets/": [
-              KV.GET,
-              KV.PUT,
-              KV.DEL,
-              KV.LIST,
-              KV.METADATA
-            ]
-          }
-        }
+        [secretsSpaceId]: this.secretsPrimaryAbilities()
       };
       if (this.includeAccountRegistryPermissions && this.spacePrefix !== ACCOUNT_REGISTRY_SPACE) {
         spaceAbilities2[makePkhSpaceId(address, chainId, ACCOUNT_REGISTRY_SPACE)] = resourceCapabilitiesToAbilitiesMap(ACCOUNT_MANIFEST_PERMISSIONS);
-      } else if (this.includeAccountRegistryPermissions) {
-        const accountAbilities = resourceCapabilitiesToAbilitiesMap(
-          ACCOUNT_MANIFEST_PERMISSIONS
-        );
-        for (const [service, paths] of Object.entries(accountAbilities)) {
-          const existingPaths = primaryActions[service] ?? (primaryActions[service] = {});
-          for (const [path, actions] of Object.entries(paths)) {
-            const existingActions = existingPaths[path] ?? (existingPaths[path] = []);
-            for (const action of actions) {
-              if (!existingActions.includes(action)) existingActions.push(action);
-            }
-          }
-        }
       }
+      const mergedPrimary = this.mergeReplicationEntries(
+        spaceAbilities2,
+        primarySpaceId2,
+        primaryActions,
+        augmentSignInEntriesWithReplication({
+          ...this.signInPermissionInputs(address, chainId),
+          replication: this.replication
+        })
+      );
       return {
-        abilities: primaryActions,
+        abilities: mergedPrimary,
         spaceId: primarySpaceId2,
         spaceAbilities: spaceAbilities2,
         rawAbilities: {
@@ -18264,8 +18884,17 @@ var NodeUserAuthorization = class {
     for (const [space, abilities] of Object.entries(bySpace)) {
       spaceAbilities[this.resolveSpaceName(space, address, chainId)] = abilities;
     }
+    const mergedPrimaryAbilities = this.mergeReplicationEntries(
+      spaceAbilities,
+      primarySpaceId,
+      spaceAbilities[primarySpaceId] ?? resourceCapabilitiesToAbilitiesMap([]),
+      augmentSignInEntriesWithReplication({
+        ...this.signInPermissionInputs(address, chainId),
+        replication: this.replication
+      })
+    );
     return {
-      abilities: spaceAbilities[primarySpaceId] ?? resourceCapabilitiesToAbilitiesMap([]),
+      abilities: mergedPrimaryAbilities,
       spaceId: primarySpaceId,
       spaceAbilities,
       rawAbilities: Object.keys(rawAbilities).length > 0 ? rawAbilities : void 0
@@ -18323,14 +18952,14 @@ var NodeUserAuthorization = class {
    * Create the space on the TinyCloud server (host delegation).
    * This registers the user as the owner of the space.
    */
-  async hostSpace(targetSpaceId, purpose) {
+  async hostSpace(targetSpaceId, purpose, signal) {
     if (!this._tinyCloudSession || !this._address || !this._chainId) {
       throw new Error("Must be signed in to host space");
     }
     await this.ensureTinyCloudHosts();
     const host = this.primaryTinyCloudHost;
     const spaceId = targetSpaceId ?? this._tinyCloudSession.spaceId;
-    const peerId = await fetchPeerId(host, spaceId);
+    const peerId = await fetchPeerId(host, spaceId, signal);
     const siwe = this.wasm.generateHostSIWEMessage({
       address: this._address,
       chainId: this._chainId,
@@ -18339,9 +18968,28 @@ var NodeUserAuthorization = class {
       spaceId,
       peerId
     });
-    const signature2 = await this.signMessage(siwe, purpose);
+    if (signal?.aborted) throw signal.reason;
+    const signing = this.signMessage(siwe, purpose);
+    let signature2;
+    if (!signal) {
+      signature2 = await signing;
+    } else {
+      let rejectOnAbort;
+      const aborted = new Promise((_resolve, reject2) => {
+        rejectOnAbort = reject2;
+      });
+      const onAbort = () => rejectOnAbort(signal.reason);
+      signal.addEventListener("abort", onAbort, { once: true });
+      if (signal.aborted) onAbort();
+      try {
+        signature2 = await Promise.race([signing, aborted]);
+      } finally {
+        signal.removeEventListener("abort", onAbort);
+      }
+    }
+    if (signal?.aborted) throw signal.reason;
     const headers = this.wasm.siweToDelegationHeaders({ siwe, signature: signature2 });
-    return submitHostDelegation(host, headers);
+    return submitHostDelegation(host, headers, signal);
   }
   /**
    * Create a specific space on the server via host delegation.
@@ -18362,8 +19010,8 @@ var NodeUserAuthorization = class {
    * keeps its HTTP status (e.g. a typed 401/403) instead of collapsing to
    * `false`.
    */
-  async hostOwnedSpaceResult(spaceId, purpose) {
-    return this.hostSpace(spaceId, purpose);
+  async hostOwnedSpaceResult(spaceId, purpose, signal) {
+    return this.hostSpace(spaceId, purpose, signal);
   }
   /**
    * Ensure the user's space exists on the TinyCloud server.
@@ -19742,11 +20390,11 @@ function isSecretPayload(value) {
   return typeof value === "object" && value !== null && "value" in value && typeof value.value === "string" && "createdAt" in value && typeof value.createdAt === "string" && "updatedAt" in value && typeof value.updatedAt === "string";
 }
 var ROOT_DELEGATION_ACTIONS = [
-  KV2.PUT,
-  KV2.GET,
-  KV2.DEL,
-  KV2.LIST,
-  KV2.METADATA,
+  KV3.PUT,
+  KV3.GET,
+  KV3.DEL,
+  KV3.LIST,
+  KV3.METADATA,
   SQL2.READ,
   SQL2.WRITE,
   SQL2.ADMIN,
@@ -20197,6 +20845,8 @@ var _TinyCloudNode = class _TinyCloudNode {
     this.confirmedHostedSpaceIds = /* @__PURE__ */ new Set();
     /** Serializes account-registry writes for the active node instance. */
     this.accountRegistryTail = Promise.resolve();
+    /** Bounds best-effort registry work on the sign-in critical path. */
+    this.accountRegistryDeadlineMs = 4e3;
     /**
      * True when the last signIn() detected an interactive signer and skipped
      * client-side bootstrap. Apps can read this to know whether bootstrap was
@@ -20275,11 +20925,46 @@ var _TinyCloudNode = class _TinyCloudNode {
       });
       return this.wasmBindings.invokeAny(invocationSession, caveatPreservingEntries, facts);
     };
+    assertValidReplicationConfig(config.replication);
     this.explicitHost = config.host;
     this.config = {
       ...config,
       host: config.host ?? DEFAULT_HOST
     };
+    if (this.config.replication?.enabled) {
+      const runtime = getNodeReplicationLoaders().runtime().then(({ ReplicationRuntime: ReplicationRuntime2 }) => {
+        const instance = new ReplicationRuntime2(this.config.replication);
+        this.replicationRuntimeInstance = instance;
+        return instance;
+      });
+      this.replicationRuntime = runtime;
+      this.replicationControl = {
+        status: async () => {
+          const status = await runtime.then((ready) => ready.control.status());
+          const scopeError = this.replicationScopeError;
+          if (!scopeError) return status;
+          return this.config.replication.prefixes.map((prefix) => ({
+            prefix,
+            state: "unavailable",
+            lastError: {
+              at: (/* @__PURE__ */ new Date()).toISOString(),
+              code: "SESSION_SCOPE_MISMATCH",
+              message: scopeError
+            },
+            pending: { inFlight: 0, committed: 0, ambiguous: 0 },
+            pinned: [],
+            lagMs: null
+          }));
+        },
+        sync: async (input) => (await runtime).control.sync(input),
+        purge: (input) => {
+          const instance = this.replicationRuntimeInstance;
+          return instance ? instance.control.purge(input) : runtime.then((ready) => ready.control.purge(input));
+        },
+        clearPending: async () => (await runtime).control.clearPending(),
+        close: async () => (await runtime).control.close()
+      };
+    }
     if (config.wasmBindings) {
       this.wasmBindings = config.wasmBindings;
     } else if (_TinyCloudNode.nodeDefaults) {
@@ -20400,7 +21085,14 @@ var _TinyCloudNode = class _TinyCloudNode {
       siweConfig: config.siweConfig,
       manifest: useBootstrapSignInRequest ? void 0 : config.manifest,
       capabilityRequest: useBootstrapSignInRequest ? config.includeAccountRegistryPermissions === false ? BOOTSTRAP_DEFAULT_ONLY_SESSION_REQUEST : BOOTSTRAP_SESSION_REQUESTS.default : config.capabilityRequest,
-      includeAccountRegistryPermissions: useBootstrapSignInRequest ? false : config.includeAccountRegistryPermissions
+      includeAccountRegistryPermissions: useBootstrapSignInRequest ? false : config.includeAccountRegistryPermissions,
+      // Sign-in needs only the entry inputs (prefixes + secrets opt-in);
+      // storage and scheduling never leave TinyCloudNode.
+      replication: config.replication?.enabled === true ? {
+        enabled: true,
+        prefixes: config.replication.prefixes,
+        allowSecrets: config.replication.allowSecrets === true
+      } : void 0
     });
     this.tc = new TinyCloud(this.auth, {
       invokeAny: this.invokeAnyWithRuntimePermissions,
@@ -20651,6 +21343,9 @@ var _TinyCloudNode = class _TinyCloudNode {
     this.confirmedHostedSpaceIds.clear();
     await this.tc.signIn(options);
     this.syncResolvedHostFromAuth();
+    this.replicationDelegateSession = void 0;
+    this.replicationScopeError = void 0;
+    if (this.replicationRuntime) await (await this.replicationRuntime).unbind();
     const oldGraph = this._serviceGraph;
     this._serviceGraph = this.createServiceGraphLifetime();
     oldGraph.retire();
@@ -20660,7 +21355,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       this.sessionKeyId = signedInSession.sessionKey;
       this.sessionKeyJwk = signedInSession.jwk;
     }
-    this.initializeServices();
+    await this.initializeServices();
     const primarySession = this.currentTinyCloudSession();
     if (primarySession) {
       this.registerPrimarySessionGrant(primarySession);
@@ -20672,6 +21367,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     }
     if (!bootstrapped) {
       this.scheduleAccountRegistrySync();
+      await this.accountRegistryTail;
     }
     this.notificationHandler.success("Successfully signed in");
   }
@@ -21124,7 +21820,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       provenance: "primary"
     });
   }
-  async writeManifestRegistryRecords() {
+  async writeManifestRegistryRecords(account, signal) {
     const request = this.capabilityRequest;
     if (!request || request.registryRecords.length === 0) {
       return;
@@ -21133,8 +21829,9 @@ var _TinyCloudNode = class _TinyCloudNode {
       throw new Error("Manifest registry write requires wallet mode");
     }
     const accountSpaceId = this.ownedSpaceId(ACCOUNT_REGISTRY_SPACE2);
-    await this.ensureOwnedSpaceHostedById(accountSpaceId);
-    const result = await this.account.applications.register(request.manifests);
+    await this.ensureOwnedSpaceHostedById(accountSpaceId, signal);
+    if (signal.aborted) throw signal.reason;
+    const result = await account.applications.register(request.manifests);
     if (!result.ok) {
       throw Object.assign(
         new Error(`Failed to write manifest registry records: ${result.error.message}`),
@@ -21142,34 +21839,113 @@ var _TinyCloudNode = class _TinyCloudNode {
       );
     }
   }
+  createAccountRegistryServices(context, signal) {
+    const session = context.session;
+    if (!session) throw new Error("Account registry requires an active service session");
+    const contexts = [context];
+    const accountSpaceId = this.ownedSpaceId(ACCOUNT_REGISTRY_SPACE2);
+    const createScopedContext = (spaceId) => {
+      const scoped = this._serviceGraph.track(new ServiceContext2({
+        invoke: context.invoke,
+        invokeAny: context.invokeAny,
+        fetch: context.fetch,
+        hosts: context.hosts,
+        telemetry: this.config.telemetry
+      }));
+      scoped.setOperationAbortSignal(signal);
+      scoped.setSession({ ...session, spaceId });
+      contexts.push(scoped);
+      return scoped;
+    };
+    const sql = new SQLService2({});
+    const sqlContext = createScopedContext(accountSpaceId);
+    sql.initialize(sqlContext);
+    const spaces = new SpaceService({
+      hosts: context.hosts,
+      session,
+      invoke: context.invoke,
+      fetch: (url, init2) => context.fetch(url, {
+        ...init2,
+        signal: init2?.signal ? AbortSignal.any([init2.signal, signal]) : signal
+      }),
+      userDid: this.did,
+      createKVService: (spaceId) => {
+        const kv = new KVService2({});
+        kv.initialize(createScopedContext(spaceId));
+        return kv;
+      }
+    });
+    return {
+      contexts,
+      account: new AccountService({
+        getDid: () => this.did,
+        getHost: () => context.hosts[0] ?? this.config.host,
+        getPrimarySpaceId: () => session.spaceId,
+        getAccountSpaceId: () => accountSpaceId,
+        getSpaces: () => spaces,
+        getAccountDb: () => sql.db("account"),
+        ensureAccountSpaceHosted: () => this.ensureOwnedSpaceHostedById(accountSpaceId, signal)
+      })
+    };
+  }
   scheduleAccountRegistrySync() {
     const session = this.currentTinyCloudSession();
     if (!session || this.pendingAccountRegistrySync?.session === session) {
       return;
     }
+    const controller = new AbortController();
+    const deadline = setTimeout(
+      () => controller.abort(new DOMException("Account registry deadline exceeded", "TimeoutError")),
+      this.accountRegistryDeadlineMs
+    );
     const promise = this.enqueueAccountRegistryOperation(session, async () => {
-      await this.withAccountRegistryRetry(async () => {
-        if (this.currentTinyCloudSession() !== session) {
-          return;
-        }
-        await this.account.index.ensure();
-        if (this.currentTinyCloudSession() !== session) {
-          return;
-        }
-        await this.writeManifestRegistryRecords();
-        if (this.currentTinyCloudSession() !== session) {
-          return;
-        }
-        if (this.currentSessionCanListSpaces()) {
-          const spaces = await this.account.spaces.syncAccessible();
-          if (!spaces.ok) {
-            throw Object.assign(
-              new Error(`Failed to sync account spaces: ${spaces.error.message}`),
-              { cause: spaces.error }
-            );
+      const sharedContext = this._serviceContext;
+      if (!sharedContext) return;
+      const context = this._serviceGraph.track(new ServiceContext2({
+        invoke: sharedContext.invoke,
+        invokeAny: sharedContext.invokeAny,
+        fetch: sharedContext.fetch,
+        hosts: sharedContext.hosts,
+        telemetry: this.config.telemetry
+      }));
+      context.setOperationAbortSignal(controller.signal);
+      const current = this.currentTinyCloudSession();
+      if (!current) return;
+      context.setSession({
+        delegationHeader: current.delegationHeader,
+        delegationCid: current.delegationCid,
+        spaceId: current.spaceId,
+        verificationMethod: current.verificationMethod,
+        jwk: current.jwk
+      });
+      const registry = this.createAccountRegistryServices(context, controller.signal);
+      try {
+        await this.withAccountRegistryRetry(async () => {
+          if (controller.signal.aborted) throw controller.signal.reason;
+          if (this.currentTinyCloudSession() !== session) return;
+          await registry.account.index.ensure();
+          if (controller.signal.aborted) throw controller.signal.reason;
+          if (this.currentTinyCloudSession() !== session) return;
+          await this.writeManifestRegistryRecords(registry.account, controller.signal);
+          if (controller.signal.aborted) throw controller.signal.reason;
+          if (this.currentTinyCloudSession() !== session) return;
+          if (this.currentSessionCanListSpaces()) {
+            const result = await registry.account.spaces.syncAccessible();
+            if (controller.signal.aborted) throw controller.signal.reason;
+            if (!result.ok) {
+              throw Object.assign(
+                new Error(`Failed to sync account spaces: ${result.error.message}`),
+                { cause: result.error }
+              );
+            }
           }
+        }, controller.signal);
+      } finally {
+        for (const operationContext of registry.contexts) {
+          operationContext.retire();
         }
-      });
+        clearTimeout(deadline);
+      }
     });
     this.pendingAccountRegistrySync = { session, promise };
     const clearPendingSync = () => {
@@ -21178,6 +21954,10 @@ var _TinyCloudNode = class _TinyCloudNode {
       }
     };
     void promise.then(clearPendingSync, clearPendingSync);
+    void promise.then(
+      () => clearTimeout(deadline),
+      () => clearTimeout(deadline)
+    );
   }
   enqueueAccountRegistryOperation(session, task) {
     const operation = this.accountRegistryTail.then(async () => {
@@ -21213,14 +21993,22 @@ var _TinyCloudNode = class _TinyCloudNode {
       (operation) => operation.service === "space" && this.actionContains(operation.action, "tinycloud.space/list")
     );
   }
-  async withAccountRegistryRetry(task) {
+  async withAccountRegistryRetry(task, signal) {
     const delays = [250, 1e3, 3e3];
     let lastError;
     for (let attempt = 0; attempt < delays.length; attempt += 1) {
+      if (signal.aborted) {
+        console.warn("TinyCloud account registry sync stopped: deadline exceeded", signal.reason);
+        return;
+      }
       try {
         await task();
         return;
       } catch (error) {
+        if (signal.aborted) {
+          console.warn("TinyCloud account registry sync stopped: deadline exceeded", error);
+          return;
+        }
         const verdict = authorizationVerdictOf(error);
         const message = error instanceof Error ? error.message : String(error);
         const isAuthorizationVerdict = verdict === void 0 ? /Unauthorized Action|\b(?:401|403)\b/.test(message) : verdict !== "other";
@@ -21232,12 +22020,28 @@ var _TinyCloudNode = class _TinyCloudNode {
           return;
         }
         if (isStorageFullError(error) || isStorageFullError(error?.cause) || message.includes(STORAGE_FULL_MESSAGE) || message.includes(STORAGE_WRITE_TOO_LARGE_MESSAGE)) {
-          console.warn("TinyCloud account registry sync stopped: storage is full", error);
+          console.warn(
+            "TinyCloud account registry sync stopped: storage is full",
+            error
+          );
           return;
         }
         lastError = error;
         if (attempt < delays.length - 1) {
-          await new Promise((resolve) => setTimeout(resolve, delays[attempt]));
+          await new Promise((resolve, reject2) => {
+            const timer = setTimeout(() => {
+              signal.removeEventListener("abort", onAbort);
+              resolve();
+            }, delays[attempt]);
+            const onAbort = () => {
+              clearTimeout(timer);
+              signal.removeEventListener("abort", onAbort);
+              reject2(signal.reason);
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+          }).catch((error2) => {
+            if (!signal.aborted) throw error2;
+          });
         }
       }
     }
@@ -21287,7 +22091,7 @@ var _TinyCloudNode = class _TinyCloudNode {
    * self-revealing: the next write to the space fails immediately and loudly
    * with `404 Space not found`.
    */
-  async ensureOwnedSpaceHostedById(spaceId) {
+  async ensureOwnedSpaceHostedById(spaceId, signal) {
     if (!this.auth) {
       throw new Error("Owned space hosting requires wallet mode");
     }
@@ -21302,7 +22106,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     if (!host) {
       throw new Error("Owned space hosting requires a TinyCloud host");
     }
-    const activation = await activateSessionWithHost2(host, session.delegationHeader);
+    const activation = await activateSessionWithHost2(host, session.delegationHeader, signal);
     if (activation.success && !activation.skipped?.includes(spaceId)) {
       this.confirmedHostedSpaceIds.add(spaceId);
       return;
@@ -21313,15 +22117,16 @@ var _TinyCloudNode = class _TinyCloudNode {
         { cause: activation }
       );
     }
-    const created = await this.auth.hostOwnedSpaceResult(spaceId);
+    const authorization = this.auth;
+    const created = signal ? await authorization.hostOwnedSpaceResult(spaceId, void 0, signal) : await authorization.hostOwnedSpaceResult(spaceId);
     if (!created.success) {
       throw Object.assign(
         new Error(`Failed to create owned space ${spaceId}: ${describeHostFailure2(created)}`),
         { cause: created }
       );
     }
-    await new Promise((resolve) => setTimeout(resolve, 100));
-    const retry = await activateSessionWithHost2(host, session.delegationHeader);
+    if (signal?.aborted) throw signal.reason;
+    const retry = await activateSessionWithHost2(host, session.delegationHeader, signal);
     if (!retry.success || retry.skipped?.includes(spaceId)) {
       throw Object.assign(
         new Error(
@@ -21599,11 +22404,39 @@ var _TinyCloudNode = class _TinyCloudNode {
     const stagedHost = resolvedHost ?? this.config.host;
     const stagedAddress = restoredAddress;
     const stagedChainId = sessionData.chainId ?? 1;
-    const stagedNodeDid = stagedAddress ? pkhDid2(stagedAddress, stagedChainId) : canonicalVerificationMethod;
-    const serviceSession = {
-      delegationHeader: sessionData.delegationHeader,
-      delegationCid: sessionData.delegationCid,
-      spaceId: sessionData.spaceId,
+    let replicationPrincipal;
+    let compactReplicationSession;
+    let replicationScopeError;
+    if (this.config.replication?.enabled) {
+      if (stagedAddress !== void 0) {
+        replicationPrincipal = pkhDid2(stagedAddress, stagedChainId);
+      } else {
+        const { replicationScopeFromSignedSession: replicationScopeFromSignedSession2 } = await getNodeReplicationLoaders().authority();
+        const signedScope = replicationScopeFromSignedSession2({
+          delegationHeader: sessionData.delegationHeader,
+          delegationCid: sessionData.delegationCid,
+          verificationMethod: restoredVerificationMethod,
+          persistedSpace: sessionData.spaceId
+        });
+        if (!signedScope) {
+          replicationScopeError = "Persisted space does not match the locally verified delegation scope.";
+        } else {
+          replicationPrincipal = signedScope.principal;
+          compactReplicationSession = {
+            delegationHeader: sessionData.delegationHeader,
+            delegationCid: sessionData.delegationCid,
+            spaceId: signedScope.space,
+            verificationMethod: restoredVerificationMethod,
+            jwk: stagedJwk
+          };
+        }
+      }
+    }
+    const stagedNodeDid = stagedAddress ? pkhDid2(stagedAddress, stagedChainId) : canonicalVerificationMethod;
+    const serviceSession = {
+      delegationHeader: sessionData.delegationHeader,
+      delegationCid: sessionData.delegationCid,
+      spaceId: sessionData.spaceId,
       verificationMethod: restoredVerificationMethod,
       jwk: stagedJwk
     };
@@ -21677,7 +22510,18 @@ var _TinyCloudNode = class _TinyCloudNode {
     } else {
       this._restoredTcSession = stagedTcSession;
     }
+    this.replicationDelegateSession = compactReplicationSession;
+    this.replicationScopeError = replicationScopeError;
+    if (this.replicationRuntime) await (await this.replicationRuntime).unbind();
     oldGraph.retire();
+    if (replicationScopeError) {
+      stagedGraph.serviceContext.emit("replication.state", {
+        state: "unavailable",
+        code: "SESSION_SCOPE_MISMATCH",
+        detail: replicationScopeError
+      });
+    }
+    await this.bindReplicationRuntime(stagedGraph.serviceContext, serviceSession, stagedGraph.kv, replicationPrincipal);
     oldCore?.retireServices?.();
   }
   stagePrimarySessionState(session, verificationMethod, host, sessionExpiry, recap) {
@@ -21831,6 +22675,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         }));
         context.setSession(config.session);
         service.initialize(context);
+        this.attachReplicationKV(config.session.spaceId, service);
         return service;
       }
     });
@@ -21871,6 +22716,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         }));
         context.setSession({ ...input.serviceSession, spaceId });
         scopedKv.initialize(context);
+        this.attachReplicationKV(spaceId, scopedKv);
         return scopedKv;
       },
       createVaultService: (spaceId) => {
@@ -21885,6 +22731,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         }));
         context.setSession({ ...input.serviceSession, spaceId });
         scopedKv.initialize(context);
+        this.attachReplicationKV(spaceId, scopedKv);
         const scopedVault = this.createVaultService(spaceId, scopedKv, encryption, {
           host: input.host,
           did: input.nodeDid,
@@ -22165,7 +23012,12 @@ var _TinyCloudNode = class _TinyCloudNode {
       siweConfig: this.config.siweConfig,
       manifest: useBootstrapSignInRequest ? void 0 : this.config.manifest,
       capabilityRequest: useBootstrapSignInRequest ? this.config.includeAccountRegistryPermissions === false ? BOOTSTRAP_DEFAULT_ONLY_SESSION_REQUEST : BOOTSTRAP_SESSION_REQUESTS.default : this.config.capabilityRequest,
-      includeAccountRegistryPermissions: useBootstrapSignInRequest ? false : this.config.includeAccountRegistryPermissions
+      includeAccountRegistryPermissions: useBootstrapSignInRequest ? false : this.config.includeAccountRegistryPermissions,
+      replication: this.config.replication?.enabled === true ? {
+        enabled: true,
+        prefixes: this.config.replication.prefixes,
+        allowSecrets: this.config.replication.allowSecrets === true
+      } : void 0
     });
     this.tc = new TinyCloud(this.auth, {
       invokeAny: this.invokeAnyWithRuntimePermissions,
@@ -22218,7 +23070,12 @@ var _TinyCloudNode = class _TinyCloudNode {
       siweConfig: this.config.siweConfig,
       manifest: useBootstrapSignInRequest ? void 0 : this.config.manifest,
       capabilityRequest: useBootstrapSignInRequest ? this.config.includeAccountRegistryPermissions === false ? BOOTSTRAP_DEFAULT_ONLY_SESSION_REQUEST : BOOTSTRAP_SESSION_REQUESTS.default : this.config.capabilityRequest,
-      includeAccountRegistryPermissions: useBootstrapSignInRequest ? false : this.config.includeAccountRegistryPermissions
+      includeAccountRegistryPermissions: useBootstrapSignInRequest ? false : this.config.includeAccountRegistryPermissions,
+      replication: this.config.replication?.enabled === true ? {
+        enabled: true,
+        prefixes: this.config.replication.prefixes,
+        allowSecrets: this.config.replication.allowSecrets === true
+      } : void 0
     });
     this.tc = new TinyCloud(this.auth, {
       invokeAny: this.invokeAnyWithRuntimePermissions,
@@ -22230,7 +23087,7 @@ var _TinyCloudNode = class _TinyCloudNode {
    * Initialize the service context and KV service after sign-in.
    * @internal
    */
-  initializeServices() {
+  async initializeServices() {
     const session = this.currentTinyCloudSession();
     if (!session) {
       return;
@@ -22273,12 +23130,18 @@ var _TinyCloudNode = class _TinyCloudNode {
       jwk: session.jwk
     };
     this._serviceContext.setSession(serviceSession);
+    await this.bindReplicationRuntime(this._serviceContext, serviceSession, this._kv);
     this.tc.serviceContext.setSession(serviceSession);
     this._vault = this.createVaultService(session.spaceId, this._kv);
     this._vault.initialize(this._serviceContext);
     this._serviceContext.registerService("vault", this._vault);
     this.initializeV2Services(serviceSession);
   }
+  attachReplicationKV(spaceId, kvService) {
+    if (!this.replicationRuntime) return;
+    const attached = this.replicationRuntime.then((runtime) => runtime.attach(spaceId, kvService));
+    kvService.setReadThroughReady(attached);
+  }
   createSpaceScopedKVService(spaceId) {
     const kvService = new KVService2({});
     if (this._serviceContext) {
@@ -22294,6 +23157,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         spaceScopedContext.setSession({ ...session, spaceId });
       }
       kvService.initialize(spaceScopedContext);
+      this.attachReplicationKV(spaceId, kvService);
     }
     return kvService;
   }
@@ -22756,6 +23620,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         }));
         context.setSession(config.session);
         service.initialize(context);
+        this.attachReplicationKV(config.session.spaceId, service);
         return service;
       },
       onRootDelegationNeeded: this.signer ? async (params) => {
@@ -23080,6 +23945,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     }));
     spaceScopedContext.setSession({ ...this._serviceContext.session, spaceId });
     kv.initialize(spaceScopedContext);
+    this.attachReplicationKV(spaceId, kv);
     return kv;
   }
   /**
@@ -23801,7 +24667,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       throw new Error("Public space not enabled. Set enablePublicSpace: true in config.");
     }
     await this.auth.hostPublicSpace(publicSpaceId);
-    const kvActions = [KV2.PUT, KV2.GET, KV2.DEL, KV2.LIST, KV2.METADATA];
+    const kvActions = [KV3.PUT, KV3.GET, KV3.DEL, KV3.LIST, KV3.METADATA];
     const abilities = { kv: { "": kvActions } };
     const now = /* @__PURE__ */ new Date();
     const expiryMs = EXPIRY3.EPHEMERAL_MS;
@@ -24042,31 +24908,31 @@ var _TinyCloudNode = class _TinyCloudNode {
       );
       return { delegation: delegation2, prompted: true };
     }
-    const granted = this.projectSignedRecapCapabilities(session.siwe);
-    const { subset, missing } = this.signedCapabilitySubset(expandedEntries, granted);
-    if (!subset) {
-      const runtimeOperations = this.permissionEntriesToOperations(expandedEntries, session);
-      const runtimeGrant = this.findGrantForOperations(
-        runtimeOperations,
-        { excludePrimary: true }
-      );
-      if (runtimeGrant) {
-        const marginMs = _TinyCloudNode.SESSION_EXPIRY_SAFETY_MARGIN_MS;
-        if (runtimeGrant.expiresAt.getTime() <= Date.now() + marginMs) {
-          throw new SessionExpiredError(runtimeGrant.expiresAt);
-        }
-        const runtimeExpiration = runtimeGrant.expiresAt < effectiveExpiration ? runtimeGrant.expiresAt : effectiveExpiration;
-        const delegation2 = await this.createDelegationViaRuntimeGrant(
-          did,
-          expandedEntries,
-          runtimeExpiration,
-          runtimeGrant,
-          runtimeOperations,
-          onPrepared
-        );
-        return { delegation: delegation2, prompted: false };
+    const plan = this.planDerivation(
+      expandedEntries,
+      session,
+      effectiveExpiration,
+      Date.now()
+    );
+    if ("refused" in plan) {
+      if (plan.refused === "SESSION_EXPIRING") {
+        throw new SessionExpiredError(plan.expiredAt ?? sessionExpiry ?? /* @__PURE__ */ new Date(0));
       }
-      throw new PermissionNotInManifestError(missing, granted);
+      if (plan.refused === "CAVEATED_AUTHORITY") {
+        throw new CaveatedDelegationUnsupportedError(plan.caveated ?? []);
+      }
+      throw new PermissionNotInManifestError(plan.missing ?? [], plan.granted ?? []);
+    }
+    if (plan.path === "runtime") {
+      const delegation2 = await this.createDelegationViaRuntimeGrant(
+        did,
+        expandedEntries,
+        plan.effectiveExpiration,
+        plan.grant,
+        plan.operations,
+        onPrepared
+      );
+      return { delegation: delegation2, prompted: false };
     }
     const delegation = await this.createDelegationViaWasmPath(
       did,
@@ -24077,6 +24943,149 @@ var _TinyCloudNode = class _TinyCloudNode {
     );
     return { delegation, prompted: false };
   }
+  /**
+   * What `delegateTo` would select for `entries`, without signing or any
+   * network call (TC-858 plan v3 §4.3): the session path when the signed
+   * recap covers every entry, the runtime-grant path otherwise, or a
+   * refusal. A refusal of `CAVEATED_AUTHORITY` means coverage exists only
+   * through caveated branches, which the action-only WASM child-delegation
+   * boundary cannot preserve — replication never derives authority through
+   * them. `expiredAt`/`missing`/`granted`/`caveated` carry the payload
+   * `delegateTo` turns back into its typed errors.
+   * @internal
+   */
+  planDerivation(expandedEntries, session, effectiveExpiration, nowMs) {
+    const caveatedRequest = expandedEntries.filter(
+      (entry) => !recapCaveatsEqual(entry.caveats, void 0)
+    );
+    if (caveatedRequest.length > 0) {
+      return { refused: "CAVEATED_AUTHORITY", caveated: caveatedRequest };
+    }
+    const granted = this.projectSignedRecapCapabilities(session.siwe);
+    const { subset, missing } = this.signedCapabilitySubset(expandedEntries, granted);
+    if (subset) {
+      return {
+        path: "session",
+        parentCid: session.delegationCid,
+        expiresAt: effectiveExpiration.getTime(),
+        effectiveExpiration
+      };
+    }
+    const runtimeOperations = this.permissionEntriesToOperations(expandedEntries, session);
+    const runtimeGrant = this.findGrantForOperations(
+      runtimeOperations,
+      { excludePrimary: true }
+    );
+    if (runtimeGrant) {
+      const marginMs = _TinyCloudNode.SESSION_EXPIRY_SAFETY_MARGIN_MS;
+      if (runtimeGrant.expiresAt.getTime() <= nowMs + marginMs) {
+        return { refused: "SESSION_EXPIRING", expiredAt: runtimeGrant.expiresAt };
+      }
+      const caveated = this.caveatedRuntimeGrantEntries(
+        expandedEntries,
+        runtimeOperations,
+        runtimeGrant
+      );
+      if (caveated.length > 0) {
+        return { refused: "CAVEATED_AUTHORITY", caveated };
+      }
+      const runtimeExpiration = runtimeGrant.expiresAt < effectiveExpiration ? runtimeGrant.expiresAt : effectiveExpiration;
+      return {
+        path: "runtime",
+        parentCid: runtimeGrant.session.delegationCid,
+        expiresAt: runtimeExpiration.getTime(),
+        effectiveExpiration: runtimeExpiration,
+        grant: runtimeGrant,
+        operations: runtimeOperations
+      };
+    }
+    const relaxedGranted = granted.map((entry) => ({ ...entry, caveats: void 0 }));
+    const relaxedRequested = expandedEntries.map((entry) => ({ ...entry, caveats: void 0 }));
+    const relaxed = this.signedCapabilitySubset(relaxedRequested, relaxedGranted);
+    if (relaxed.subset) {
+      return {
+        refused: "CAVEATED_AUTHORITY",
+        caveated: missing.map((entry) => ({ ...entry, caveats: [{ via: "session-recap" }] }))
+      };
+    }
+    return { refused: "NOT_COVERED", missing, granted };
+  }
+  /**
+   * The plan `delegateTo(device, entries)` would follow, as a pure lookup:
+   * no WASM sign and no `POST /delegate`. Backs
+   * `ReplicationAuthority.plan` (and `mint` inside it) so a predicted
+   * parent and expiry can never disagree with what a mint would use (§4.3,
+   * §4.4). Session expiry inside the 60 s margin refuses with
+   * `SESSION_EXPIRING`; the same check delegateTo performs.
+   * @internal
+   */
+  planDelegation(entries, options) {
+    if (!Array.isArray(entries) || entries.length === 0) {
+      throw new Error("planDelegation requires a non-empty permissions array");
+    }
+    const session = this.currentTinyCloudSession();
+    if (!session) {
+      return { refused: "SESSION_EXPIRING", expiredAt: /* @__PURE__ */ new Date(0) };
+    }
+    const nowMs = Date.now();
+    const sessionExpiry = extractSiweExpiration(session.siwe);
+    if (sessionExpiry !== void 0 && sessionExpiry.getTime() <= nowMs + _TinyCloudNode.SESSION_EXPIRY_SAFETY_MARGIN_MS) {
+      return { refused: "SESSION_EXPIRING", expiredAt: sessionExpiry };
+    }
+    const expandedEntries = this.expandPermissionEntries(entries);
+    const expiryMs = resolveExpiryMs(options?.expiry);
+    const expirationTime = new Date(nowMs + expiryMs);
+    const effectiveExpiration = sessionExpiry !== void 0 && sessionExpiry < expirationTime ? sessionExpiry : expirationTime;
+    return this.planDerivation(expandedEntries, session, effectiveExpiration, nowMs);
+  }
+  /**
+   * The replication entries this node's sign-in request carries for the
+   * current replication config and the signed-in or restored address: the
+   * output of the same augmentation step `resolveSignInCapabilities` runs,
+   * with the unrestricted-get and secrets gates applied (§4.1, §4.6).
+   * Empty when replication is off or no address is known. Pure.
+   */
+  replicationSignInEntries() {
+    if (this.config.replication?.enabled !== true) return [];
+    const auth = this.auth;
+    if (auth === void 0 || typeof auth.replicationSignInEntries !== "function") {
+      return [];
+    }
+    return auth.replicationSignInEntries();
+  }
+  async replicationAuthority() {
+    const { createReplicationAuthority: createReplicationAuthority2 } = await getNodeReplicationLoaders().authority();
+    return createReplicationAuthority2({
+      replicationSession: () => this.currentTinyCloudSession() ?? this.replicationDelegateSession,
+      siweExpiration: (siwe) => extractSiweExpiration(siwe),
+      planDelegation: (entries, options) => this.planDelegation(entries, options),
+      mintDelegation: async (deviceDid, entries) => {
+        const result = await this.delegateTo(principalDid(deviceDid), entries);
+        return {
+          ucan: result.delegation.delegationHeader.Authorization,
+          expiresAt: result.delegation.expiry.getTime()
+        };
+      }
+    });
+  }
+  async bindReplicationRuntime(context, session, kv, principal) {
+    if (!this.replicationRuntime) return;
+    const identityPrincipal = principal ?? (this._address === void 0 ? void 0 : pkhDid2(this._address, this._chainId));
+    if (identityPrincipal === void 0) return;
+    const runtime = await this.replicationRuntime;
+    const authority = await this.replicationAuthority();
+    await runtime.bind({
+      context,
+      session,
+      principal: identityPrincipal,
+      authority,
+      primaryKV: [{ space: session.spaceId, kv }]
+    });
+  }
+  /** Stable control facade for this node's optional replication runtime. */
+  get replication() {
+    return this.replicationControl;
+  }
   /**
    * Materialize one manifest-declared delegation using the current session key.
    * Delivery is intentionally out of band; callers decide how to transmit the
@@ -24299,6 +25308,18 @@ var _TinyCloudNode = class _TinyCloudNode {
    * it only accepts action maps, so reject the selected constrained branch.
    */
   assertRuntimeGrantCaveatsPreservable(entries, requestedOperations, grant) {
+    const caveated = this.caveatedRuntimeGrantEntries(entries, requestedOperations, grant);
+    if (caveated.length > 0) {
+      throw new CaveatedDelegationUnsupportedError(caveated);
+    }
+  }
+  /**
+   * The entries of `grant` that cover a requested operation while carrying
+   * caveats — the branches {@link assertRuntimeGrantCaveatsPreservable}
+   * rejects and {@link planDerivation} classifies as `CAVEATED_AUTHORITY`.
+   * Shared so the pure plan and the mint path can't disagree.
+   */
+  caveatedRuntimeGrantEntries(entries, requestedOperations, grant) {
     let operationIndex = 0;
     const caveated = [];
     for (const entry of entries) {
@@ -24317,9 +25338,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         }
       }
     }
-    if (caveated.length > 0) {
-      throw new CaveatedDelegationUnsupportedError(caveated);
-    }
+    return caveated;
   }
   /** Reject caveated parent branches before action-only child signing. */
   assertPortableDelegationCaveatsPreservable(delegation) {
@@ -24424,7 +25443,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     const missing = requested.filter((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 !isCapabilitySubset2([comparable], raw ? rawGranted : spaceGranted).subset;
     });
     return { subset: missing.length === 0, missing };
   }
@@ -24896,7 +25915,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         session.chainId
       );
       const publicAbilities = {
-        kv: { "": [KV2.GET, KV2.PUT, KV2.METADATA] }
+        kv: { "": [KV3.GET, KV3.PUT, KV3.METADATA] }
       };
       const publicPrepared = this.wasmBindings.prepareSession({
         abilities: publicAbilities,
@@ -24924,7 +25943,7 @@ var _TinyCloudNode = class _TinyCloudNode {
           delegationHeader: publicSession.delegationHeader,
           spaceId: publicSpaceId,
           path: "",
-          actions: [KV2.GET, KV2.PUT, KV2.METADATA],
+          actions: [KV3.GET, KV3.PUT, KV3.METADATA],
           disableSubDelegation: params.disableSubDelegation ?? false,
           expiry: expirationTime,
           delegateDID: params.delegateDID,
@@ -25189,6 +26208,12 @@ TinyCloudNode.registerNodeDefaults({
   createSigner: (privateKey, chainId) => new PrivateKeySigner(privateKey, chainId)
 });
 
+// src/replication/node-loader.ts
+registerReplicationLoaders({
+  runtime: () => Promise.resolve().then(() => (init_runtime(), runtime_exports)),
+  authority: () => Promise.resolve().then(() => (init_authority(), authority_exports))
+});
+
 // src/index.ts
 import { TinyCloud as TinyCloud2 } from "@tinycloud/sdk-core";
 import {
@@ -25206,8 +26231,8 @@ import {
   isEvmAddress,
   makePkhSpaceId as makePkhSpaceId2,
   parsePkhDid,
-  pkhDid as pkhDid3,
-  principalDid,
+  pkhDid as pkhDid4,
+  principalDid as principalDid3,
   principalDidEquals as principalDidEquals4,
   parseCanonicalNetworkId,
   TinyCloudDebugLogger,
@@ -25401,7 +26426,7 @@ import {
   resolveManifest as resolveManifest2,
   validateManifest,
   loadManifest,
-  isCapabilitySubset as isCapabilitySubset2,
+  isCapabilitySubset as isCapabilitySubset4,
   expandActionShortNames,
   expandPermissionEntries as expandPermissionEntries2,
   expandPermissionEntry,
@@ -25410,7 +26435,7 @@ import {
 } from "@tinycloud/sdk-core";
 import {
   DEFAULT_SIGNED_READ_URL_EXPIRY_MS,
-  KVService as KVService3,
+  KVService as KVService4,
   PrefixedKVService
 } from "@tinycloud/sdk-core";
 import { SQLService as SQLService3, SQLAction, DatabaseHandle } from "@tinycloud/sdk-core";
@@ -25494,7 +26519,7 @@ import {
   SpaceService as SpaceService2,
   SpaceErrorCodes,
   createSpaceService,
-  parseSpaceUri,
+  parseSpaceUri as parseSpaceUri3,
   buildSpaceUri,
   makePublicSpaceId as makePublicSpaceId2,
   Space
@@ -25505,7 +26530,849 @@ import {
   UnsupportedFeatureError as UnsupportedFeatureError2,
   checkNodeInfo as checkNodeInfo2
 } from "@tinycloud/sdk-core";
-import { ServiceContext as ServiceContext3 } from "@tinycloud/sdk-core";
+import { ServiceContext as ServiceContext4 } from "@tinycloud/sdk-core";
+
+// src/replication/sqlite.ts
+init_authority();
+import { createHash as createHash2, randomBytes as randomBytes2 } from "crypto";
+import { chmod, mkdir, open as openFile, readFile, realpath, rename, rm, stat } from "fs/promises";
+import { basename, dirname as dirname2, join as join2 } from "path";
+import { KVService as KVService3, ServiceContext as ServiceContext3, principalDid as principalDid2 } from "@tinycloud/sdk-core";
+import {
+  canonicalReplicationIdentity,
+  replicationIdentityKey,
+  requiresSecretsOptIn as requiresSecretsOptIn2
+} from "@tinycloud/sdk-services";
+var ReplicaStorageError = class extends Error {
+  constructor(code, message, options) {
+    super(message);
+    this.name = "ReplicaStorageError";
+    this.code = code;
+    this.cause = options?.cause;
+  }
+};
+function storageError(code, action, error) {
+  if (error instanceof ReplicaStorageError) return error;
+  const detail = error instanceof Error ? error.message : String(error);
+  return new ReplicaStorageError(code, `${action} failed: ${detail}`, { cause: error });
+}
+function isNotFound(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+async function pathExists(path) {
+  try {
+    await stat(path);
+    return true;
+  } catch (error) {
+    if (isNotFound(error)) return false;
+    throw storageError("STORAGE_ERROR", `Reading ${path}`, error);
+  }
+}
+function principalOf(did) {
+  return principalDid2(did);
+}
+var BASE32 = "abcdefghijklmnopqrstuvwxyz234567";
+function sha256Base32(material) {
+  const digest = createHash2("sha256").update(material, "utf8").digest();
+  let out = "";
+  let buffer = 0;
+  let bits = 0;
+  for (const byte of digest) {
+    buffer = buffer << 8 | byte;
+    bits += 8;
+    while (bits >= 5) {
+      out += BASE32[buffer >>> bits - 5 & 31];
+      bits -= 5;
+    }
+  }
+  if (bits > 0) out += BASE32[buffer << 5 - bits & 31];
+  return out.slice(0, 26);
+}
+function partitionDirOf(root, identity) {
+  return join2(root, sha256Base32(replicationIdentityKey(identity)));
+}
+function replicaHashOf(prefix, deviceDid) {
+  return sha256Base32(`${prefix}
+${principalOf(deviceDid)}`);
+}
+async function writeJsonAtomic(path, value, dirSync = fsyncDir) {
+  const tmp = `${path}.${randomBytes2(6).toString("hex")}.tmp`;
+  let handle;
+  try {
+    handle = await openFile(tmp, "w", 384);
+    await handle.writeFile(JSON.stringify(value), "utf8");
+    await handle.sync();
+    await handle.close();
+    await rename(tmp, path);
+    await dirSync(dirname2(path));
+    await chmod(path, 384).catch(() => void 0);
+  } catch (error) {
+    try {
+      await handle?.close();
+    } catch {
+    }
+    await rm(tmp, { force: true }).catch(() => void 0);
+    throw storageError("STORAGE_ERROR", `Writing ${path}`, error);
+  }
+}
+var DIR_SYNC_UNSUPPORTED = {
+  ENOTSUP: true,
+  ENOSYS: true,
+  EINVAL: true,
+  EISDIR: true,
+  EPERM: true
+};
+async function fsyncDir(dir) {
+  let handle;
+  try {
+    handle = await openFile(dir, "r");
+    await handle.sync();
+  } catch (error) {
+    const code = typeof error === "object" && error !== null && "code" in error ? error.code : void 0;
+    if (typeof code === "string" && DIR_SYNC_UNSUPPORTED[code] === true) return;
+    throw storageError("STORAGE_ERROR", `Syncing ${dir}`, error);
+  } finally {
+    await handle?.close().catch(() => void 0);
+  }
+}
+async function readJsonFile(path) {
+  try {
+    return JSON.parse(await readFile(path, "utf8"));
+  } catch (error) {
+    if (isNotFound(error)) return void 0;
+    throw storageError("STORAGE_ERROR", `Reading ${path}`, error);
+  }
+}
+function identityRecordOf(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  if (!("host" in value) || !("space" in value) || !("principal" in value) || typeof value.host !== "string" || typeof value.space !== "string" || typeof value.principal !== "string") {
+    return void 0;
+  }
+  return { host: value.host, space: value.space, principal: value.principal };
+}
+function deviceRecordOf(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  if (!("did" in value) || !("jwk" in value) || typeof value.did !== "string" || value.jwk === null || typeof value.jwk !== "object") {
+    return void 0;
+  }
+  return { did: value.did, jwk: value.jwk };
+}
+function sameIdentity(a, b) {
+  try {
+    const left = canonicalReplicationIdentity(a);
+    const right = canonicalReplicationIdentity(b);
+    return left.host === right.host && left.space === right.space && left.principal === right.principal;
+  } catch {
+    return false;
+  }
+}
+async function ensurePartitionIdentity(dir, identity, dirSync) {
+  try {
+    await mkdir(dir, { recursive: true, mode: 448 });
+    await chmod(dir, 448);
+  } catch (error) {
+    throw storageError("STORAGE_ERROR", `Creating ${dir}`, error);
+  }
+  const file = join2(dir, "identity.json");
+  const existing = await readJsonFile(file);
+  if (existing === void 0) {
+    await writeJsonAtomic(file, { v: 1, ...canonicalReplicationIdentity(identity) }, dirSync);
+    return;
+  }
+  const record = identityRecordOf(existing);
+  if (record === void 0 || !sameIdentity(record, identity)) {
+    throw new ReplicaStorageError(
+      "STORAGE_ERROR",
+      `The partition at ${dir} belongs to a different identity.`
+    );
+  }
+}
+var PENDING_WRITE_LOCKS = /* @__PURE__ */ new Map();
+function serializePendingWrite(file, section) {
+  const tail = PENDING_WRITE_LOCKS.get(file) ?? Promise.resolve();
+  const entered = tail.then(section);
+  const next = entered.then(
+    () => void 0,
+    () => void 0
+  );
+  PENDING_WRITE_LOCKS.set(file, next);
+  void next.then(() => {
+    if (PENDING_WRITE_LOCKS.get(file) === next) PENDING_WRITE_LOCKS.delete(file);
+  });
+  return entered;
+}
+function parsePendingState(text, file, identity) {
+  let state;
+  try {
+    state = JSON.parse(text);
+  } catch (error) {
+    throw storageError("STORAGE_ERROR", `Parsing ${file}`, error);
+  }
+  if (state === null || typeof state !== "object" || !("v" in state) || state.v !== 2 || !("identity" in state) || !("committedEpoch" in state) || typeof state.committedEpoch !== "number" || !("seq" in state) || typeof state.seq !== "number" || !("records" in state) || !Array.isArray(state.records)) {
+    throw new ReplicaStorageError("STORAGE_ERROR", `Pending-write state at ${file} is corrupt.`);
+  }
+  const storedIdentity = identityRecordOf(state.identity);
+  if (storedIdentity === void 0 || !sameIdentity(storedIdentity, identity)) {
+    throw new ReplicaStorageError("STORAGE_ERROR", `Pending-write state at ${file} belongs to a different identity.`);
+  }
+  return state;
+}
+var _dir, _guard, _dirSync, _file, _FilePendingWriteStore_instances, canonicalFile_fn;
+var FilePendingWriteStore = class {
+  constructor(identity, dir, guard, dirSync) {
+    __privateAdd(this, _FilePendingWriteStore_instances);
+    this.durable = true;
+    __privateAdd(this, _dir);
+    __privateAdd(this, _guard);
+    __privateAdd(this, _dirSync);
+    __privateAdd(this, _file);
+    this.identity = identity;
+    __privateSet(this, _dir, dir);
+    __privateSet(this, _guard, guard);
+    __privateSet(this, _dirSync, dirSync);
+  }
+  async read() {
+    const file = await __privateMethod(this, _FilePendingWriteStore_instances, canonicalFile_fn).call(this);
+    let text;
+    try {
+      text = await readFile(file, "utf8");
+    } catch (error) {
+      if (isNotFound(error)) {
+        return { v: 2, identity: this.identity, committedEpoch: 0, seq: 0, records: [] };
+      }
+      throw storageError("STORAGE_ERROR", `Reading ${file}`, error);
+    }
+    return parsePendingState(text, file, this.identity);
+  }
+  async readExisting() {
+    let file;
+    try {
+      file = join2(await realpath(__privateGet(this, _dir)), "pending.json");
+    } catch (error) {
+      if (isNotFound(error)) return void 0;
+      throw storageError("STORAGE_ERROR", `Resolving pending-write state in ${__privateGet(this, _dir)}`, error);
+    }
+    try {
+      const text = await readFile(file, "utf8");
+      return parsePendingState(text, file, this.identity);
+    } catch (error) {
+      if (isNotFound(error)) return void 0;
+      if (error instanceof ReplicaStorageError) throw error;
+      throw storageError("STORAGE_ERROR", `Reading ${file}`, error);
+    }
+  }
+  async update(mutate) {
+    const file = await __privateMethod(this, _FilePendingWriteStore_instances, canonicalFile_fn).call(this);
+    return serializePendingWrite(file, async () => {
+      let currentFile;
+      try {
+        currentFile = join2(await realpath(dirname2(file)), basename(file));
+      } catch (error) {
+        throw storageError("STORAGE_ERROR", "Resolving the open pending-write partition", error);
+      }
+      if (currentFile !== file) {
+        throw new ReplicaStorageError(
+          "STORAGE_ERROR",
+          `The pending-write partition changed while open: ${dirname2(file)}.`
+        );
+      }
+      return __privateGet(this, _guard).call(this, async () => {
+        const state = await this.read();
+        const result = mutate(state);
+        await writeJsonAtomic(file, state, __privateGet(this, _dirSync));
+        return result;
+      });
+    });
+  }
+};
+_dir = new WeakMap();
+_guard = new WeakMap();
+_dirSync = new WeakMap();
+_file = new WeakMap();
+_FilePendingWriteStore_instances = new WeakSet();
+canonicalFile_fn = async function() {
+  __privateGet(this, _file) ?? __privateSet(this, _file, (async () => {
+    await ensurePartitionIdentity(__privateGet(this, _dir), this.identity, __privateGet(this, _dirSync));
+    const file = join2(__privateGet(this, _dir), "pending.json");
+    try {
+      return join2(await realpath(dirname2(file)), basename(file));
+    } catch (error) {
+      throw storageError("STORAGE_ERROR", `Resolving ${file}`, error);
+    }
+  })());
+  return __privateGet(this, _file);
+};
+async function loadOrCreateDevice(idDir, guard, createDevice, dirSync) {
+  return guard(async () => {
+    try {
+      await mkdir(idDir, { recursive: true, mode: 448 });
+      await chmod(idDir, 448);
+    } catch (error) {
+      throw storageError("STORAGE_ERROR", `Creating ${idDir}`, error);
+    }
+    const file = join2(idDir, "device.jwk");
+    const existing = await readJsonFile(file);
+    if (existing !== void 0) {
+      const device2 = deviceRecordOf(existing);
+      if (device2 === void 0) {
+        throw new ReplicaStorageError(
+          "STORAGE_ERROR",
+          `The replica device key at ${file} is unreadable; remove the partition or restore it.`
+        );
+      }
+      return device2;
+    }
+    const device = await createDevice();
+    await writeJsonAtomic(file, { did: device.did, jwk: device.jwk }, dirSync);
+    return device;
+  });
+}
+async function createDeviceKey() {
+  const wasm = await import("@tinycloud/node-sdk-wasm");
+  const manager = new wasm.TCWSessionManager();
+  const keyId = manager.createSessionKey("replica-device") ?? "replica-device";
+  const jwkText = manager.jwk(keyId);
+  if (jwkText === null || jwkText === void 0) {
+    throw new ReplicaStorageError(
+      "STORAGE_ERROR",
+      "The session manager returned no JWK for the replica device key."
+    );
+  }
+  return { did: manager.getDID(keyId), jwk: JSON.parse(jwkText) };
+}
+var SYNC_LEASE_TTL_MS = 12e4;
+var FENCE_FILE = "fence.json";
+async function readFence(replicaDir) {
+  const fence = await readJsonFile(join2(replicaDir, FENCE_FILE));
+  return typeof fence === "object" && fence !== null && "syncedThroughEpoch" in fence && typeof fence.syncedThroughEpoch === "number" ? fence.syncedThroughEpoch : 0;
+}
+function newestGrantInfo(replica, record, pending, spec) {
+  if (record === null) return null;
+  const parsed = replica.parseUcanGrant(record.bytes);
+  return {
+    cid: record.cid,
+    parentCid: parsed.prf[0] ?? null,
+    expiresAt: record.expiresAt === null ? null : record.expiresAt * 1e3,
+    state: pending !== null && record === pending ? "pending" : "active",
+    unconstrained: ucanAttUnconstrainedFor(parsed.att, spec.space, spec.prefix)
+  };
+}
+var _device, _store, _replicaDir, _replica, _guard2, _dirSync2, _generation, _ino, _transportOverride, _closed, _inFlight, _transportFactory, _SqliteReplicaHandle_instances, assertOpen_fn, assertLive_fn, transports_fn;
+var SqliteReplicaHandle = class {
+  constructor(input) {
+    __privateAdd(this, _SqliteReplicaHandle_instances);
+    __privateAdd(this, _device);
+    __privateAdd(this, _store);
+    __privateAdd(this, _replicaDir);
+    __privateAdd(this, _replica);
+    __privateAdd(this, _guard2);
+    __privateAdd(this, _dirSync2);
+    /** The replica row generation this handle opened under — the durable fence a purge commits past (browser-parity wipe). */
+    __privateAdd(this, _generation);
+    /** The inode of `replica.db` at open — a directory recreated in place is a different replica. */
+    __privateAdd(this, _ino);
+    __privateAdd(this, _transportOverride);
+    __privateAdd(this, _closed, false);
+    __privateAdd(this, _inFlight, /* @__PURE__ */ new Set());
+    __privateAdd(this, _transportFactory);
+    this.spec = input.spec;
+    __privateSet(this, _device, input.device);
+    this.deviceDid = input.device.did;
+    __privateSet(this, _store, input.store);
+    __privateSet(this, _replicaDir, input.replicaDir);
+    __privateSet(this, _replica, input.replica);
+    __privateSet(this, _guard2, input.guard);
+    __privateSet(this, _transportOverride, input.transportFor);
+    __privateSet(this, _dirSync2, input.dirSync);
+    __privateSet(this, _generation, input.generation);
+    __privateSet(this, _ino, input.ino);
+  }
+  async get(key2) {
+    await __privateMethod(this, _SqliteReplicaHandle_instances, assertLive_fn).call(this);
+    const result = await new (__privateGet(this, _replica)).Replica({ store: __privateGet(this, _store) }).get(key2);
+    const meta = {
+      asOf: result.meta.asOf,
+      coverage: result.meta.coverage,
+      authority: result.meta.authority,
+      syncedThroughEpoch: await readFence(__privateGet(this, _replicaDir))
+    };
+    switch (result.status) {
+      case "present":
+        return {
+          status: "present",
+          key: result.key,
+          value: result.value,
+          etag: result.etag,
+          metadata: result.metadata,
+          meta
+        };
+      case "content_missing":
+        return {
+          status: "content_missing",
+          key: result.key,
+          etag: result.etag,
+          metadata: result.metadata,
+          meta
+        };
+      default:
+        return { status: result.status, key: result.key, meta };
+    }
+  }
+  async list(options) {
+    await __privateMethod(this, _SqliteReplicaHandle_instances, assertLive_fn).call(this);
+    const result = await new (__privateGet(this, _replica)).Replica({ store: __privateGet(this, _store) }).list({
+      prefix: options.prefix,
+      ...options.after === void 0 ? {} : { after: options.after },
+      ...options.limit === void 0 ? {} : { limit: options.limit }
+    });
+    return {
+      keys: result.entries.map((entry) => entry.key),
+      meta: {
+        asOf: result.meta.asOf,
+        coverage: result.meta.coverage,
+        authority: result.meta.authority,
+        syncedThroughEpoch: await readFence(__privateGet(this, _replicaDir))
+      }
+    };
+  }
+  /**
+   * The newest installed grant — the pending one when a not-yet-promoted
+   * install exists — with `parentCid` = signed `prf[0]` and `unconstrained`
+   * computed from the signed `att` (replica's own grantCovers ignores
+   * caveats, so the adapter computes it, §2.1). A constrained installed
+   * grant is still reported (unconstrained: false) and never reused.
+   */
+  async grant() {
+    await __privateMethod(this, _SqliteReplicaHandle_instances, assertLive_fn).call(this);
+    const state = await __privateGet(this, _store).open();
+    if (state === null) return null;
+    return newestGrantInfo(
+      __privateGet(this, _replica),
+      state.pendingGrant ?? state.grant,
+      state.pendingGrant,
+      this.spec
+    );
+  }
+  async installGrant(ucan) {
+    await __privateMethod(this, _SqliteReplicaHandle_instances, assertLive_fn).call(this);
+    const parsed = __privateGet(this, _replica).parseUcanGrant(ucan);
+    const state = await __privateGet(this, _store).open();
+    if (state === null) {
+      throw new (__privateGet(this, _replica)).ReplicaError(
+        __privateGet(this, _replica).ReplicaErrorCode.NOT_FOUND,
+        "The replica has not been created."
+      );
+    }
+    __privateGet(this, _replica).assertGrantInstallable(parsed, {
+      deviceDid: principalOf(__privateGet(this, _device).did),
+      space: this.spec.space,
+      prefix: this.spec.prefix,
+      now: Date.now()
+    });
+    if (!ucanAttUnconstrainedFor(parsed.att, this.spec.space, this.spec.prefix)) {
+      throw new (__privateGet(this, _replica)).ReplicaError(
+        __privateGet(this, _replica).ReplicaErrorCode.GRANT_NOT_COVERING,
+        "The grant's get or sync coverage carries caveats; re-mint instead of installing it."
+      );
+    }
+    await __privateGet(this, _store).installGrant(parsed);
+    return newestGrantInfo(__privateGet(this, _replica), parsed, parsed, this.spec);
+  }
+  async sync(options) {
+    await __privateMethod(this, _SqliteReplicaHandle_instances, assertLive_fn).call(this);
+    const transportFor = await __privateMethod(this, _SqliteReplicaHandle_instances, transports_fn).call(this);
+    const abort = new AbortController();
+    options.signal.throwIfAborted();
+    const onAbort = () => abort.abort(options.signal.reason);
+    options.signal.addEventListener("abort", onAbort, { once: true });
+    const engine = new (__privateGet(this, _replica)).Replica({
+      store: __privateGet(this, _store),
+      transportFor
+    });
+    const running = engine.sync({ signal: abort.signal });
+    const registration = { promise: running, abort: () => abort.abort() };
+    __privateGet(this, _inFlight).add(registration);
+    try {
+      const report = await running;
+      await __privateGet(this, _guard2).call(this, () => writeJsonAtomic(
+        join2(__privateGet(this, _replicaDir), FENCE_FILE),
+        { v: 1, syncedThroughEpoch: options.syncStartEpoch },
+        __privateGet(this, _dirSync2)
+      ));
+      return {
+        status: "synced",
+        pages: report.pages,
+        changes: report.changes,
+        deleted: report.deleted,
+        fetched: report.fetched,
+        contentMissing: report.contentMissing,
+        coverage: report.coverage,
+        syncedThroughEpoch: options.syncStartEpoch
+      };
+    } catch (error) {
+      if (__privateGet(this, _replica).isReplicaError(error, __privateGet(this, _replica).ReplicaErrorCode.BUSY)) {
+        return { status: "busy" };
+      }
+      throw error;
+    } finally {
+      __privateGet(this, _inFlight).delete(registration);
+      options.signal.removeEventListener("abort", onAbort);
+    }
+  }
+  async status() {
+    await __privateMethod(this, _SqliteReplicaHandle_instances, assertLive_fn).call(this);
+    const engine = new (__privateGet(this, _replica)).Replica({ store: __privateGet(this, _store) });
+    const status = await engine.status();
+    const syncedThroughEpoch = await readFence(__privateGet(this, _replicaDir));
+    const state = await __privateGet(this, _store).open();
+    const grant = state === null ? null : newestGrantInfo(
+      __privateGet(this, _replica),
+      state.pendingGrant ?? state.grant,
+      state.pendingGrant,
+      this.spec
+    );
+    return {
+      coverage: status.coverage,
+      lastSyncAt: status.lastSyncAt,
+      syncedThroughEpoch,
+      authority: { state: status.authority.state, expiresAt: status.authority.expiresAt },
+      grant,
+      counts: status.counts,
+      bytes: status.bytes,
+      lastError: status.lastError
+    };
+  }
+  async close() {
+    if (__privateGet(this, _closed)) return;
+    __privateSet(this, _closed, true);
+    for (const sync of __privateGet(this, _inFlight)) sync.abort();
+    await Promise.allSettled([...__privateGet(this, _inFlight)].map((sync) => sync.promise));
+    await __privateGet(this, _store).close();
+  }
+};
+_device = new WeakMap();
+_store = new WeakMap();
+_replicaDir = new WeakMap();
+_replica = new WeakMap();
+_guard2 = new WeakMap();
+_dirSync2 = new WeakMap();
+_generation = new WeakMap();
+_ino = new WeakMap();
+_transportOverride = new WeakMap();
+_closed = new WeakMap();
+_inFlight = new WeakMap();
+_transportFactory = new WeakMap();
+_SqliteReplicaHandle_instances = new WeakSet();
+assertOpen_fn = function() {
+  if (__privateGet(this, _closed)) {
+    throw new (__privateGet(this, _replica)).ReplicaError(
+      __privateGet(this, _replica).ReplicaErrorCode.CLOSED,
+      "The replica handle is closed."
+    );
+  }
+};
+assertLive_fn = async function() {
+  __privateMethod(this, _SqliteReplicaHandle_instances, assertOpen_fn).call(this);
+  try {
+    const stats = await stat(join2(__privateGet(this, _replicaDir), "replica.db"));
+    if (__privateGet(this, _ino) !== void 0 && stats.ino !== __privateGet(this, _ino)) {
+      throw new (__privateGet(this, _replica)).ReplicaError(
+        __privateGet(this, _replica).ReplicaErrorCode.RESET_REQUIRED,
+        "The replica was recreated; open it again to continue."
+      );
+    }
+  } catch (error) {
+    if (isNotFound(error)) {
+      throw new (__privateGet(this, _replica)).ReplicaError(
+        __privateGet(this, _replica).ReplicaErrorCode.RESET_REQUIRED,
+        "The replica was purged; open it again to continue."
+      );
+    }
+    throw error;
+  }
+  const state = await __privateGet(this, _store).open();
+  if (state !== null && state.generation !== __privateGet(this, _generation)) {
+    throw new (__privateGet(this, _replica)).ReplicaError(
+      __privateGet(this, _replica).ReplicaErrorCode.RESET_REQUIRED,
+      "The replica was purged or reopened; open it again to continue."
+    );
+  }
+};
+transports_fn = async function() {
+  if (__privateGet(this, _transportOverride) !== void 0) {
+    const override = __privateGet(this, _transportOverride);
+    const spec = this.spec;
+    const device = __privateGet(this, _device);
+    return (grant) => override(grant, spec, device);
+  }
+  __privateGet(this, _transportFactory) ?? __privateSet(this, _transportFactory, (async () => {
+    const wasm = await import("@tinycloud/node-sdk-wasm");
+    const kvSyncTransport = __privateGet(this, _replica).kvSyncTransport;
+    const spec = this.spec;
+    const device = __privateGet(this, _device);
+    const fetch2 = spec.fetch ?? globalThis.fetch.bind(globalThis);
+    return (grant) => {
+      const context = new ServiceContext3({
+        invoke: wasm.invoke,
+        invokeAny: wasm.invokeAny,
+        fetch: fetch2,
+        hosts: [spec.identity.host]
+      });
+      const kv = new KVService3({});
+      kv.initialize(context);
+      context.registerService("kv", kv);
+      context.setSession({
+        delegationHeader: { Authorization: new TextDecoder().decode(grant.bytes) },
+        delegationCid: grant.cid,
+        spaceId: spec.space,
+        verificationMethod: device.did,
+        jwk: device.jwk
+      });
+      return kvSyncTransport(kv);
+    };
+  })());
+  return __privateGet(this, _transportFactory);
+};
+function createSqliteReplicaStorage(options) {
+  const root = options.dir;
+  const guard = options.guard ?? ((section) => section());
+  const createDevice = options.createDevice ?? createDeviceKey;
+  async function openHandle(spec) {
+    const [replica, sqlite] = await Promise.all([
+      // @ts-ignore — TS2307 when replica's dist is absent (CI builds node-sdk first).
+      import("@tinycloud/replica"),
+      // @ts-ignore — same as above.
+      import("@tinycloud/replica/sqlite")
+    ]);
+    if (requiresSecretsOptIn2(spec.space, spec.prefix) && spec.allowSecrets !== true) {
+      throw new replica.ReplicaError(
+        replica.ReplicaErrorCode.SECRETS_OPT_IN_REQUIRED,
+        `Replicating ${spec.space}/kv/${spec.prefix} copies secret material to disk; pass allowSecrets to opt in.`
+      );
+    }
+    const idDir = partitionDirOf(root, spec.identity);
+    await ensurePartitionIdentity(idDir, spec.identity, options.dirSync);
+    const createdDevice = spec.device ?? await loadOrCreateDevice(idDir, guard, createDevice, options.dirSync);
+    const device = { ...createdDevice, did: principalOf(createdDevice.did) };
+    const replicaHash = replicaHashOf(spec.prefix, device.did);
+    const replicaDir = join2(idDir, "replicas", replicaHash);
+    const store = await sqlite.SqliteReplicaStore.open(replicaDir, {
+      create: true,
+      guard
+    });
+    let generation;
+    try {
+      try {
+        await store.init({
+          name: spec.prefix.replace(/\/+$/, "") || "replica",
+          replicaId: replicaHash,
+          host: spec.identity.host,
+          space: spec.space,
+          prefix: spec.prefix,
+          deviceDid: device.did,
+          allowSecrets: spec.allowSecrets,
+          localReadPolicy: "whileGrantValid",
+          retentionGrantCid: null
+        });
+      } catch (error) {
+        if (!replica.isReplicaError(error, replica.ReplicaErrorCode.CONFIG_MISMATCH)) {
+          throw error;
+        }
+      }
+      const state = await store.open();
+      if (state === null) {
+        throw new replica.ReplicaError(
+          replica.ReplicaErrorCode.NOT_FOUND,
+          "The replica row vanished during init."
+        );
+      }
+      const config = state.config;
+      if (config.host !== spec.identity.host || config.space !== spec.space || config.prefix !== spec.prefix) {
+        throw new replica.ReplicaError(
+          replica.ReplicaErrorCode.CONFIG_MISMATCH,
+          `This replica follows ${config.host} ${config.space}/kv/${config.prefix}, not ${spec.identity.host} ${spec.space}/kv/${spec.prefix}.`
+        );
+      }
+      if (principalOf(config.deviceDid) !== principalOf(device.did)) {
+        throw new replica.ReplicaError(
+          replica.ReplicaErrorCode.CONFIG_MISMATCH,
+          "The stored replica belongs to a different device key; purge the partition to rekey."
+        );
+      }
+      generation = state.generation;
+    } catch (error) {
+      await store.close().catch(() => void 0);
+      throw error;
+    }
+    let ino;
+    try {
+      ino = (await stat(join2(replicaDir, "replica.db"))).ino;
+    } catch (error) {
+      if (!isNotFound(error)) throw error;
+    }
+    return new SqliteReplicaHandle({
+      spec,
+      device,
+      store,
+      replicaDir,
+      replica,
+      guard,
+      transportFor: options.transportFor,
+      dirSync: options.dirSync,
+      generation,
+      ino
+    });
+  }
+  async function inspectStatus(spec, { signal }) {
+    const checkAbort = () => {
+      if (signal.aborted) throw signal.reason ?? Object.assign(new Error("Replica status inspection was aborted"), { code: "ABORTED" });
+    };
+    checkAbort();
+    const idDir = partitionDirOf(root, spec.identity);
+    if (!await pathExists(idDir)) return void 0;
+    checkAbort();
+    const identityFile = join2(idDir, "identity.json");
+    const storedIdentity = identityRecordOf(await readJsonFile(identityFile));
+    if (storedIdentity === void 0 || !sameIdentity(storedIdentity, spec.identity)) {
+      throw new ReplicaStorageError("STORAGE_ERROR", `The partition at ${idDir} belongs to a different identity or has no identity record.`);
+    }
+    checkAbort();
+    let device = spec.device;
+    if (device === void 0) {
+      const deviceFile = join2(idDir, "device.jwk");
+      const storedDevice = await readJsonFile(deviceFile);
+      if (storedDevice === void 0) return void 0;
+      device = deviceRecordOf(storedDevice);
+      if (device === void 0) throw new ReplicaStorageError("STORAGE_ERROR", `The replica device key at ${deviceFile} is unreadable.`);
+    }
+    checkAbort();
+    const replicaDir = join2(idDir, "replicas", replicaHashOf(spec.prefix, device.did));
+    if (!await pathExists(replicaDir)) return void 0;
+    checkAbort();
+    const [replica, sqlite] = await Promise.all([
+      // @ts-ignore — TS2307 when replica's dist is absent (CI builds node-sdk first).
+      import("@tinycloud/replica"),
+      // @ts-ignore — same as above.
+      import("@tinycloud/replica/sqlite")
+    ]);
+    checkAbort();
+    const inspected = await sqlite.SqliteReplicaStore.inspect(replicaDir, { signal });
+    checkAbort();
+    if (inspected === null) return void 0;
+    const { state, status } = inspected;
+    if (state.config.host !== spec.identity.host || state.config.space !== spec.space || state.config.prefix !== spec.prefix || principalOf(state.config.deviceDid) !== principalOf(device.did)) {
+      throw new ReplicaStorageError("STORAGE_ERROR", `The replica at ${replicaDir} does not match the requested identity, space, prefix, or device.`);
+    }
+    const syncedThroughEpoch = await readFence(replicaDir);
+    checkAbort();
+    return {
+      coverage: status.coverage,
+      lastSyncAt: status.lastSyncAt,
+      syncedThroughEpoch,
+      authority: { state: status.authority.state, expiresAt: status.authority.expiresAt },
+      grant: newestGrantInfo(replica, state.pendingGrant ?? state.grant, state.pendingGrant, spec),
+      counts: status.counts,
+      bytes: status.bytes,
+      lastError: status.lastError
+    };
+  }
+  async function purgePartition(target) {
+    const [replica, sqlite] = await Promise.all([
+      // @ts-ignore — TS2307 when replica's dist is absent (CI builds node-sdk first).
+      import("@tinycloud/replica"),
+      // @ts-ignore — same as above.
+      import("@tinycloud/replica/sqlite")
+    ]);
+    const idDir = partitionDirOf(root, target.identity);
+    if (!await pathExists(idDir)) return;
+    const deviceDids = [];
+    const deviceFile = join2(idDir, "device.jwk");
+    const stored = await readJsonFile(deviceFile);
+    if (stored !== void 0) {
+      const device = deviceRecordOf(stored);
+      if (device === void 0) {
+        throw new ReplicaStorageError(
+          "STORAGE_ERROR",
+          `The replica device key at ${deviceFile} is unreadable.`
+        );
+      }
+      deviceDids.push(device.did);
+    }
+    if (target.sessionDeviceDid !== void 0) deviceDids.push(target.sessionDeviceDid);
+    const devices = [...new Map(deviceDids.map((did) => [principalOf(did), did])).values()];
+    let firstError;
+    for (const deviceDid of devices) {
+      const replicaDir = join2(idDir, "replicas", replicaHashOf(target.prefix, deviceDid));
+      if (!await pathExists(replicaDir)) continue;
+      try {
+        let store;
+        try {
+          store = await sqlite.SqliteReplicaStore.open(replicaDir, { create: false, guard });
+        } catch (error) {
+          if (replica.isReplicaError(error, replica.ReplicaErrorCode.NOT_FOUND)) {
+            await guard(() => rm(replicaDir, { recursive: true, force: true }));
+            continue;
+          }
+          throw error;
+        }
+        try {
+          const state = await store.open();
+          if (state === null) {
+            await store.close().catch(() => void 0);
+            await guard(() => rm(replicaDir, { recursive: true, force: true }));
+            continue;
+          }
+          const lease = await store.acquireSyncLease(SYNC_LEASE_TTL_MS);
+          if (lease === null) {
+            throw new replica.ReplicaError(
+              replica.ReplicaErrorCode.BUSY,
+              "Another process holds this replica's sync lease."
+            );
+          }
+          try {
+            if (state.revoked === null) {
+              await store.reset(lease, "purged");
+            }
+            await store.destroy(lease);
+          } finally {
+            await store.releaseLease(lease).catch(() => void 0);
+          }
+        } finally {
+          await store.close().catch(() => void 0);
+        }
+      } catch (error) {
+        firstError ?? (firstError = error);
+      }
+    }
+    if (firstError !== void 0) throw firstError;
+  }
+  return {
+    kind: "sqlite",
+    open: openHandle,
+    inspectStatus,
+    purge: purgePartition,
+    // Always the durable partitioned file store (review): the runtime
+    // must never fall back to volatile in-memory pending state — a
+    // restart that lost ambiguous write records would serve stale data.
+    // Without a guard the file store still durably serializes each update;
+    // the guard only adds cross-process read-modify-write exclusion.
+    pendingWrites(identity) {
+      return new FilePendingWriteStore(
+        identity,
+        partitionDirOf(root, identity),
+        guard,
+        options.dirSync
+      );
+    }
+  };
+}
+function sqliteReplicaStorage(options) {
+  return createSqliteReplicaStorage(options);
+}
 export {
   ACCEPTED_MARKER_VERSIONS,
   ACCOUNT_REGISTRY_PATH,
@@ -25543,7 +27410,7 @@ export {
   HooksService3 as HooksService,
   IdentityParseError,
   InvalidRestoredSessionError,
-  KVService3 as KVService,
+  KVService4 as KVService,
   MAX_SECRET_SCOPE_LENGTH,
   ManifestValidationError,
   MemorySessionStorage,
@@ -25564,7 +27431,7 @@ export {
   STORAGE_FULL_MESSAGE2 as STORAGE_FULL_MESSAGE,
   STORAGE_WRITE_TOO_LARGE_MESSAGE2 as STORAGE_WRITE_TOO_LARGE_MESSAGE,
   SecretsService2 as SecretsService,
-  ServiceContext3 as ServiceContext,
+  ServiceContext4 as ServiceContext,
   SessionExpiredError2 as SessionExpiredError,
   SharingService2 as SharingService,
   SilentNotificationHandler2 as SilentNotificationHandler,
@@ -25637,7 +27504,7 @@ export {
   hexDecode,
   hexEncode,
   installTinyCloudDebugGlobals,
-  isCapabilitySubset2 as isCapabilitySubset,
+  isCapabilitySubset4 as isCapabilitySubset,
   isEvmAddress,
   isNetworkId,
   isStorageFullError2 as isStorageFullError,
@@ -25651,9 +27518,9 @@ export {
   parseNetworkId3 as parseNetworkId,
   parsePkhDid,
   parseSecretCatalogKey,
-  parseSpaceUri,
-  pkhDid3 as pkhDid,
-  principalDid,
+  parseSpaceUri3 as parseSpaceUri,
+  pkhDid4 as pkhDid,
+  principalDid3 as principalDid,
   principalDidEquals4 as principalDidEquals,
   resolveManifest2 as resolveManifest,
   resolveSecretListPrefix2 as resolveSecretListPrefix,
@@ -25661,6 +27528,7 @@ export {
   resourceCapabilitiesToSpaceAbilitiesMap2 as resourceCapabilitiesToSpaceAbilitiesMap,
   serializeDelegation,
   signedCompactUcanExpiry,
+  sqliteReplicaStorage,
   tinyCloudDebugLogger,
   validateEnvelope,
   validateManifest,