@dxos/protocols 0.8.4-main.ef1bc66f44 → 0.8.4-main.effb148878

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/protocols",
-  "version": "0.8.4-main.ef1bc66f44",
+  "version": "0.8.4-main.effb148878",
   "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,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.11.0",
-    "@dxos/codec-protobuf": "0.8.4-main.ef1bc66f44",
-    "@dxos/effect": "0.8.4-main.ef1bc66f44",
-    "@dxos/errors": "0.8.4-main.ef1bc66f44",
-    "@dxos/keys": "0.8.4-main.ef1bc66f44",
-    "@dxos/timeframe": "0.8.4-main.ef1bc66f44",
-    "@dxos/util": "0.8.4-main.ef1bc66f44",
-    "@dxos/invariant": "0.8.4-main.ef1bc66f44"
+    "@dxos/effect": "0.8.4-main.effb148878",
+    "@dxos/errors": "0.8.4-main.effb148878",
+    "@dxos/codec-protobuf": "0.8.4-main.effb148878",
+    "@dxos/keys": "0.8.4-main.effb148878",
+    "@dxos/invariant": "0.8.4-main.effb148878",
+    "@dxos/timeframe": "0.8.4-main.effb148878",
+    "@dxos/util": "0.8.4-main.effb148878"
   },
   "devDependencies": {
     "@bufbuild/buf": "1.65.0",
     "@bufbuild/protoc-gen-es": "2.11.0",
-    "effect": "3.19.16",
-    "@dxos/protobuf-compiler": "0.8.4-main.ef1bc66f44"
+    "effect": "3.20.0",
+    "@dxos/protobuf-compiler": "0.8.4-main.effb148878"
   },
   "peerDependencies": {
-    "effect": "3.19.16"
+    "effect": "3.20.0"
   },
   "publishConfig": {
     "access": "public"

package/src/FeedProtocol.ts

@@ -9,9 +9,13 @@ export {
   type QueryQueueRequest,
   type InsertIntoQueueRequest,
   type DeleteFromQueueRequest,
+  type SyncQueueRequest,
+  type GetSyncStateRequest,
+  type GetSyncStateResponse,
+  type QueueNamespaceSyncState,
 } from './proto/gen/dxos/client/services.js';
 
-export const KEY_QUEUE_POSITION = 'dxos.org/key/queue-position';
+export const KEY_QUEUE_POSITION = 'org.dxos.key.queue-position';
 
 import * as Schema from 'effect/Schema';
 

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
@@ -18,8 +19,6 @@ import type * as FeedProtocol from './FeedProtocol';
 // - 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.
@@ -84,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/buf/proto/gen/dxos/client/queue_pb.ts

@@ -5,14 +5,14 @@
 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("ChdkeG9zL2NsaWVudC9xdWV1ZS5wcm90bxIUZHhvcy5jbGllbnQuc2VydmljZXMi0wIKClF1ZXVlUXVlcnkSEAoIc3BhY2VfaWQYASABKAkSHQoQcXVldWVzX25hbWVzcGFjZRgCIAEoCUgAiAEBEhEKCXF1ZXVlX2lkcxgDIAMoCRISCgVhZnRlchgEIAEoCUgBiAEBEhMKBmJlZm9yZRgFIAEoCUgCiAEBEhsKDmJlZ2luX3Bvc2l0aW9uGAYgASgDSAOIAQESGQoMZW5kX3Bvc2l0aW9uGAcgASgDSASIAQESEgoFbGltaXQYCCABKAVIBYgBARIUCgdyZXZlcnNlGAkgASgISAaIAQESEgoKb2JqZWN0X2lkcxhkIAMoCUITChFfcXVldWVzX25hbWVzcGFjZUIICgZfYWZ0ZXJCCQoHX2JlZm9yZUIRCg9fYmVnaW5fcG9zaXRpb25CDwoNX2VuZF9wb3NpdGlvbkIICgZfbGltaXRCCgoIX3JldmVyc2UiTQoQUXVldWVRdWVyeVJlc3VsdBIPCgdvYmplY3RzGAEgAygJEhMKC25leHRfY3Vyc29yGAIgASgJEhMKC3ByZXZfY3Vyc29yGAMgASgJIkQKEVF1ZXJ5UXVldWVSZXF1ZXN0Ei8KBXF1ZXJ5GAEgASgLMiAuZHhvcy5jbGllbnQuc2VydmljZXMuUXVldWVRdWVyeSJjChZJbnNlcnRJbnRvUXVldWVSZXF1ZXN0EhQKDHN1YnNwYWNlX3RhZxgBIAEoCRIQCghzcGFjZV9pZBgCIAEoCRIQCghxdWV1ZV9pZBgDIAEoCRIPCgdvYmplY3RzGAQgAygJImYKFkRlbGV0ZUZyb21RdWV1ZVJlcXVlc3QSFAoMc3Vic3BhY2VfdGFnGAEgASgJEhAKCHNwYWNlX2lkGAIgASgJEhAKCHF1ZXVlX2lkGAMgASgJEhIKCm9iamVjdF9pZHMYBCADKAkioAEKEFN5bmNRdWV1ZVJlcXVlc3QSFAoMc3Vic3BhY2VfdGFnGAEgASgJEhAKCHNwYWNlX2lkGAIgASgJEhAKCHF1ZXVlX2lkGAMgASgJEhgKC3Nob3VsZF9wdXNoGAQgASgISACIAQESGAoLc2hvdWxkX3B1bGwYBSABKAhIAYgBAUIOCgxfc2hvdWxkX3B1c2hCDgoMX3Nob3VsZF9wdWxsIjsKE0dldFN5bmNTdGF0ZVJlcXVlc3QSEAoIc3BhY2VfaWQYASABKAkSEgoKbmFtZXNwYWNlcxgCIAMoCSJyChdRdWV1ZU5hbWVzcGFjZVN5bmNTdGF0ZRIRCgluYW1lc3BhY2UYASABKAkSFgoOYmxvY2tzX3RvX3B1bGwYAiABKAMSFgoOYmxvY2tzX3RvX3B1c2gYAyABKAMSFAoMdG90YWxfYmxvY2tzGAQgASgDIlkKFEdldFN5bmNTdGF0ZVJlc3BvbnNlEkEKCm5hbWVzcGFjZXMYASADKAsyLS5keG9zLmNsaWVudC5zZXJ2aWNlcy5RdWV1ZU5hbWVzcGFjZVN5bmNTdGF0ZTLTAwoMUXVldWVTZXJ2aWNlEl0KClF1ZXJ5UXVldWUSJy5keG9zLmNsaWVudC5zZXJ2aWNlcy5RdWVyeVF1ZXVlUmVxdWVzdBomLmR4b3MuY2xpZW50LnNlcnZpY2VzLlF1ZXVlUXVlcnlSZXN1bHQSVwoPSW5zZXJ0SW50b1F1ZXVlEiwuZHhvcy5jbGllbnQuc2VydmljZXMuSW5zZXJ0SW50b1F1ZXVlUmVxdWVzdBoWLmdvb2dsZS5wcm90b2J1Zi5FbXB0eRJXCg9EZWxldGVGcm9tUXVldWUSLC5keG9zLmNsaWVudC5zZXJ2aWNlcy5EZWxldGVGcm9tUXVldWVSZXF1ZXN0GhYuZ29vZ2xlLnByb3RvYnVmLkVtcHR5EksKCVN5bmNRdWV1ZRImLmR4b3MuY2xpZW50LnNlcnZpY2VzLlN5bmNRdWV1ZVJlcXVlc3QaFi5nb29nbGUucHJvdG9idWYuRW1wdHkSZQoMR2V0U3luY1N0YXRlEikuZHhvcy5jbGllbnQuc2VydmljZXMuR2V0U3luY1N0YXRlUmVxdWVzdBoqLmR4b3MuY2xpZW50LnNlcnZpY2VzLkdldFN5bmNTdGF0ZVJlc3BvbnNlYgZwcm90bzM", [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,126 @@ 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 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
  */
@@ -226,6 +352,22 @@ 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;
+  },
+  /**
+   * @generated from rpc dxos.client.services.QueueService.GetSyncState
+   */
+  getSyncState: {
+    methodKind: "unary";
+    input: typeof GetSyncStateRequestSchema;
+    output: typeof GetSyncStateResponseSchema;
+  },
 }> = /*@__PURE__*/
   serviceDesc(file_dxos_client_queue, 0);