@dxos/protocols 0.8.4-staging.ac66bdf99f → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/protocols",
-  "version": "0.8.4-staging.ac66bdf99f",
+  "version": "0.9.0",
   "description": "Protobuf definitions for DXOS protocols.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -8,7 +8,7 @@
     "type": "git",
     "url": "https://github.com/dxos/dxos"
   },
-  "license": "MIT",
+  "license": "FSL-1.1-Apache-2.0",
   "author": "info@dxos.org",
   "sideEffects": false,
   "type": "module",
@@ -25,6 +25,7 @@
       "browser": "./dist/src/proto/index.js",
       "import": "./dist/src/proto/index.js"
     },
+    "./proto/dxos/*.proto": "./src/proto/dxos/*.proto",
     "./proto/*": {
       "browser": "./dist/src/proto/gen/*.js",
       "import": "./dist/src/proto/gen/*.js"
@@ -39,47 +40,27 @@
     }
   },
   "types": "dist/src/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "proto/*": [
-        "dist/src/proto/gen/*"
-      ],
-      "buf/*": [
-        "dist/src/buf/proto/gen/*"
-      ],
-      "feed-replication": [
-        "dist/src/feed-replication.d.ts"
-      ],
-      "buf": [
-        "dist/src/buf/index.d.ts"
-      ],
-      "proto": [
-        "dist/src/proto/index.d.ts"
-      ]
-    }
-  },
   "files": [
     "dist",
     "src"
   ],
   "dependencies": {
     "@bufbuild/protobuf": "2.11.0",
-    "@dxos/effect": "0.8.4-staging.ac66bdf99f",
-    "@dxos/errors": "0.8.4-staging.ac66bdf99f",
-    "@dxos/codec-protobuf": "0.8.4-staging.ac66bdf99f",
-    "@dxos/keys": "0.8.4-staging.ac66bdf99f",
-    "@dxos/invariant": "0.8.4-staging.ac66bdf99f",
-    "@dxos/timeframe": "0.8.4-staging.ac66bdf99f",
-    "@dxos/util": "0.8.4-staging.ac66bdf99f"
+    "@dxos/codec-protobuf": "0.9.0",
+    "@dxos/effect": "0.9.0",
+    "@dxos/errors": "0.9.0",
+    "@dxos/invariant": "0.9.0",
+    "@dxos/keys": "0.9.0",
+    "@dxos/timeframe": "0.9.0"
   },
   "devDependencies": {
     "@bufbuild/buf": "1.65.0",
     "@bufbuild/protoc-gen-es": "2.11.0",
-    "effect": "3.20.0",
-    "@dxos/protobuf-compiler": "0.8.4-staging.ac66bdf99f"
+    "effect": "3.21.3",
+    "@dxos/protobuf-compiler": "0.9.0"
   },
   "peerDependencies": {
-    "effect": "3.20.0"
+    "effect": "3.21.3"
   },
   "publishConfig": {
     "access": "public"

package/src/FeedProtocol.ts

@@ -10,6 +10,9 @@ export {
   type InsertIntoQueueRequest,
   type DeleteFromQueueRequest,
   type SyncQueueRequest,
+  type GetSyncStateRequest,
+  type GetSyncStateResponse,
+  type QueueNamespaceSyncState,
 } from './proto/gen/dxos/client/services.js';
 
 export const KEY_QUEUE_POSITION = 'org.dxos.key.queue-position';

package/src/FunctionProtocol.ts

@@ -8,6 +8,7 @@ import type * as DataProto from '@dxos/protocols/proto/dxos/echo/service';
 
 import { type EdgeFunctionEnv } from './edge';
 import type * as FeedProtocol from './FeedProtocol';
+import type * as TraceProtocol from './TraceProtocol';
 
 //
 // Function protocol definition
@@ -82,6 +83,14 @@ export interface Context {
      * Available if the function is invoked in context of a space.
      */
     functionsAiService?: EdgeFunctionEnv.FunctionsAiService;
+
+    /**
+     * Functions service.
+     * Available if the function is invoked in context of a space.
+     */
+    functionsService?: EdgeFunctionEnv.FunctionsService;
+
+    traceService?: TraceProtocol.TraceService;
   };
 
   /**

package/src/TraceProtocol.ts

@@ -0,0 +1,21 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+// @import-as-namespace
+
+/**
+ * Allows consumers to write trace events to the trace.
+ */
+export interface TraceService {
+  write(events: Event[]): void;
+}
+
+/**
+ * Single typed trace event.
+ */
+export interface Event {
+  key: string;
+  isEphemeral: boolean;
+  data: unknown;
+}

package/src/automerge.ts

@@ -2,8 +2,30 @@
 // Copyright 2024 DXOS.org
 //
 
+/**
+ * Opaque identifier of a peer participating in automerge-repo sync.
+ *
+ * Branded `string` so it cannot be accidentally confused with arbitrary
+ * strings. Matches the `PeerId` type exported by `@automerge/automerge-repo`.
+ */
 export type PeerId = string & { __peerId: true };
 
+// ─── Classical automerge-repo sync protocol ───────────────────────────────────
+// These types mirror upstream `@automerge/automerge-repo` `Message` variants
+// (see `automerge-repo/src/network/messages.ts`). They are the wire protocol
+// of the classical automerge-repo sync state machine, not DXOS extensions.
+// Carried by `EchoEdgeReplicator` (classical edge wiring) and in-memory test
+// adapters; NOT used on the subduction channel except via the
+// `SubductionConnectionMessage` byte tunnel.
+
+/**
+ * Sent by a peer when joining a connection.
+ *
+ * @remarks
+ * Upstream automerge-repo: first frame after `peer-candidate` to negotiate
+ * supported protocol versions. The other side responds with a
+ * {@link PeerProtocolMessage} containing the selected version.
+ */
 export type JoinProtocolMessage = {
   type: 'join';
   targetId?: PeerId;
@@ -12,6 +34,13 @@ export type JoinProtocolMessage = {
   metadata?: Record<string, unknown>;
 };
 
+/**
+ * Sent by a peer when leaving a connection.
+ *
+ * @remarks
+ * Upstream automerge-repo: signals graceful disconnect so the remote tears
+ * down its sync state for this peer before the underlying transport closes.
+ */
 export type LeaveProtocolMessage = {
   type: 'leave';
   targetId?: PeerId;
@@ -19,6 +48,13 @@ export type LeaveProtocolMessage = {
   metadata?: Record<string, unknown>;
 };
 
+/**
+ * Sent in response to a {@link JoinProtocolMessage} confirming the handshake
+ * and the selected protocol version.
+ *
+ * @remarks
+ * Upstream automerge-repo: completes the version negotiation handshake.
+ */
 export type PeerProtocolMessage = {
   type: 'peer';
   senderId: PeerId;
@@ -31,8 +67,10 @@ export type PeerProtocolMessage = {
  * Sent by a {@link Repo} to request a document from a peer.
  *
  * @remarks
- * This is identical to a {@link SyncMessage} except that it is sent by a {@link Repo}
- * as the initial sync message when asking the other peer if it has the document.
+ * Upstream automerge-repo: identical wire shape to {@link SyncProtocolMessage}
+ * except this is the initial sync message used when asking the other peer if
+ * it has the document. The peer replies with sync messages or
+ * {@link UnavailableProtocolMessage}.
  */
 export type RequestProtocolMessage = {
   type: 'request';
@@ -44,7 +82,12 @@ export type RequestProtocolMessage = {
 };
 
 /**
- * A sync message for a particular document
+ * Automerge sync message for a particular document.
+ *
+ * @remarks
+ * Upstream automerge-repo: carries the binary delta produced by Automerge's
+ * sync algorithm (`Automerge.generateSyncMessage`). Symmetric: peers exchange
+ * sync messages until both sides have converged.
  */
 export type SyncProtocolMessage = {
   type: 'sync';
@@ -56,8 +99,12 @@ export type SyncProtocolMessage = {
 };
 
 /**
- * Sent by a {@link Repo} to indicate that it does not have the document and none of its connected
- * peers do either.
+ * Sent by a {@link Repo} to indicate that it does not have the document and
+ * none of its connected peers do either.
+ *
+ * @remarks
+ * Upstream automerge-repo: terminates a {@link RequestProtocolMessage} fan-out
+ * when no peer in the cluster can serve the document.
  */
 export type UnavailableProtocolMessage = {
   type: 'doc-unavailable';
@@ -68,16 +115,17 @@ export type UnavailableProtocolMessage = {
 };
 
 /**
- * An ephemeral message.
+ * An ephemeral message gossiped between peers.
  *
  * @remarks
- * Ephemeral messages are not persisted anywhere. The data property can be used by the application
- * as needed. The repo gossips these around.
+ * Upstream automerge-repo: ephemeral messages are not persisted anywhere.
+ * The `data` property can be used by the application as needed. The repo
+ * gossips these around.
  *
- * In order to avoid infinite loops of ephemeral messages, every message has (a) a session ID, which
- * is a random number generated by the sender at startup time; and (b) a sequence number. The
- * combination of these two things allows us to discard messages we have already seen.
- * */
+ * To avoid infinite loops, every message carries (a) a `sessionId` randomly
+ * generated by the sender at startup time and (b) a sequence number
+ * (`count`). The pair lets receivers discard messages they have already seen.
+ */
 export type EphemeralProtocolMessage = {
   type: 'ephemeral';
   senderId: PeerId;
@@ -89,16 +137,114 @@ export type EphemeralProtocolMessage = {
   metadata?: Record<string, unknown>;
 };
 
+/** Wire literal for {@link ErrorProtocolMessage}. */
+export const MESSAGE_TYPE_ERROR = 'error';
+
+/**
+ * Out-of-band error reported by a peer.
+ *
+ * @remarks
+ * Upstream automerge-repo: surfaces protocol-level failures (e.g. version
+ * mismatch, malformed frame). `senderId` and `targetId` are optional so the
+ * frame can be emitted before the handshake completes.
+ *
+ * The `connectionId` field is a DXOS extension carried on the subduction
+ * channel only. Edge → client errors with `connectionId` are restart signals
+ * for a specific {@link EdgeSubductionReplicatorConnection} lifetime; the
+ * client matches it against its local `_connectionId` and tears down only
+ * that connection. The field is optional so the same type can carry
+ * upstream-style classical-channel errors that have no connection identity.
+ */
 export type ErrorProtocolMessage = {
-  type: 'error';
+  type: typeof MESSAGE_TYPE_ERROR;
   senderId?: PeerId;
   targetId?: PeerId;
   message: string;
+  connectionId?: string;
+  metadata?: Record<string, unknown>;
+};
+
+// ─── Subduction transport / control protocol ──────────────────────────────────
+// Frames produced and consumed by `@automerge/automerge-repo`'s subduction
+// transport bridge (`NetworkAdapterTransport`) plus the DXOS-side envelope
+// and reconnect marker. Carried by the Edge subduction channel
+// (`EdgeService.SUBDUCTION_REPLICATOR`) and the in-memory subduction adapter.
+
+/** Wire literal for {@link SubductionConnectionMessage}. */
+export const MESSAGE_TYPE_SUBDUCTION_CONNECTION = 'subduction-connection';
+
+/** Wire literal for {@link SubductionFrameEnvelope}. */
+export const MESSAGE_TYPE_SUBDUCTION_FRAME = 'subduction-frame';
+
+/**
+ * Inner subduction transport frame emitted by automerge-repo's
+ * `NetworkAdapterTransport.#sendFrame`.
+ *
+ * @remarks
+ * Owned by upstream `@automerge/automerge-subduction`: `data` is an opaque
+ * byte blob (handshake bytes prefixed with `SUH\0`, or post-handshake
+ * sedimentree messages prefixed with `SUM\0`); DXOS code MUST NOT inspect
+ * `data`.
+ *
+ * The literal value `'subduction-connection'` matches the
+ * `SUBDUCTION_MESSAGE_TYPE` constant in
+ * `@automerge/automerge-repo/src/subduction/network.ts`. Do not redefine the
+ * value; if upstream renames it, update {@link MESSAGE_TYPE_SUBDUCTION_CONNECTION}.
+ *
+ * On the Edge subduction channel this frame never appears top-level — it is
+ * always wrapped in a {@link SubductionFrameEnvelope}. In-memory subduction
+ * adapters carry it directly.
+ */
+export type SubductionConnectionMessage = {
+  type: typeof MESSAGE_TYPE_SUBDUCTION_CONNECTION;
+  senderId: PeerId;
+  targetId: PeerId;
+  data: Uint8Array;
   metadata?: Record<string, unknown>;
 };
 
+/**
+ * DXOS-specific wire envelope around a {@link SubductionConnectionMessage}.
+ *
+ * @remarks
+ * Specific to the DXOS edge subduction channel; not used by upstream
+ * automerge-repo or in-memory subduction adapters.
+ *
+ * Carries the originator's `connectionId` (the value of
+ * `EdgeSubductionReplicatorConnection._connectionId` on the client, and of
+ * the matching `ClientSession` on the edge). The edge uses `connectionId` as
+ * the session key and echoes it back on every outbound reply.
+ *
+ * Frames whose `connectionId` does not match the local connection's UUID are
+ * stale (e.g. left over from a previous lifetime after
+ * `_onRestartRequested` rotated the UUID) and MUST be dropped on receipt.
+ */
+export type SubductionFrameEnvelope = {
+  type: typeof MESSAGE_TYPE_SUBDUCTION_FRAME;
+  connectionId: string;
+  subductionFrame: SubductionConnectionMessage;
+};
+
+// ─── DXOS collection sync protocol ────────────────────────────────────────────
+// DXOS extension on top of the automerge-repo Message type, used by
+// `CollectionSynchronizer` to negotiate per-collection sync state. Carried
+// by both the classical and subduction channels.
+
+/** Wire literal for {@link CollectionQueryMessage}. */
 export const MESSAGE_TYPE_COLLECTION_QUERY = 'collection-query';
 
+/**
+ * Request the remote peer's view of a collection.
+ *
+ * @remarks
+ * DXOS-specific. Sent by `CollectionSynchronizer` to ask a peer for the set
+ * of document heads it has for a given `collectionId`. The peer replies with
+ * a {@link CollectionStateMessage}.
+ *
+ * If the requester already has a `stateTag` from a previous reply, the peer
+ * MAY skip sending the state when its current tag matches (no change since
+ * the last query).
+ */
 export type CollectionQueryMessage = {
   type: typeof MESSAGE_TYPE_COLLECTION_QUERY;
   senderId: PeerId;
@@ -113,8 +259,22 @@ export type CollectionQueryMessage = {
   metadata?: Record<string, unknown>;
 };
 
+/** Wire literal for {@link CollectionStateMessage}. */
 export const MESSAGE_TYPE_COLLECTION_STATE = 'collection-state';
 
+/**
+ * Reply to a {@link CollectionQueryMessage} carrying the responder's view of
+ * a collection.
+ *
+ * @remarks
+ * DXOS-specific. The `state` payload shape is implementation-defined — today
+ * it is a `{ documents: Record<DocumentId, Heads[]> }` map produced by the
+ * edge from `Subduction.getAllHeads()`, but the type leaves this open for
+ * alternative encodings.
+ *
+ * `stateTag` lets the requester short-circuit future queries when nothing
+ * has changed (see {@link CollectionQueryMessage.stateTag}).
+ */
 export type CollectionStateMessage = {
   type: typeof MESSAGE_TYPE_COLLECTION_STATE;
   senderId: PeerId;
@@ -133,6 +293,20 @@ export type CollectionStateMessage = {
   metadata?: Record<string, unknown>;
 };
 
+// ─── Channel-level unions ─────────────────────────────────────────────────────
+
+/**
+ * Union of every message that flows through the **classical automerge-repo**
+ * sync channel (`EchoEdgeReplicator`, in-memory `TestAdapter`).
+ *
+ * @remarks
+ * Combines the upstream automerge-repo sync messages (join / leave / peer /
+ * request / sync / doc-unavailable / ephemeral / error) with DXOS's
+ * collection-sync extension (collection-query / collection-state).
+ *
+ * Does NOT include subduction transport frames or the reconnect marker —
+ * those live on a separate channel; see {@link SubductionProtocolMessage}.
+ */
 export type AutomergeProtocolMessage =
   | JoinProtocolMessage
   | PeerProtocolMessage
@@ -144,3 +318,55 @@ export type AutomergeProtocolMessage =
   | ErrorProtocolMessage
   | CollectionQueryMessage
   | CollectionStateMessage;
+
+/**
+ * Union of every message that flows through the subduction channel **in
+ * process** — i.e. between automerge-repo's `NetworkAdapterTransport` and the
+ * DXOS adapter / replicator layer, before wire encoding.
+ *
+ * @remarks
+ * Distinct from {@link AutomergeProtocolMessage}, which describes the classical
+ * automerge-repo sync protocol carried by `EchoEdgeReplicator` (mesh sync,
+ * in-memory test adapters). The subduction channel multiplexes:
+ *
+ *   - opaque transport frames ({@link SubductionConnectionMessage}) produced
+ *     by `@automerge/automerge-repo/subduction/network.ts`;
+ *   - DXOS collection sync messages ({@link CollectionQueryMessage} /
+ *     {@link CollectionStateMessage});
+ *   - edge-initiated restart signals ({@link ErrorProtocolMessage} carrying
+ *     the offending `connectionId`).
+ *
+ * The {@link SubductionFrameEnvelope} is intentionally NOT a member: it only
+ * exists on the wire to attach a `connectionId` to a raw
+ * {@link SubductionConnectionMessage}. See {@link SubductionProtocolMessageEnveloped}
+ * for the corresponding wire union.
+ */
+export type SubductionProtocolMessage =
+  | CollectionQueryMessage
+  | CollectionStateMessage
+  | SubductionConnectionMessage
+  | ErrorProtocolMessage;
+
+/**
+ * Union of every message that flows over the **Edge subduction byte channel
+ * wire** (`EdgeService.SUBDUCTION_REPLICATOR`), i.e. the cbor-encoded payload
+ * of a `RouterMessage` targeting the subduction service.
+ *
+ * @remarks
+ * The wire counterpart of {@link SubductionProtocolMessage} — identical except
+ * that {@link SubductionConnectionMessage} is replaced by
+ * {@link SubductionFrameEnvelope}, which wraps it together with the originator's
+ * `connectionId` so the peer can drop stale frames from previous connection
+ * lifetimes.
+ *
+ * The wrap/unwrap happens at the
+ * {@link EdgeSubductionReplicatorConnection} boundary on the client and the
+ * matching `SubductionTransport` boundary on the edge. Other code paths (the
+ * in-memory `TestAdapter` pair, in-process subduction adapter) carry
+ * {@link SubductionProtocolMessage} directly without ever building an envelope.
+ */
+export type SubductionProtocolMessageEnveloped =
+  | CollectionQueryMessage
+  | CollectionStateMessage
+  | SubductionFrameEnvelope
+  | ErrorProtocolMessage;

package/src/buf/proto/gen/dxos/client/invitation_pb.ts

@@ -30,7 +30,7 @@ import type { Message } from "@bufbuild/protobuf";
  * Describes the file dxos/client/invitation.proto.
  */
 export const file_dxos_client_invitation: GenFile = /*@__PURE__*/
-  fileDesc("ChxkeG9zL2NsaWVudC9pbnZpdGF0aW9uLnByb3RvEhRkeG9zLmNsaWVudC5zZXJ2aWNlcyJ9ChBBZG1pc3Npb25LZXlwYWlyEigKCnB1YmxpY19rZXkYASABKAsyFC5keG9zLmtleXMuUHVibGljS2V5Ei8KC3ByaXZhdGVfa2V5GAIgASgLMhUuZHhvcy5rZXlzLlByaXZhdGVLZXlIAIgBAUIOCgxfcHJpdmF0ZV9rZXkimgoKCkludml0YXRpb24SFQoNaW52aXRhdGlvbl9pZBgBIAEoCRIzCgR0eXBlGAIgASgOMiUuZHhvcy5jbGllbnQuc2VydmljZXMuSW52aXRhdGlvbi5UeXBlEjMKBGtpbmQYAyABKA4yJS5keG9zLmNsaWVudC5zZXJ2aWNlcy5JbnZpdGF0aW9uLktpbmQSQAoLYXV0aF9tZXRob2QYBCABKA4yKy5keG9zLmNsaWVudC5zZXJ2aWNlcy5JbnZpdGF0aW9uLkF1dGhNZXRob2QSJwoJc3dhcm1fa2V5GAUgASgLMhQuZHhvcy5rZXlzLlB1YmxpY0tleRI1CgVzdGF0ZRgGIAEoDjImLmR4b3MuY2xpZW50LnNlcnZpY2VzLkludml0YXRpb24uU3RhdGUSFAoHdGltZW91dBgHIAEoBUgAiAEBEi8KDGlkZW50aXR5X2tleRgIIAEoCzIULmR4b3Mua2V5cy5QdWJsaWNLZXlIAYgBARIsCglzcGFjZV9rZXkYCSABKAsyFC5keG9zLmtleXMuUHVibGljS2V5SAKIAQESFgoJYXV0aF9jb2RlGAogASgJSAOIAQESEwoGdGFyZ2V0GAsgASgJSASIAQESFwoKcGVyc2lzdGVudBgMIAEoCEgFiAEBEjAKB2NyZWF0ZWQYDSABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wSAaIAQESFQoIbGlmZXRpbWUYDiABKAVIB4gBARIWCgltdWx0aV91c2UYDyABKAhICIgBARJCCg1ndWVzdF9rZXlwYWlyGBAgASgLMiYuZHhvcy5jbGllbnQuc2VydmljZXMuQWRtaXNzaW9uS2V5cGFpckgJiAEBEjsKGGRlbGVnYXRpb25fY3JlZGVudGlhbF9pZBgRIAEoCzIULmR4b3Mua2V5cy5QdWJsaWNLZXlICogBARI6CgRyb2xlGBIgASgOMicuZHhvcy5oYWxvLmNyZWRlbnRpYWxzLlNwYWNlTWVtYmVyLlJvbGVIC4gBARIVCghzcGFjZV9pZBgTIAEoCUgMiAEBIjQKBFR5cGUSDwoLSU5URVJBQ1RJVkUQABINCglERUxFR0FURUQQARIMCghNVUxUSVVTRRACIh0KBEtpbmQSCgoGREVWSUNFEAASCQoFU1BBQ0UQASI/CgpBdXRoTWV0aG9kEggKBE5PTkUQABIRCg1TSEFSRURfU0VDUkVUEAESFAoQS05PV05fUFVCTElDX0tFWRACIqMBCgVTdGF0ZRIICgRJTklUEAASDgoKQ09OTkVDVElORxABEg0KCUNPTk5FQ1RFRBACEhwKGFJFQURZX0ZPUl9BVVRIRU5USUNBVElPThADEhIKDkFVVEhFTlRJQ0FUSU5HEAQSCwoHU1VDQ0VTUxAFEg0KCUNBTkNFTExFRBAGEgsKB1RJTUVPVVQQBxIJCgVFUlJPUhAIEgsKB0VYUElSRUQQCUIKCghfdGltZW91dEIPCg1faWRlbnRpdHlfa2V5QgwKCl9zcGFjZV9rZXlCDAoKX2F1dGhfY29kZUIJCgdfdGFyZ2V0Qg0KC19wZXJzaXN0ZW50QgoKCF9jcmVhdGVkQgsKCV9saWZldGltZUIMCgpfbXVsdGlfdXNlQhAKDl9ndWVzdF9rZXlwYWlyQhsKGV9kZWxlZ2F0aW9uX2NyZWRlbnRpYWxfaWRCBwoFX3JvbGVCCwoJX3NwYWNlX2lkKsEBCgpTcGFjZVN0YXRlEgsKB0lOVkFMSUQQABISCg5TUEFDRV9JTkFDVElWRRACEhAKDFNQQUNFX0FDVElWRRAGEhAKDFNQQUNFX0NMT1NFRBABEhYKElNQQUNFX0NPTlRST0xfT05MWRAHEhYKElNQQUNFX0lOSVRJQUxJWklORxAEEg8KC1NQQUNFX1JFQURZEAMSDwoLU1BBQ0VfRVJST1IQBRIcChhTUEFDRV9SRVFVSVJFU19NSUdSQVRJT04QCGIGcHJvdG8z", [file_google_protobuf_any, file_google_protobuf_empty, file_google_protobuf_struct, file_google_protobuf_timestamp, file_dxos_config, file_dxos_devtools_swarm, file_dxos_echo_timeframe, file_dxos_error, file_dxos_halo_credentials, file_dxos_keys, file_dxos_mesh_signal, file_dxos_mesh_presence, file_dxos_mesh_teleport_gossip, file_dxos_value]);
+  fileDesc("ChxkeG9zL2NsaWVudC9pbnZpdGF0aW9uLnByb3RvEhRkeG9zLmNsaWVudC5zZXJ2aWNlcyJ9ChBBZG1pc3Npb25LZXlwYWlyEigKCnB1YmxpY19rZXkYASABKAsyFC5keG9zLmtleXMuUHVibGljS2V5Ei8KC3ByaXZhdGVfa2V5GAIgASgLMhUuZHhvcy5rZXlzLlByaXZhdGVLZXlIAIgBAUIOCgxfcHJpdmF0ZV9rZXkipwoKCkludml0YXRpb24SFQoNaW52aXRhdGlvbl9pZBgBIAEoCRIzCgR0eXBlGAIgASgOMiUuZHhvcy5jbGllbnQuc2VydmljZXMuSW52aXRhdGlvbi5UeXBlEjMKBGtpbmQYAyABKA4yJS5keG9zLmNsaWVudC5zZXJ2aWNlcy5JbnZpdGF0aW9uLktpbmQSQAoLYXV0aF9tZXRob2QYBCABKA4yKy5keG9zLmNsaWVudC5zZXJ2aWNlcy5JbnZpdGF0aW9uLkF1dGhNZXRob2QSJwoJc3dhcm1fa2V5GAUgASgLMhQuZHhvcy5rZXlzLlB1YmxpY0tleRI1CgVzdGF0ZRgGIAEoDjImLmR4b3MuY2xpZW50LnNlcnZpY2VzLkludml0YXRpb24uU3RhdGUSFAoHdGltZW91dBgHIAEoBUgAiAEBEi8KDGlkZW50aXR5X2tleRgIIAEoCzIULmR4b3Mua2V5cy5QdWJsaWNLZXlIAYgBARIsCglzcGFjZV9rZXkYCSABKAsyFC5keG9zLmtleXMuUHVibGljS2V5SAKIAQESFgoJYXV0aF9jb2RlGAogASgJSAOIAQESEwoGdGFyZ2V0GAsgASgJSASIAQESFwoKcGVyc2lzdGVudBgMIAEoCEgFiAEBEjAKB2NyZWF0ZWQYDSABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wSAaIAQESFQoIbGlmZXRpbWUYDiABKAVIB4gBARIWCgltdWx0aV91c2UYDyABKAhICIgBARJCCg1ndWVzdF9rZXlwYWlyGBAgASgLMiYuZHhvcy5jbGllbnQuc2VydmljZXMuQWRtaXNzaW9uS2V5cGFpckgJiAEBEjsKGGRlbGVnYXRpb25fY3JlZGVudGlhbF9pZBgRIAEoCzIULmR4b3Mua2V5cy5QdWJsaWNLZXlICogBARI6CgRyb2xlGBIgASgOMicuZHhvcy5oYWxvLmNyZWRlbnRpYWxzLlNwYWNlTWVtYmVyLlJvbGVIC4gBARIVCghzcGFjZV9pZBgTIAEoCUgMiAEBIjQKBFR5cGUSDwoLSU5URVJBQ1RJVkUQABINCglERUxFR0FURUQQARIMCghNVUxUSVVTRRACIioKBEtpbmQSCwoHSU5WQUxJRBAAEgoKBkRFVklDRRABEgkKBVNQQUNFEAIiPwoKQXV0aE1ldGhvZBIICgROT05FEAASEQoNU0hBUkVEX1NFQ1JFVBABEhQKEEtOT1dOX1BVQkxJQ19LRVkQAiKjAQoFU3RhdGUSCAoESU5JVBAAEg4KCkNPTk5FQ1RJTkcQARINCglDT05ORUNURUQQAhIcChhSRUFEWV9GT1JfQVVUSEVOVElDQVRJT04QAxISCg5BVVRIRU5USUNBVElORxAEEgsKB1NVQ0NFU1MQBRINCglDQU5DRUxMRUQQBhILCgdUSU1FT1VUEAcSCQoFRVJST1IQCBILCgdFWFBJUkVEEAlCCgoIX3RpbWVvdXRCDwoNX2lkZW50aXR5X2tleUIMCgpfc3BhY2Vfa2V5QgwKCl9hdXRoX2NvZGVCCQoHX3RhcmdldEINCgtfcGVyc2lzdGVudEIKCghfY3JlYXRlZEILCglfbGlmZXRpbWVCDAoKX211bHRpX3VzZUIQCg5fZ3Vlc3Rfa2V5cGFpckIbChlfZGVsZWdhdGlvbl9jcmVkZW50aWFsX2lkQgcKBV9yb2xlQgsKCV9zcGFjZV9pZCrUAQoKU3BhY2VTdGF0ZRILCgdJTlZBTElEEAASEgoOU1BBQ0VfSU5BQ1RJVkUQAhIQCgxTUEFDRV9BQ1RJVkUQBhIRCg1TUEFDRV9ERUxFVEVEEAkSEAoMU1BBQ0VfQ0xPU0VEEAESFgoSU1BBQ0VfQ09OVFJPTF9PTkxZEAcSFgoSU1BBQ0VfSU5JVElBTElaSU5HEAQSDwoLU1BBQ0VfUkVBRFkQAxIPCgtTUEFDRV9FUlJPUhAFEhwKGFNQQUNFX1JFUVVJUkVTX01JR1JBVElPThAIYgZwcm90bzM", [file_google_protobuf_any, file_google_protobuf_empty, file_google_protobuf_struct, file_google_protobuf_timestamp, file_dxos_config, file_dxos_devtools_swarm, file_dxos_echo_timeframe, file_dxos_error, file_dxos_halo_credentials, file_dxos_keys, file_dxos_mesh_signal, file_dxos_mesh_presence, file_dxos_mesh_teleport_gossip, file_dxos_value]);
 
 /**
  * @generated from message dxos.client.services.AdmissionKeypair
@@ -242,14 +242,21 @@ export const Invitation_TypeSchema: GenEnum<Invitation_Type> = /*@__PURE__*/
  */
 export enum Invitation_Kind {
   /**
-   * @generated from enum value: DEVICE = 0;
+   * / Unset / unknown. Must not be used for new invitations.
+   *
+   * @generated from enum value: INVALID = 0;
+   */
+  INVALID = 0,
+
+  /**
+   * @generated from enum value: DEVICE = 1;
    */
-  DEVICE = 0,
+  DEVICE = 1,
 
   /**
-   * @generated from enum value: SPACE = 1;
+   * @generated from enum value: SPACE = 2;
    */
-  SPACE = 1,
+  SPACE = 2,
 }
 
 /**
@@ -376,6 +383,13 @@ export enum SpaceState {
    */
   SPACE_ACTIVE = 6,
 
+  /**
+   * / Space is tombstoned (soft-deleted). Replicated to other devices; never auto-opened.
+   *
+   * @generated from enum value: SPACE_DELETED = 9;
+   */
+  SPACE_DELETED = 9,
+
   /**
    * / Space is closed.
    *

package/src/buf/proto/gen/dxos/client/queue_pb.ts

@@ -12,7 +12,7 @@ import type { Message } from "@bufbuild/protobuf";
  * Describes the file dxos/client/queue.proto.
  */
 export const file_dxos_client_queue: GenFile = /*@__PURE__*/
-  fileDesc("ChdkeG9zL2NsaWVudC9xdWV1ZS5wcm90bxIUZHhvcy5jbGllbnQuc2VydmljZXMi0wIKClF1ZXVlUXVlcnkSEAoIc3BhY2VfaWQYASABKAkSHQoQcXVldWVzX25hbWVzcGFjZRgCIAEoCUgAiAEBEhEKCXF1ZXVlX2lkcxgDIAMoCRISCgVhZnRlchgEIAEoCUgBiAEBEhMKBmJlZm9yZRgFIAEoCUgCiAEBEhsKDmJlZ2luX3Bvc2l0aW9uGAYgASgDSAOIAQESGQoMZW5kX3Bvc2l0aW9uGAcgASgDSASIAQESEgoFbGltaXQYCCABKAVIBYgBARIUCgdyZXZlcnNlGAkgASgISAaIAQESEgoKb2JqZWN0X2lkcxhkIAMoCUITChFfcXVldWVzX25hbWVzcGFjZUIICgZfYWZ0ZXJCCQoHX2JlZm9yZUIRCg9fYmVnaW5fcG9zaXRpb25CDwoNX2VuZF9wb3NpdGlvbkIICgZfbGltaXRCCgoIX3JldmVyc2UiTQoQUXVldWVRdWVyeVJlc3VsdBIPCgdvYmplY3RzGAEgAygJEhMKC25leHRfY3Vyc29yGAIgASgJEhMKC3ByZXZfY3Vyc29yGAMgASgJIkQKEVF1ZXJ5UXVldWVSZXF1ZXN0Ei8KBXF1ZXJ5GAEgASgLMiAuZHhvcy5jbGllbnQuc2VydmljZXMuUXVldWVRdWVyeSJjChZJbnNlcnRJbnRvUXVldWVSZXF1ZXN0EhQKDHN1YnNwYWNlX3RhZxgBIAEoCRIQCghzcGFjZV9pZBgCIAEoCRIQCghxdWV1ZV9pZBgDIAEoCRIPCgdvYmplY3RzGAQgAygJImYKFkRlbGV0ZUZyb21RdWV1ZVJlcXVlc3QSFAoMc3Vic3BhY2VfdGFnGAEgASgJEhAKCHNwYWNlX2lkGAIgASgJEhAKCHF1ZXVlX2lkGAMgASgJEhIKCm9iamVjdF9pZHMYBCADKAkioAEKEFN5bmNRdWV1ZVJlcXVlc3QSFAoMc3Vic3BhY2VfdGFnGAEgASgJEhAKCHNwYWNlX2lkGAIgASgJEhAKCHF1ZXVlX2lkGAMgASgJEhgKC3Nob3VsZF9wdXNoGAQgASgISACIAQESGAoLc2hvdWxkX3B1bGwYBSABKAhIAYgBAUIOCgxfc2hvdWxkX3B1c2hCDgoMX3Nob3VsZF9wdWxsMuwCCgxRdWV1ZVNlcnZpY2USXQoKUXVlcnlRdWV1ZRInLmR4b3MuY2xpZW50LnNlcnZpY2VzLlF1ZXJ5UXVldWVSZXF1ZXN0GiYuZHhvcy5jbGllbnQuc2VydmljZXMuUXVldWVRdWVyeVJlc3VsdBJXCg9JbnNlcnRJbnRvUXVldWUSLC5keG9zLmNsaWVudC5zZXJ2aWNlcy5JbnNlcnRJbnRvUXVldWVSZXF1ZXN0GhYuZ29vZ2xlLnByb3RvYnVmLkVtcHR5ElcKD0RlbGV0ZUZyb21RdWV1ZRIsLmR4b3MuY2xpZW50LnNlcnZpY2VzLkRlbGV0ZUZyb21RdWV1ZVJlcXVlc3QaFi5nb29nbGUucHJvdG9idWYuRW1wdHkSSwoJU3luY1F1ZXVlEiYuZHhvcy5jbGllbnQuc2VydmljZXMuU3luY1F1ZXVlUmVxdWVzdBoWLmdvb2dsZS5wcm90b2J1Zi5FbXB0eWIGcHJvdG8z", [file_google_protobuf_empty]);
+  fileDesc("ChdkeG9zL2NsaWVudC9xdWV1ZS5wcm90bxIUZHhvcy5jbGllbnQuc2VydmljZXMi0wIKClF1ZXVlUXVlcnkSEAoIc3BhY2VfaWQYASABKAkSHQoQcXVldWVzX25hbWVzcGFjZRgCIAEoCUgAiAEBEhEKCXF1ZXVlX2lkcxgDIAMoCRISCgVhZnRlchgEIAEoCUgBiAEBEhMKBmJlZm9yZRgFIAEoCUgCiAEBEhsKDmJlZ2luX3Bvc2l0aW9uGAYgASgDSAOIAQESGQoMZW5kX3Bvc2l0aW9uGAcgASgDSASIAQESEgoFbGltaXQYCCABKAVIBYgBARIUCgdyZXZlcnNlGAkgASgISAaIAQESEgoKb2JqZWN0X2lkcxhkIAMoCUITChFfcXVldWVzX25hbWVzcGFjZUIICgZfYWZ0ZXJCCQoHX2JlZm9yZUIRCg9fYmVnaW5fcG9zaXRpb25CDwoNX2VuZF9wb3NpdGlvbkIICgZfbGltaXRCCgoIX3JldmVyc2UiTQoQUXVldWVRdWVyeVJlc3VsdBIPCgdvYmplY3RzGAEgAygJEhMKC25leHRfY3Vyc29yGAIgASgJEhMKC3ByZXZfY3Vyc29yGAMgASgJIkQKEVF1ZXJ5UXVldWVSZXF1ZXN0Ei8KBXF1ZXJ5GAEgASgLMiAuZHhvcy5jbGllbnQuc2VydmljZXMuUXVldWVRdWVyeSJjChZJbnNlcnRJbnRvUXVldWVSZXF1ZXN0EhQKDHN1YnNwYWNlX3RhZxgBIAEoCRIQCghzcGFjZV9pZBgCIAEoCRIQCghxdWV1ZV9pZBgDIAEoCRIPCgdvYmplY3RzGAQgAygJImYKFkRlbGV0ZUZyb21RdWV1ZVJlcXVlc3QSFAoMc3Vic3BhY2VfdGFnGAEgASgJEhAKCHNwYWNlX2lkGAIgASgJEhAKCHF1ZXVlX2lkGAMgASgJEhIKCm9iamVjdF9pZHMYBCADKAkioAEKEFN5bmNRdWV1ZVJlcXVlc3QSFAoMc3Vic3BhY2VfdGFnGAEgASgJEhAKCHNwYWNlX2lkGAIgASgJEhAKCHF1ZXVlX2lkGAMgASgJEhgKC3Nob3VsZF9wdXNoGAQgASgISACIAQESGAoLc2hvdWxkX3B1bGwYBSABKAhIAYgBAUIOCgxfc2hvdWxkX3B1c2hCDgoMX3Nob3VsZF9wdWxsIjsKE0dldFN5bmNTdGF0ZVJlcXVlc3QSEAoIc3BhY2VfaWQYASABKAkSEgoKbmFtZXNwYWNlcxgCIAMoCSJyChdRdWV1ZU5hbWVzcGFjZVN5bmNTdGF0ZRIRCgluYW1lc3BhY2UYASABKAkSFgoOYmxvY2tzX3RvX3B1bGwYAiABKAMSFgoOYmxvY2tzX3RvX3B1c2gYAyABKAMSFAoMdG90YWxfYmxvY2tzGAQgASgDIlkKFEdldFN5bmNTdGF0ZVJlc3BvbnNlEkEKCm5hbWVzcGFjZXMYASADKAsyLS5keG9zLmNsaWVudC5zZXJ2aWNlcy5RdWV1ZU5hbWVzcGFjZVN5bmNTdGF0ZTLTAwoMUXVldWVTZXJ2aWNlEl0KClF1ZXJ5UXVldWUSJy5keG9zLmNsaWVudC5zZXJ2aWNlcy5RdWVyeVF1ZXVlUmVxdWVzdBomLmR4b3MuY2xpZW50LnNlcnZpY2VzLlF1ZXVlUXVlcnlSZXN1bHQSVwoPSW5zZXJ0SW50b1F1ZXVlEiwuZHhvcy5jbGllbnQuc2VydmljZXMuSW5zZXJ0SW50b1F1ZXVlUmVxdWVzdBoWLmdvb2dsZS5wcm90b2J1Zi5FbXB0eRJXCg9EZWxldGVGcm9tUXVldWUSLC5keG9zLmNsaWVudC5zZXJ2aWNlcy5EZWxldGVGcm9tUXVldWVSZXF1ZXN0GhYuZ29vZ2xlLnByb3RvYnVmLkVtcHR5EksKCVN5bmNRdWV1ZRImLmR4b3MuY2xpZW50LnNlcnZpY2VzLlN5bmNRdWV1ZVJlcXVlc3QaFi5nb29nbGUucHJvdG9idWYuRW1wdHkSZQoMR2V0U3luY1N0YXRlEikuZHhvcy5jbGllbnQuc2VydmljZXMuR2V0U3luY1N0YXRlUmVxdWVzdBoqLmR4b3MuY2xpZW50LnNlcnZpY2VzLkdldFN5bmNTdGF0ZVJlc3BvbnNlYgZwcm90bzM", [file_google_protobuf_empty]);
 
 /**
  * @generated from message dxos.client.services.QueueQuery
@@ -245,6 +245,85 @@ export type SyncQueueRequest = Message<"dxos.client.services.SyncQueueRequest">
 export const SyncQueueRequestSchema: GenMessage<SyncQueueRequest> = /*@__PURE__*/
   messageDesc(file_dxos_client_queue, 5);
 
+/**
+ * @generated from message dxos.client.services.GetSyncStateRequest
+ */
+export type GetSyncStateRequest = Message<"dxos.client.services.GetSyncStateRequest"> & {
+  /**
+   * @generated from field: string space_id = 1;
+   */
+  spaceId: string;
+
+  /**
+   * / If empty, returns state for all namespaces synced by the client.
+   *
+   * @generated from field: repeated string namespaces = 2;
+   */
+  namespaces: string[];
+};
+
+/**
+ * Describes the message dxos.client.services.GetSyncStateRequest.
+ * Use `create(GetSyncStateRequestSchema)` to create a new message.
+ */
+export const GetSyncStateRequestSchema: GenMessage<GetSyncStateRequest> = /*@__PURE__*/
+  messageDesc(file_dxos_client_queue, 6);
+
+/**
+ * @generated from message dxos.client.services.QueueNamespaceSyncState
+ */
+export type QueueNamespaceSyncState = Message<"dxos.client.services.QueueNamespaceSyncState"> & {
+  /**
+   * @generated from field: string namespace = 1;
+   */
+  namespace: string;
+
+  /**
+   * / Blocks still to pull from remote. 0 when caught up.
+   *
+   * @generated from field: int64 blocks_to_pull = 2;
+   */
+  blocksToPull: bigint;
+
+  /**
+   * / Unpositioned blocks still to push to remote. 0 when caught up.
+   *
+   * @generated from field: int64 blocks_to_push = 3;
+   */
+  blocksToPush: bigint;
+
+  /**
+   * / Total blocks stored locally for this namespace in the space.
+   *
+   * @generated from field: int64 total_blocks = 4;
+   */
+  totalBlocks: bigint;
+};
+
+/**
+ * Describes the message dxos.client.services.QueueNamespaceSyncState.
+ * Use `create(QueueNamespaceSyncStateSchema)` to create a new message.
+ */
+export const QueueNamespaceSyncStateSchema: GenMessage<QueueNamespaceSyncState> = /*@__PURE__*/
+  messageDesc(file_dxos_client_queue, 7);
+
+/**
+ * @generated from message dxos.client.services.GetSyncStateResponse
+ */
+export type GetSyncStateResponse = Message<"dxos.client.services.GetSyncStateResponse"> & {
+  /**
+   * @generated from field: repeated dxos.client.services.QueueNamespaceSyncState namespaces = 1;
+   */
+  namespaces: QueueNamespaceSyncState[];
+};
+
+/**
+ * Describes the message dxos.client.services.GetSyncStateResponse.
+ * Use `create(GetSyncStateResponseSchema)` to create a new message.
+ */
+export const GetSyncStateResponseSchema: GenMessage<GetSyncStateResponse> = /*@__PURE__*/
+  messageDesc(file_dxos_client_queue, 8);
+
 /**
  * @generated from service dxos.client.services.QueueService
  */
@@ -281,6 +360,14 @@ export const QueueService: GenService<{
     input: typeof SyncQueueRequestSchema;
     output: typeof EmptySchema;
   },
+  /**
+   * @generated from rpc dxos.client.services.QueueService.GetSyncState
+   */
+  getSyncState: {
+    methodKind: "unary";
+    input: typeof GetSyncStateRequestSchema;
+    output: typeof GetSyncStateResponseSchema;
+  },
 }> = /*@__PURE__*/
   serviceDesc(file_dxos_client_queue, 0);