@dxos/protocols 0.8.4-main.fbb7a13 → 0.8.4-main.fcc0d83b33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/protocols",
-  "version": "0.8.4-main.fbb7a13",
+  "version": "0.8.4-main.fcc0d83b33",
   "description": "Protobuf definitions for DXOS protocols.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -39,47 +39,28 @@
     }
   },
   "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.10.1",
-    "@dxos/codec-protobuf": "0.8.4-main.fbb7a13",
-    "@dxos/errors": "0.8.4-main.fbb7a13",
-    "@dxos/invariant": "0.8.4-main.fbb7a13",
-    "@dxos/effect": "0.8.4-main.fbb7a13",
-    "@dxos/timeframe": "0.8.4-main.fbb7a13",
-    "@dxos/util": "0.8.4-main.fbb7a13",
-    "@dxos/keys": "0.8.4-main.fbb7a13"
+    "@bufbuild/protobuf": "2.11.0",
+    "@dxos/codec-protobuf": "0.8.4-main.fcc0d83b33",
+    "@dxos/effect": "0.8.4-main.fcc0d83b33",
+    "@dxos/errors": "0.8.4-main.fcc0d83b33",
+    "@dxos/invariant": "0.8.4-main.fcc0d83b33",
+    "@dxos/keys": "0.8.4-main.fcc0d83b33",
+    "@dxos/timeframe": "0.8.4-main.fcc0d83b33",
+    "@dxos/util": "0.8.4-main.fcc0d83b33"
   },
   "devDependencies": {
-    "@bufbuild/buf": "1.61.0",
-    "@bufbuild/protoc-gen-es": "2.10.1",
-    "effect": "3.19.11",
-    "@dxos/protobuf-compiler": "0.8.4-main.fbb7a13"
+    "@bufbuild/buf": "1.65.0",
+    "@bufbuild/protoc-gen-es": "2.11.0",
+    "effect": "3.20.0",
+    "@dxos/protobuf-compiler": "0.8.4-main.fcc0d83b33"
   },
   "peerDependencies": {
-    "effect": "3.19.11"
+    "effect": "3.20.0"
   },
   "publishConfig": {
     "access": "public"

package/src/FeedProtocol.ts

@@ -0,0 +1,320 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+export {
+  type QueueService,
+  type QueueQuery,
+  type QueueQueryResult as QueryResult,
+  type QueryQueueRequest,
+  type InsertIntoQueueRequest,
+  type DeleteFromQueueRequest,
+  type SyncQueueRequest,
+} from './proto/gen/dxos/client/services.js';
+
+export const KEY_QUEUE_POSITION = 'org.dxos.key.queue-position';
+
+import * as Schema from 'effect/Schema';
+
+import { invariant } from '@dxos/invariant';
+import { SpaceId } from '@dxos/keys';
+
+import { EdgeService } from './edge/edge.js';
+
+/**
+ * Opaque pagination cursor for feed queries.
+ */
+export const FeedCursor = Schema.String.pipe(Schema.brand('@dxos/feed/FeedCursor'));
+export type FeedCursor = Schema.Schema.Type<typeof FeedCursor>;
+
+/**
+ * Replicated queue block payload and ordering metadata.
+ */
+export const Block = Schema.Struct({
+  /**
+   * Appears on blocks returned from query.
+   */
+  feedId: Schema.UndefinedOr(Schema.String),
+
+  /**
+   * Actor that produced this block.
+   */
+  actorId: Schema.String,
+
+  /**
+   * Per-feed monotonic sequence assigned by the actor.
+   */
+  sequence: Schema.Number,
+
+  /**
+   * Actor of the immediate predecessor block, if any.
+   */
+  prevActorId: Schema.NullOr(Schema.String),
+
+  /**
+   * Sequence of the immediate predecessor block, if any.
+   */
+  prevSequence: Schema.NullOr(Schema.Number),
+
+  /**
+   * Globally ordered position assigned by a position authority.
+   * Unlike `sequence` (per-feed causal order), this enables merged incremental reads across feeds.
+   */
+  position: Schema.NullOr(Schema.Number),
+
+  /**
+   * Milliseconds since Unix epoch when the block was created.
+   */
+  timestamp: Schema.Number,
+
+  /**
+   * Serialized application payload.
+   */
+  data: Schema.Uint8Array,
+
+  /**
+   * Local insertion ID.
+   * Not replicated.
+   */
+  // TODO(dmaretskyi): Remove. Use cursors.
+  insertionId: Schema.optional(Schema.Number),
+});
+export interface Block extends Schema.Schema.Type<typeof Block> {}
+
+//
+// RPC Schemas
+//
+
+/**
+ * Query parameters for retrieving blocks from one namespace in one space.
+ */
+export const QueryRequest = Schema.Struct({
+  /**
+   * Optional request correlation identifier.
+   */
+  requestId: Schema.optional(Schema.String),
+
+  /**
+   * Target space identifier.
+   */
+  spaceId: SpaceId,
+
+  /**
+   * Feed namespace to query.
+   */
+  feedNamespace: Schema.String,
+
+  query: Schema.optional(
+    Schema.Union(
+      Schema.Struct({
+        /**
+         * Explicit list of feed IDs to read from.
+         */
+        feedIds: Schema.Array(Schema.String),
+      }),
+      Schema.Struct({
+        /**
+         * Existing subscription to resolve feed IDs from.
+         */
+        subscriptionId: Schema.String,
+      }),
+    ),
+  ),
+
+  /**
+   * Get changes following this cursor (exclusive).
+   *
+   * Must not be used with `position`.
+   */
+  cursor: Schema.optional(FeedCursor),
+
+  /**
+   * Get changes following this position.
+   * Returned blocks have strictly greater position than this.
+   *
+   * Must not be used with `cursor`.
+   */
+  position: Schema.optional(Schema.Number),
+
+  /**
+   * Only return blocks that are not positioned.
+   *
+   * Must not be used with `cursor` or `position`.
+   */
+  unpositionedOnly: Schema.optional(Schema.Boolean),
+
+  /**
+   * Maximum number of blocks to return.
+   */
+  limit: Schema.optional(Schema.Number),
+});
+export interface QueryRequest extends Schema.Schema.Type<typeof QueryRequest> {}
+
+/**
+ * Result payload for a query operation.
+ */
+export const QueryResponse = Schema.Struct({
+  /**
+   * Echoed request correlation identifier.
+   */
+  requestId: Schema.optional(Schema.String),
+
+  /**
+   * Cursor to continue reading from this result boundary.
+   */
+  nextCursor: FeedCursor,
+
+  /**
+   * Indicates whether more matching blocks are available.
+   */
+  hasMore: Schema.Boolean,
+
+  /**
+   * Returned blocks for the current page.
+   */
+  blocks: Schema.Array(Block),
+});
+export interface QueryResponse extends Schema.Schema.Type<typeof QueryResponse> {}
+
+/**
+ * Parameters for creating or refreshing a feed subscription.
+ */
+export const SubscribeRequest = Schema.Struct({
+  /**
+   * Optional request correlation identifier.
+   */
+  requestId: Schema.optional(Schema.String),
+
+  /**
+   * Optional space scope for the subscription.
+   */
+  spaceId: Schema.optional(Schema.String),
+
+  /**
+   * Feeds to include in the subscription.
+   */
+  feedIds: Schema.Array(Schema.String),
+});
+export interface SubscribeRequest extends Schema.Schema.Type<typeof SubscribeRequest> {}
+
+/**
+ * Response payload for subscription creation.
+ */
+export const SubscribeResponse = Schema.Struct({
+  /**
+   * Echoed request correlation identifier.
+   */
+  requestId: Schema.optional(Schema.String),
+
+  /**
+   * Identifier to use in subsequent subscription queries.
+   */
+  subscriptionId: Schema.String,
+
+  /**
+   * Expiration timestamp in milliseconds since Unix epoch.
+   */
+  expiresAt: Schema.Number,
+});
+export interface SubscribeResponse extends Schema.Schema.Type<typeof SubscribeResponse> {}
+
+/**
+ * Request payload for appending one or more blocks.
+ */
+export const AppendRequest = Schema.Struct({
+  /**
+   * Optional request correlation identifier.
+   */
+  requestId: Schema.optional(Schema.String),
+
+  /**
+   * Target space identifier.
+   */
+  spaceId: Schema.String,
+
+  /**
+   * Namespace that all appended blocks belong to.
+   */
+  feedNamespace: Schema.String,
+
+  /**
+   * Blocks to append.
+   */
+  blocks: Schema.Array(Block),
+});
+export interface AppendRequest extends Schema.Schema.Type<typeof AppendRequest> {}
+
+/**
+ * Result payload for append operations.
+ */
+export const AppendResponse = Schema.Struct({
+  /**
+   * Echoed request correlation identifier.
+   */
+  requestId: Schema.optional(Schema.String),
+
+  /**
+   * Assigned global positions for appended blocks.
+   */
+  positions: Schema.Array(Schema.Number),
+});
+export interface AppendResponse extends Schema.Schema.Type<typeof AppendResponse> {}
+
+/**
+ * Tagged transport message union for queue protocol RPC traffic.
+ */
+export const ProtocolMessage = Schema.Union(
+  Schema.TaggedStruct('QueryRequest', QueryRequest.fields),
+  Schema.TaggedStruct('QueryResponse', QueryResponse.fields),
+  Schema.TaggedStruct('SubscribeRequest', SubscribeRequest.fields),
+  Schema.TaggedStruct('SubscribeResponse', SubscribeResponse.fields),
+  Schema.TaggedStruct('AppendRequest', AppendRequest.fields),
+  Schema.TaggedStruct('AppendResponse', AppendResponse.fields),
+  Schema.TaggedStruct('Error', {
+    /**
+     * Human-readable error message.
+     */
+    message: Schema.String,
+  }),
+).pipe(
+  Schema.extend(
+    Schema.Struct({
+      senderPeerId: Schema.UndefinedOr(Schema.String),
+      /**
+       * Could be undefined if the recipient could be assumed from the context.
+       */
+      recipientPeerId: Schema.UndefinedOr(Schema.String),
+    }),
+  ),
+);
+export type ProtocolMessage = Schema.Schema.Type<typeof ProtocolMessage>;
+
+/**
+ * Reserved namespaces with protocol-level semantics.
+ */
+export const WellKnownNamespaces = {
+  data: 'data',
+  trace: 'trace',
+} as const;
+
+export const isWellKnownNamespace = (namespace: string) =>
+  Object.values(WellKnownNamespaces).includes(namespace as any);
+
+/**
+ * Encodes queue replicator service identifier as `<service>:<namespace>:<spaceId>`.
+ */
+export const encodeServiceId = (namespace: string, spaceId: SpaceId) =>
+  `${EdgeService.QUEUE_REPLICATOR}:${namespace}:${spaceId}`;
+
+/**
+ * Decodes and validates queue replicator service identifier.
+ */
+export const decodeServiceId = (
+  serviceId: string,
+): { namespace: keyof typeof WellKnownNamespaces; spaceId: SpaceId } => {
+  const [service, namespace, spaceId] = serviceId.split(':');
+  invariant(service === EdgeService.QUEUE_REPLICATOR, `Invalid service: ${service}`);
+  invariant(isWellKnownNamespace(namespace), `Invalid namespace: ${namespace}`);
+  invariant(SpaceId.isValid(spaceId), `Invalid spaceId: ${spaceId}`);
+  return { namespace: namespace as keyof typeof WellKnownNamespaces, spaceId };
+};

package/src/FunctionProtocol.ts

@@ -7,7 +7,7 @@ import type * as QueryProto from '@dxos/protocols/proto/dxos/echo/query';
 import type * as DataProto from '@dxos/protocols/proto/dxos/echo/service';
 
 import { type EdgeFunctionEnv } from './edge';
-import { type QueueService } from './queue';
+import type * as FeedProtocol from './FeedProtocol';
 
 //
 // Function protocol definition
@@ -18,8 +18,6 @@ import { type QueueService } from './queue';
 // - Protobuf service definitions are allowed (Q: What about PublicKey, Timeframe, etc.).
 // - Breaking changes in this interface should be carefully considered.
 
-// TODO(dmaretskyi): Consider moving this to protocols.
-
 /**
  * Function implementation.
  * This is a contract between the user-defined function and the runtime.
@@ -77,7 +75,7 @@ export interface Context {
      * Queue service.
      * Available if the function is invoked in context of a space.
      */
-    queueService?: QueueService;
+    queueService?: FeedProtocol.QueueService;
 
     /**
      * Functions service.

package/src/buf/proto/gen/dxos/agent/dashboard_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.10.1 with parameter "target=ts,import_extension=js"
+// @generated by protoc-gen-es v2.11.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/agent/dashboard.proto (package dxos.agent.dashboard, syntax proto3)
 /* eslint-disable */
 

package/src/buf/proto/gen/dxos/agent/echo-proxy_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.10.1 with parameter "target=ts,import_extension=js"
+// @generated by protoc-gen-es v2.11.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/agent/echo-proxy.proto (package dxos.agent.echoproxy, syntax proto3)
 /* eslint-disable */
 

package/src/buf/proto/gen/dxos/agent/epoch_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.10.1 with parameter "target=ts,import_extension=js"
+// @generated by protoc-gen-es v2.11.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/agent/epoch.proto (package dxos.agent.epoch, syntax proto3)
 /* eslint-disable */
 

package/src/buf/proto/gen/dxos/agent/functions_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.10.1 with parameter "target=ts,import_extension=js"
+// @generated by protoc-gen-es v2.11.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/agent/functions.proto (package dxos.agent.functions, syntax proto3)
 /* eslint-disable */
 

package/src/buf/proto/gen/dxos/bot_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2020 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.10.1 with parameter "target=ts,import_extension=js"
+// @generated by protoc-gen-es v2.11.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/bot.proto (package dxos.bot, syntax proto3)
 /* eslint-disable */
 

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

@@ -2,7 +2,7 @@
 // Copyright 2021 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.10.1 with parameter "target=ts,import_extension=js"
+// @generated by protoc-gen-es v2.11.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/client/invitation.proto (package dxos.client.services, syntax proto3)
 /* eslint-disable */
 

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

@@ -2,7 +2,7 @@
 // Copyright 2021 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.10.1 with parameter "target=ts,import_extension=js"
+// @generated by protoc-gen-es v2.11.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/client/logging.proto (package dxos.client.services, syntax proto3)
 /* eslint-disable */
 

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

@@ -1,18 +1,18 @@
-// @generated by protoc-gen-es v2.10.1 with parameter "target=ts,import_extension=js"
+// @generated by protoc-gen-es v2.11.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/client/queue.proto (package dxos.client.services, syntax proto3)
 /* eslint-disable */
 
 import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
 import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
 import type { EmptySchema } from "@bufbuild/protobuf/wkt";
-import { file_google_protobuf_empty, file_google_protobuf_struct } from "@bufbuild/protobuf/wkt";
-import type { JsonObject, Message } from "@bufbuild/protobuf";
+import { file_google_protobuf_empty } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
 
 /**
  * Describes the file dxos/client/queue.proto.
  */
 export const file_dxos_client_queue: GenFile = /*@__PURE__*/
-  fileDesc("ChdkeG9zL2NsaWVudC9xdWV1ZS5wcm90bxIUZHhvcy5jbGllbnQuc2VydmljZXMi0wIKClF1ZXVlUXVlcnkSEAoIc3BhY2VfaWQYASABKAkSHQoQcXVldWVzX25hbWVzcGFjZRgCIAEoCUgAiAEBEhEKCXF1ZXVlX2lkcxgDIAMoCRISCgVhZnRlchgEIAEoCUgBiAEBEhMKBmJlZm9yZRgFIAEoCUgCiAEBEhsKDmJlZ2luX3Bvc2l0aW9uGAYgASgDSAOIAQESGQoMZW5kX3Bvc2l0aW9uGAcgASgDSASIAQESEgoFbGltaXQYCCABKAVIBYgBARIUCgdyZXZlcnNlGAkgASgISAaIAQESEgoKb2JqZWN0X2lkcxhkIAMoCUITChFfcXVldWVzX25hbWVzcGFjZUIICgZfYWZ0ZXJCCQoHX2JlZm9yZUIRCg9fYmVnaW5fcG9zaXRpb25CDwoNX2VuZF9wb3NpdGlvbkIICgZfbGltaXRCCgoIX3JldmVyc2UiZgoQUXVldWVRdWVyeVJlc3VsdBIoCgdvYmplY3RzGAEgAygLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdBITCgtuZXh0X2N1cnNvchgCIAEoCRITCgtwcmV2X2N1cnNvchgDIAEoCSJEChFRdWVyeVF1ZXVlUmVxdWVzdBIvCgVxdWVyeRgBIAEoCzIgLmR4b3MuY2xpZW50LnNlcnZpY2VzLlF1ZXVlUXVlcnkifAoWSW5zZXJ0SW50b1F1ZXVlUmVxdWVzdBIUCgxzdWJzcGFjZV90YWcYASABKAkSEAoIc3BhY2VfaWQYAiABKAkSEAoIcXVldWVfaWQYAyABKAkSKAoHb2JqZWN0cxgEIAMoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3QiZgoWRGVsZXRlRnJvbVF1ZXVlUmVxdWVzdBIUCgxzdWJzcGFjZV90YWcYASABKAkSEAoIc3BhY2VfaWQYAiABKAkSEAoIcXVldWVfaWQYAyABKAkSEgoKb2JqZWN0X2lkcxgEIAMoCTKfAgoMUXVldWVTZXJ2aWNlEl0KClF1ZXJ5UXVldWUSJy5keG9zLmNsaWVudC5zZXJ2aWNlcy5RdWVyeVF1ZXVlUmVxdWVzdBomLmR4b3MuY2xpZW50LnNlcnZpY2VzLlF1ZXVlUXVlcnlSZXN1bHQSVwoPSW5zZXJ0SW50b1F1ZXVlEiwuZHhvcy5jbGllbnQuc2VydmljZXMuSW5zZXJ0SW50b1F1ZXVlUmVxdWVzdBoWLmdvb2dsZS5wcm90b2J1Zi5FbXB0eRJXCg9EZWxldGVGcm9tUXVldWUSLC5keG9zLmNsaWVudC5zZXJ2aWNlcy5EZWxldGVGcm9tUXVldWVSZXF1ZXN0GhYuZ29vZ2xlLnByb3RvYnVmLkVtcHR5YgZwcm90bzM", [file_google_protobuf_struct, file_google_protobuf_empty]);
+  fileDesc("ChdkeG9zL2NsaWVudC9xdWV1ZS5wcm90bxIUZHhvcy5jbGllbnQuc2VydmljZXMi0wIKClF1ZXVlUXVlcnkSEAoIc3BhY2VfaWQYASABKAkSHQoQcXVldWVzX25hbWVzcGFjZRgCIAEoCUgAiAEBEhEKCXF1ZXVlX2lkcxgDIAMoCRISCgVhZnRlchgEIAEoCUgBiAEBEhMKBmJlZm9yZRgFIAEoCUgCiAEBEhsKDmJlZ2luX3Bvc2l0aW9uGAYgASgDSAOIAQESGQoMZW5kX3Bvc2l0aW9uGAcgASgDSASIAQESEgoFbGltaXQYCCABKAVIBYgBARIUCgdyZXZlcnNlGAkgASgISAaIAQESEgoKb2JqZWN0X2lkcxhkIAMoCUITChFfcXVldWVzX25hbWVzcGFjZUIICgZfYWZ0ZXJCCQoHX2JlZm9yZUIRCg9fYmVnaW5fcG9zaXRpb25CDwoNX2VuZF9wb3NpdGlvbkIICgZfbGltaXRCCgoIX3JldmVyc2UiTQoQUXVldWVRdWVyeVJlc3VsdBIPCgdvYmplY3RzGAEgAygJEhMKC25leHRfY3Vyc29yGAIgASgJEhMKC3ByZXZfY3Vyc29yGAMgASgJIkQKEVF1ZXJ5UXVldWVSZXF1ZXN0Ei8KBXF1ZXJ5GAEgASgLMiAuZHhvcy5jbGllbnQuc2VydmljZXMuUXVldWVRdWVyeSJjChZJbnNlcnRJbnRvUXVldWVSZXF1ZXN0EhQKDHN1YnNwYWNlX3RhZxgBIAEoCRIQCghzcGFjZV9pZBgCIAEoCRIQCghxdWV1ZV9pZBgDIAEoCRIPCgdvYmplY3RzGAQgAygJImYKFkRlbGV0ZUZyb21RdWV1ZVJlcXVlc3QSFAoMc3Vic3BhY2VfdGFnGAEgASgJEhAKCHNwYWNlX2lkGAIgASgJEhAKCHF1ZXVlX2lkGAMgASgJEhIKCm9iamVjdF9pZHMYBCADKAkioAEKEFN5bmNRdWV1ZVJlcXVlc3QSFAoMc3Vic3BhY2VfdGFnGAEgASgJEhAKCHNwYWNlX2lkGAIgASgJEhAKCHF1ZXVlX2lkGAMgASgJEhgKC3Nob3VsZF9wdXNoGAQgASgISACIAQESGAoLc2hvdWxkX3B1bGwYBSABKAhIAYgBAUIOCgxfc2hvdWxkX3B1c2hCDgoMX3Nob3VsZF9wdWxsMuwCCgxRdWV1ZVNlcnZpY2USXQoKUXVlcnlRdWV1ZRInLmR4b3MuY2xpZW50LnNlcnZpY2VzLlF1ZXJ5UXVldWVSZXF1ZXN0GiYuZHhvcy5jbGllbnQuc2VydmljZXMuUXVldWVRdWVyeVJlc3VsdBJXCg9JbnNlcnRJbnRvUXVldWUSLC5keG9zLmNsaWVudC5zZXJ2aWNlcy5JbnNlcnRJbnRvUXVldWVSZXF1ZXN0GhYuZ29vZ2xlLnByb3RvYnVmLkVtcHR5ElcKD0RlbGV0ZUZyb21RdWV1ZRIsLmR4b3MuY2xpZW50LnNlcnZpY2VzLkRlbGV0ZUZyb21RdWV1ZVJlcXVlc3QaFi5nb29nbGUucHJvdG9idWYuRW1wdHkSSwoJU3luY1F1ZXVlEiYuZHhvcy5jbGllbnQuc2VydmljZXMuU3luY1F1ZXVlUmVxdWVzdBoWLmdvb2dsZS5wcm90b2J1Zi5FbXB0eWIGcHJvdG8z", [file_google_protobuf_empty]);
 
 /**
  * @generated from message dxos.client.services.QueueQuery
@@ -93,12 +93,16 @@ export const QueueQuerySchema: GenMessage<QueueQuery> = /*@__PURE__*/
  */
 export type QueueQueryResult = Message<"dxos.client.services.QueueQueryResult"> & {
   /**
-   * @generated from field: repeated google.protobuf.Struct objects = 1;
+   * / JSON-encoded object payloads. Each entry is a serialized ObjectJSON.
+   * / We use JSON strings instead of google.protobuf.Struct because Struct
+   * / coerces `undefined` to `null`, corrupting optional fields.
+   *
+   * @generated from field: repeated string objects = 1;
    */
-  objects: JsonObject[];
+  objects: string[];
 
   /**
-   * / Cursor to query the next items. Can be passed to `after` in query to keep querying. 
+   * / Cursor to query the next items. Can be passed to `after` in query to keep querying.
    *
    * @generated from field: string next_cursor = 2;
    */
@@ -154,9 +158,11 @@ export type InsertIntoQueueRequest = Message<"dxos.client.services.InsertIntoQue
   queueId: string;
 
   /**
-   * @generated from field: repeated google.protobuf.Struct objects = 4;
+   * / JSON-encoded object payloads. Each entry is a serialized ObjectJSON.
+   *
+   * @generated from field: repeated string objects = 4;
    */
-  objects: JsonObject[];
+  objects: string[];
 };
 
 /**
@@ -198,6 +204,47 @@ export type DeleteFromQueueRequest = Message<"dxos.client.services.DeleteFromQue
 export const DeleteFromQueueRequestSchema: GenMessage<DeleteFromQueueRequest> = /*@__PURE__*/
   messageDesc(file_dxos_client_queue, 4);
 
+/**
+ * @generated from message dxos.client.services.SyncQueueRequest
+ */
+export type SyncQueueRequest = Message<"dxos.client.services.SyncQueueRequest"> & {
+  /**
+   * @generated from field: string subspace_tag = 1;
+   */
+  subspaceTag: string;
+
+  /**
+   * @generated from field: string space_id = 2;
+   */
+  spaceId: string;
+
+  /**
+   * @generated from field: string queue_id = 3;
+   */
+  queueId: string;
+
+  /**
+   * / Whether to push local changes to the server. Defaults to true.
+   *
+   * @generated from field: optional bool should_push = 4;
+   */
+  shouldPush?: boolean;
+
+  /**
+   * / Whether to pull remote changes from the server. Defaults to true.
+   *
+   * @generated from field: optional bool should_pull = 5;
+   */
+  shouldPull?: boolean;
+};
+
+/**
+ * Describes the message dxos.client.services.SyncQueueRequest.
+ * Use `create(SyncQueueRequestSchema)` to create a new message.
+ */
+export const SyncQueueRequestSchema: GenMessage<SyncQueueRequest> = /*@__PURE__*/
+  messageDesc(file_dxos_client_queue, 5);
+
 /**
  * @generated from service dxos.client.services.QueueService
  */
@@ -226,6 +273,14 @@ export const QueueService: GenService<{
     input: typeof DeleteFromQueueRequestSchema;
     output: typeof EmptySchema;
   },
+  /**
+   * @generated from rpc dxos.client.services.QueueService.SyncQueue
+   */
+  syncQueue: {
+    methodKind: "unary";
+    input: typeof SyncQueueRequestSchema;
+    output: typeof EmptySchema;
+  },
 }> = /*@__PURE__*/
   serviceDesc(file_dxos_client_queue, 0);