@dxos/protocols 0.8.4-main.d05673bc65 → 0.8.4-main.e00bdcdb52

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

@@ -2,13 +2,10 @@
 // @generated from file dxos/tracing.proto (package dxos.tracing, syntax proto3)
 /* eslint-disable */
 
-import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
-import { enumDesc, fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
-import type { EmptySchema } from "@bufbuild/protobuf/wkt";
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
 import { file_google_protobuf_empty, file_google_protobuf_struct } from "@bufbuild/protobuf/wkt";
-import type { Error } from "./error_pb.js";
 import { file_dxos_error } from "./error_pb.js";
-import type { LogEntry } from "./client/logging_pb.js";
 import { file_dxos_client_logging } from "./client/logging_pb.js";
 import type { JsonObject, Message } from "@bufbuild/protobuf";
 
@@ -16,7 +13,7 @@ import type { JsonObject, Message } from "@bufbuild/protobuf";
  * Describes the file dxos/tracing.proto.
  */
 export const file_dxos_tracing: GenFile = /*@__PURE__*/
-  fileDesc("ChJkeG9zL3RyYWNpbmcucHJvdG8SDGR4b3MudHJhY2luZyK4AQoIUmVzb3VyY2USCgoCaWQYASABKAUSEgoKY2xhc3NfbmFtZRgCIAEoCRITCgtpbnN0YW5jZV9pZBgDIAEoBRIlCgRpbmZvGAQgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdBIpCgVsaW5rcxgFIAMoCzIaLmR4b3MudHJhY2luZy5SZXNvdXJjZUxpbmsSJQoHbWV0cmljcxgGIAMoCzIULmR4b3MudHJhY2luZy5NZXRyaWMiVQoMUmVzb3VyY2VMaW5rEgwKBGZyb20YASABKAUSCgoCdG8YAiABKAUSKwoKYXR0cmlidXRlcxgEIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3Qi2gEKBFNwYW4SCgoCaWQYASABKAUSFgoJcGFyZW50X2lkGAIgASgFSACIAQESGAoLcmVzb3VyY2VfaWQYAyABKAVIAYgBARITCgttZXRob2RfbmFtZRgEIAEoCRIQCghzdGFydF90cxgFIAEoCRITCgZlbmRfdHMYBiABKAlIAogBARIlCgVlcnJvchgLIAEoCzIRLmR4b3MuZXJyb3IuRXJyb3JIA4gBAUIMCgpfcGFyZW50X2lkQg4KDF9yZXNvdXJjZV9pZEIJCgdfZW5kX3RzQggKBl9lcnJvciLeAwoQU3RyZWFtVHJhY2VFdmVudBJECg5yZXNvdXJjZV9hZGRlZBgBIAMoCzIsLmR4b3MudHJhY2luZy5TdHJlYW1UcmFjZUV2ZW50LlJlc291cmNlQWRkZWQSSAoQcmVzb3VyY2VfcmVtb3ZlZBgCIAMoCzIuLmR4b3MudHJhY2luZy5TdHJlYW1UcmFjZUV2ZW50LlJlc291cmNlUmVtb3ZlZBI8CgpzcGFuX2FkZGVkGAMgAygLMiguZHhvcy50cmFjaW5nLlN0cmVhbVRyYWNlRXZlbnQuU3BhbkFkZGVkEjoKCWxvZ19hZGRlZBgEIAMoCzInLmR4b3MudHJhY2luZy5TdHJlYW1UcmFjZUV2ZW50LkxvZ0FkZGVkGjkKDVJlc291cmNlQWRkZWQSKAoIcmVzb3VyY2UYASABKAsyFi5keG9zLnRyYWNpbmcuUmVzb3VyY2UaHQoPUmVzb3VyY2VSZW1vdmVkEgoKAmlkGAEgASgFGi0KCVNwYW5BZGRlZBIgCgRzcGFuGAEgASgLMhIuZHhvcy50cmFjaW5nLlNwYW4aNwoITG9nQWRkZWQSKwoDbG9nGAEgASgLMh4uZHhvcy5jbGllbnQuc2VydmljZXMuTG9nRW50cnkiyQUKBk1ldHJpYxIMCgRuYW1lGAEgASgJEi8KB2NvdW50ZXIYZCABKAsyHC5keG9zLnRyYWNpbmcuTWV0cmljLkNvdW50ZXJIABI2Cgt0aW1lX3NlcmllcxhlIAEoCzIfLmR4b3MudHJhY2luZy5NZXRyaWMuVGltZVNlcmllc0gAEjoKDW11bHRpX2NvdW50ZXIYZiABKAsyIS5keG9zLnRyYWNpbmcuTWV0cmljLk11bHRpQ291bnRlckgAEi4KBmN1c3RvbRjHASABKAsyGy5keG9zLnRyYWNpbmcuTWV0cmljLkN1c3RvbUgAGjYKB0NvdW50ZXISDQoFdmFsdWUYASABKAESEgoFdW5pdHMYAiABKAlIAIgBAUIICgZfdW5pdHMajQEKDE11bHRpQ291bnRlchI5CgdyZWNvcmRzGAEgAygLMiguZHhvcy50cmFjaW5nLk1ldHJpYy5NdWx0aUNvdW50ZXIuUmVjb3JkEhIKBXVuaXRzGAIgASgJSACIAQEaJAoGUmVjb3JkEgsKA2tleRgBIAEoCRINCgV2YWx1ZRgCIAEoAUIICgZfdW5pdHMa1gEKClRpbWVTZXJpZXMSNQoGdHJhY2tzGAEgAygLMiUuZHhvcy50cmFjaW5nLk1ldHJpYy5UaW1lU2VyaWVzLlRyYWNrGhYKBVBvaW50Eg0KBXZhbHVlGAEgASgBGnkKBVRyYWNrEgwKBG5hbWUYASABKAkSEgoFdW5pdHMYAiABKAlIAIgBARI1CgZwb2ludHMYCiADKAsyJS5keG9zLnRyYWNpbmcuTWV0cmljLlRpbWVTZXJpZXMuUG9pbnQSDQoFdG90YWwYCyABKAFCCAoGX3VuaXRzGjIKBkN1c3RvbRIoCgdwYXlsb2FkGAEgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdEIHCgVWYWx1ZSpGCgpUcmFjZUxldmVsEgwKCERJU0FCTEVEEAASDgoKUFJPRFVDVElPThAKEg8KC0RFVkVMT1BNRU5UEBQSCQoFREVCVUcQHjJZCg5UcmFjaW5nU2VydmljZRJHCgtTdHJlYW1UcmFjZRIWLmdvb2dsZS5wcm90b2J1Zi5FbXB0eRoeLmR4b3MudHJhY2luZy5TdHJlYW1UcmFjZUV2ZW50MAFiBnByb3RvMw", [file_google_protobuf_struct, file_google_protobuf_empty, file_dxos_error, file_dxos_client_logging]);
+  fileDesc("ChJkeG9zL3RyYWNpbmcucHJvdG8SDGR4b3MudHJhY2luZyK4AQoIUmVzb3VyY2USCgoCaWQYASABKAUSEgoKY2xhc3NfbmFtZRgCIAEoCRITCgtpbnN0YW5jZV9pZBgDIAEoBRIlCgRpbmZvGAQgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdBIpCgVsaW5rcxgFIAMoCzIaLmR4b3MudHJhY2luZy5SZXNvdXJjZUxpbmsSJQoHbWV0cmljcxgGIAMoCzIULmR4b3MudHJhY2luZy5NZXRyaWMiVQoMUmVzb3VyY2VMaW5rEgwKBGZyb20YASABKAUSCgoCdG8YAiABKAUSKwoKYXR0cmlidXRlcxgEIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3QiyQUKBk1ldHJpYxIMCgRuYW1lGAEgASgJEi8KB2NvdW50ZXIYZCABKAsyHC5keG9zLnRyYWNpbmcuTWV0cmljLkNvdW50ZXJIABI2Cgt0aW1lX3NlcmllcxhlIAEoCzIfLmR4b3MudHJhY2luZy5NZXRyaWMuVGltZVNlcmllc0gAEjoKDW11bHRpX2NvdW50ZXIYZiABKAsyIS5keG9zLnRyYWNpbmcuTWV0cmljLk11bHRpQ291bnRlckgAEi4KBmN1c3RvbRjHASABKAsyGy5keG9zLnRyYWNpbmcuTWV0cmljLkN1c3RvbUgAGjYKB0NvdW50ZXISDQoFdmFsdWUYASABKAESEgoFdW5pdHMYAiABKAlIAIgBAUIICgZfdW5pdHMajQEKDE11bHRpQ291bnRlchI5CgdyZWNvcmRzGAEgAygLMiguZHhvcy50cmFjaW5nLk1ldHJpYy5NdWx0aUNvdW50ZXIuUmVjb3JkEhIKBXVuaXRzGAIgASgJSACIAQEaJAoGUmVjb3JkEgsKA2tleRgBIAEoCRINCgV2YWx1ZRgCIAEoAUIICgZfdW5pdHMa1gEKClRpbWVTZXJpZXMSNQoGdHJhY2tzGAEgAygLMiUuZHhvcy50cmFjaW5nLk1ldHJpYy5UaW1lU2VyaWVzLlRyYWNrGhYKBVBvaW50Eg0KBXZhbHVlGAEgASgBGnkKBVRyYWNrEgwKBG5hbWUYASABKAkSEgoFdW5pdHMYAiABKAlIAIgBARI1CgZwb2ludHMYCiADKAsyJS5keG9zLnRyYWNpbmcuTWV0cmljLlRpbWVTZXJpZXMuUG9pbnQSDQoFdG90YWwYCyABKAFCCAoGX3VuaXRzGjIKBkN1c3RvbRIoCgdwYXlsb2FkGAEgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdEIHCgVWYWx1ZSpGCgpUcmFjZUxldmVsEgwKCERJU0FCTEVEEAASDgoKUFJPRFVDVElPThAKEg8KC0RFVkVMT1BNRU5UEBQSCQoFREVCVUcQHmIGcHJvdG8z", [file_google_protobuf_struct, file_google_protobuf_empty, file_dxos_error, file_dxos_client_logging]);
 
 /**
  * @generated from message dxos.tracing.Resource
@@ -87,155 +84,6 @@ export type ResourceLink = Message<"dxos.tracing.ResourceLink"> & {
 export const ResourceLinkSchema: GenMessage<ResourceLink> = /*@__PURE__*/
   messageDesc(file_dxos_tracing, 1);
 
-/**
- * @generated from message dxos.tracing.Span
- */
-export type Span = Message<"dxos.tracing.Span"> & {
-  /**
-   * @generated from field: int32 id = 1;
-   */
-  id: number;
-
-  /**
-   * @generated from field: optional int32 parent_id = 2;
-   */
-  parentId?: number;
-
-  /**
-   * @generated from field: optional int32 resource_id = 3;
-   */
-  resourceId?: number;
-
-  /**
-   * @generated from field: string method_name = 4;
-   */
-  methodName: string;
-
-  /**
-   * TODO(dmaretskyi): Figure out proper sub-millisecond timestamp type.
-   *
-   * @generated from field: string start_ts = 5;
-   */
-  startTs: string;
-
-  /**
-   * @generated from field: optional string end_ts = 6;
-   */
-  endTs?: string;
-
-  /**
-   * @generated from field: optional dxos.error.Error error = 11;
-   */
-  error?: Error;
-};
-
-/**
- * Describes the message dxos.tracing.Span.
- * Use `create(SpanSchema)` to create a new message.
- */
-export const SpanSchema: GenMessage<Span> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 2);
-
-/**
- * @generated from message dxos.tracing.StreamTraceEvent
- */
-export type StreamTraceEvent = Message<"dxos.tracing.StreamTraceEvent"> & {
-  /**
-   * @generated from field: repeated dxos.tracing.StreamTraceEvent.ResourceAdded resource_added = 1;
-   */
-  resourceAdded: StreamTraceEvent_ResourceAdded[];
-
-  /**
-   * @generated from field: repeated dxos.tracing.StreamTraceEvent.ResourceRemoved resource_removed = 2;
-   */
-  resourceRemoved: StreamTraceEvent_ResourceRemoved[];
-
-  /**
-   * @generated from field: repeated dxos.tracing.StreamTraceEvent.SpanAdded span_added = 3;
-   */
-  spanAdded: StreamTraceEvent_SpanAdded[];
-
-  /**
-   * @generated from field: repeated dxos.tracing.StreamTraceEvent.LogAdded log_added = 4;
-   */
-  logAdded: StreamTraceEvent_LogAdded[];
-};
-
-/**
- * Describes the message dxos.tracing.StreamTraceEvent.
- * Use `create(StreamTraceEventSchema)` to create a new message.
- */
-export const StreamTraceEventSchema: GenMessage<StreamTraceEvent> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 3);
-
-/**
- * @generated from message dxos.tracing.StreamTraceEvent.ResourceAdded
- */
-export type StreamTraceEvent_ResourceAdded = Message<"dxos.tracing.StreamTraceEvent.ResourceAdded"> & {
-  /**
-   * @generated from field: dxos.tracing.Resource resource = 1;
-   */
-  resource?: Resource;
-};
-
-/**
- * Describes the message dxos.tracing.StreamTraceEvent.ResourceAdded.
- * Use `create(StreamTraceEvent_ResourceAddedSchema)` to create a new message.
- */
-export const StreamTraceEvent_ResourceAddedSchema: GenMessage<StreamTraceEvent_ResourceAdded> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 3, 0);
-
-/**
- * @generated from message dxos.tracing.StreamTraceEvent.ResourceRemoved
- */
-export type StreamTraceEvent_ResourceRemoved = Message<"dxos.tracing.StreamTraceEvent.ResourceRemoved"> & {
-  /**
-   * @generated from field: int32 id = 1;
-   */
-  id: number;
-};
-
-/**
- * Describes the message dxos.tracing.StreamTraceEvent.ResourceRemoved.
- * Use `create(StreamTraceEvent_ResourceRemovedSchema)` to create a new message.
- */
-export const StreamTraceEvent_ResourceRemovedSchema: GenMessage<StreamTraceEvent_ResourceRemoved> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 3, 1);
-
-/**
- * @generated from message dxos.tracing.StreamTraceEvent.SpanAdded
- */
-export type StreamTraceEvent_SpanAdded = Message<"dxos.tracing.StreamTraceEvent.SpanAdded"> & {
-  /**
-   * @generated from field: dxos.tracing.Span span = 1;
-   */
-  span?: Span;
-};
-
-/**
- * Describes the message dxos.tracing.StreamTraceEvent.SpanAdded.
- * Use `create(StreamTraceEvent_SpanAddedSchema)` to create a new message.
- */
-export const StreamTraceEvent_SpanAddedSchema: GenMessage<StreamTraceEvent_SpanAdded> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 3, 2);
-
-/**
- * @generated from message dxos.tracing.StreamTraceEvent.LogAdded
- */
-export type StreamTraceEvent_LogAdded = Message<"dxos.tracing.StreamTraceEvent.LogAdded"> & {
-  /**
-   * @generated from field: dxos.client.services.LogEntry log = 1;
-   */
-  log?: LogEntry;
-};
-
-/**
- * Describes the message dxos.tracing.StreamTraceEvent.LogAdded.
- * Use `create(StreamTraceEvent_LogAddedSchema)` to create a new message.
- */
-export const StreamTraceEvent_LogAddedSchema: GenMessage<StreamTraceEvent_LogAdded> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 3, 3);
-
 /**
  * @generated from message dxos.tracing.Metric
  */
@@ -280,7 +128,7 @@ export type Metric = Message<"dxos.tracing.Metric"> & {
  * Use `create(MetricSchema)` to create a new message.
  */
 export const MetricSchema: GenMessage<Metric> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 4);
+  messageDesc(file_dxos_tracing, 2);
 
 /**
  * @generated from message dxos.tracing.Metric.Counter
@@ -302,7 +150,7 @@ export type Metric_Counter = Message<"dxos.tracing.Metric.Counter"> & {
  * Use `create(Metric_CounterSchema)` to create a new message.
  */
 export const Metric_CounterSchema: GenMessage<Metric_Counter> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 4, 0);
+  messageDesc(file_dxos_tracing, 2, 0);
 
 /**
  * @generated from message dxos.tracing.Metric.MultiCounter
@@ -324,7 +172,7 @@ export type Metric_MultiCounter = Message<"dxos.tracing.Metric.MultiCounter"> &
  * Use `create(Metric_MultiCounterSchema)` to create a new message.
  */
 export const Metric_MultiCounterSchema: GenMessage<Metric_MultiCounter> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 4, 1);
+  messageDesc(file_dxos_tracing, 2, 1);
 
 /**
  * @generated from message dxos.tracing.Metric.MultiCounter.Record
@@ -346,7 +194,7 @@ export type Metric_MultiCounter_Record = Message<"dxos.tracing.Metric.MultiCount
  * Use `create(Metric_MultiCounter_RecordSchema)` to create a new message.
  */
 export const Metric_MultiCounter_RecordSchema: GenMessage<Metric_MultiCounter_Record> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 4, 1, 0);
+  messageDesc(file_dxos_tracing, 2, 1, 0);
 
 /**
  * @generated from message dxos.tracing.Metric.TimeSeries
@@ -363,7 +211,7 @@ export type Metric_TimeSeries = Message<"dxos.tracing.Metric.TimeSeries"> & {
  * Use `create(Metric_TimeSeriesSchema)` to create a new message.
  */
 export const Metric_TimeSeriesSchema: GenMessage<Metric_TimeSeries> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 4, 2);
+  messageDesc(file_dxos_tracing, 2, 2);
 
 /**
  * @generated from message dxos.tracing.Metric.TimeSeries.Point
@@ -380,7 +228,7 @@ export type Metric_TimeSeries_Point = Message<"dxos.tracing.Metric.TimeSeries.Po
  * Use `create(Metric_TimeSeries_PointSchema)` to create a new message.
  */
 export const Metric_TimeSeries_PointSchema: GenMessage<Metric_TimeSeries_Point> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 4, 2, 0);
+  messageDesc(file_dxos_tracing, 2, 2, 0);
 
 /**
  * @generated from message dxos.tracing.Metric.TimeSeries.Track
@@ -412,7 +260,7 @@ export type Metric_TimeSeries_Track = Message<"dxos.tracing.Metric.TimeSeries.Tr
  * Use `create(Metric_TimeSeries_TrackSchema)` to create a new message.
  */
 export const Metric_TimeSeries_TrackSchema: GenMessage<Metric_TimeSeries_Track> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 4, 2, 1);
+  messageDesc(file_dxos_tracing, 2, 2, 1);
 
 /**
  * @generated from message dxos.tracing.Metric.Custom
@@ -429,7 +277,7 @@ export type Metric_Custom = Message<"dxos.tracing.Metric.Custom"> & {
  * Use `create(Metric_CustomSchema)` to create a new message.
  */
 export const Metric_CustomSchema: GenMessage<Metric_Custom> = /*@__PURE__*/
-  messageDesc(file_dxos_tracing, 4, 3);
+  messageDesc(file_dxos_tracing, 2, 3);
 
 /**
  * @generated from enum dxos.tracing.TraceLevel
@@ -462,18 +310,3 @@ export enum TraceLevel {
 export const TraceLevelSchema: GenEnum<TraceLevel> = /*@__PURE__*/
   enumDesc(file_dxos_tracing, 0);
 
-/**
- * @generated from service dxos.tracing.TracingService
- */
-export const TracingService: GenService<{
-  /**
-   * @generated from rpc dxos.tracing.TracingService.StreamTrace
-   */
-  streamTrace: {
-    methodKind: "server_streaming";
-    input: typeof EmptySchema;
-    output: typeof StreamTraceEventSchema;
-  },
-}> = /*@__PURE__*/
-  serviceDesc(file_dxos_tracing, 0);
-

package/src/edge/EdgeFunctionEnv.ts

@@ -5,8 +5,8 @@
 import { type SpaceId } from '@dxos/keys';
 
 import type * as FeedProtocol from '../FeedProtocol';
-import { type CreateDocumentRequest, type CreateDocumentResponse } from '../proto/gen/dxos/echo/service';
 import { type QueryRequest, type QueryResponse } from '../proto/gen/dxos/echo/query';
+import { type CreateDocumentResponse } from '../proto/gen/dxos/echo/service';
 
 /*
 
@@ -79,7 +79,11 @@ export interface DataService {
   getDocument(ctx: TraceContext, spaceId: SpaceId, documentId: string): Promise<RpcResult<RawDocument | undefined>>;
 
   execQuery(ctx: TraceContext, request: QueryRequest): Promise<RpcResult<QueryResponse>>;
-  createDocument(ctx: TraceContext, request: CreateDocumentRequest): Promise<RpcResult<CreateDocumentResponse>>;
+  createDocument(
+    ctx: TraceContext,
+    spaceId: SpaceId,
+    initialValue?: Record<string, any>,
+  ): Promise<RpcResult<CreateDocumentResponse>>;
 
   // TODO(burdon): Update? Return DocumentEntry?
   changeDocument(ctx: TraceContext, spaceId: SpaceId, documentId: string, changes: Uint8Array): Promise<void>;

package/src/edge/edge.ts

@@ -8,6 +8,11 @@ import { BaseError } from '@dxos/errors';
 import { invariant } from '@dxos/invariant';
 import { SpaceId } from '@dxos/keys';
 
+/**
+ * HTTP header sent on every Edge request to classify traffic for metering.
+ */
+export const EDGE_CLIENT_TAG_HEADER = 'X-DXOS-Client-Tag';
+
 // TODO(burdon): Rename EdgerRouterEndpoint.
 // If we would rename it, we need to be careful to not break composer production.
 export enum EdgeService {
@@ -309,8 +314,14 @@ export type EdgeAuthChallenge = {
 };
 
 export enum OAuthProvider {
-  GOOGLE = 'google',
+  ATPROTO = 'atproto',
+  /** @deprecated Use ATPROTO instead. */
   BLUESKY = 'bluesky',
+  GITHUB = 'github',
+  GOOGLE = 'google',
+  LINEAR = 'linear',
+  SLACK = 'slack',
+  TRELLO = 'trello',
 }
 
 export const InitiateOAuthFlowRequestSchema = Schema.Struct({
@@ -491,3 +502,109 @@ export const EdgeHttpErrorCodec = Object.freeze({
     return ErrorCodec.decode(body.error);
   },
 });
+
+//
+// Data management.
+//
+
+export type ListSpacesRequest = { limit?: number; cursor?: string; order?: 'asc' | 'desc' };
+export type ListSpacesResponse = {
+  spaces: SpaceActivityEntry[];
+  cursor?: string;
+  limit: number;
+};
+
+export type ListActiveIdentitiesRequest = { cursor?: string; limit?: number };
+export type ListActiveIdentitiesResponse = {
+  identities: {
+    identityKey: string;
+    haloSpaceId: string | null;
+    createdAt: string | null;
+    agentKey: string | null;
+    hasRecovery: boolean;
+  }[];
+  cursor?: string;
+  complete: boolean;
+  totalCount: number;
+};
+
+export type InspectSpaceRequest = { spaceId: string };
+export type InspectSpaceResponse = {
+  spaceId: string;
+  metadata: { createdAt: string; identityKey?: string; status?: 'active' | 'deleting' } | null;
+  members: {
+    count: number;
+    list: { identityKey: string; role?: string; agentKey?: string }[];
+  };
+  controlFeeds: {
+    replicationProgress: { [feedKey: string]: { replicated: number; processed: number } };
+  };
+  echo: {
+    dataFeeds: {
+      count: number;
+      totalBlocks: number;
+      byNamespace: { namespace: string; feeds: { feedId: string; blockCount: number }[] }[];
+    };
+    documentCount: number;
+    objectCount: number;
+    deletedObjectCount: number;
+    indexedDocumentCount: number;
+    objectsByType: { typeDxn: string; count: number }[];
+    indexerStatus: {
+      indexingInProgress: boolean;
+      cursors: { indexName: string; sourceName: string; resourceId: string | null; cursor: string | number }[];
+      totalChanges: number;
+    };
+  };
+  usageInLast30Days: {
+    lastActivity: string | null;
+    wsEvents: number;
+    httpEvents: number;
+    totalEvents: number;
+  } | null;
+  durableObjects: { type: string; doId: string }[];
+};
+
+export type InspectIdentityRequest = { identityKey: string };
+export type InspectIdentityResponse = {
+  identityKey: string;
+  agentKey: string | null;
+  haloSpaceId: string | null;
+  hasRecovery: boolean;
+  routerDoId: string;
+  agentDoId: string | null;
+  ownedFunctions: { id: string; name: string; versionCount: number }[];
+  spaces: InspectSpaceResponse[];
+};
+
+/** Matches the SerializedSpace format from @dxos/echo-db, extended with spaceId. */
+export type SpaceExportPayload = {
+  version: number;
+  timestamp: string;
+  spaceId: string;
+  objects: Record<string, unknown>[];
+};
+
+export type SpaceActivityEntry = {
+  spaceId: string;
+  lastActivity: string;
+  totalEvents: number;
+  metadata: { createdAt: string; identityKey?: string; status?: 'active' | 'deleting' } | null;
+};
+
+export type SpaceExportResult = {
+  spaceId: string;
+  downloadPath: string;
+  downloadUrl: string;
+  expiresAt: string;
+  objectCount: number;
+  sizeBytes: number;
+};
+
+export type ExportSpaceRequest = { spaceId: string; origin: string };
+
+export type DeleteSpaceRequest = { spaceId: string };
+export type DeleteSpaceResponse = { status: string; spaceId: string };
+
+export type DeleteIdentityRequest = { identityKey: string };
+export type DeleteIdentityResponse = { status: string; identityKey: string };

package/src/edge/index.ts

@@ -5,3 +5,4 @@
 export * from './edge.ts';
 export * as EdgeFunctionEnv from './EdgeFunctionEnv.ts';
 export * from './errors.ts';
+export * from './registry.ts';

package/src/edge/registry.ts

@@ -0,0 +1,125 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Schema from 'effect/Schema';
+
+/**
+ * Hydrated plugin metadata, mirroring the @dxos/app-framework `Plugin.Meta` shape.
+ *
+ * Defined locally rather than imported from @dxos/app-framework to keep the protocols
+ * package free of UI/runtime dependencies. Consumers can treat decoded values as
+ * `Plugin.Meta` directly.
+ */
+export const PluginMetaSchema = Schema.Struct({
+  id: Schema.String.pipe(Schema.nonEmptyString()),
+  name: Schema.String.pipe(Schema.nonEmptyString()),
+  description: Schema.optional(Schema.String),
+  author: Schema.optional(Schema.String),
+  homePage: Schema.optional(Schema.String),
+  source: Schema.optional(Schema.String),
+  screenshots: Schema.optional(Schema.Array(Schema.String)),
+  tags: Schema.optional(Schema.Array(Schema.String)),
+  icon: Schema.optional(Schema.String),
+  iconHue: Schema.optional(Schema.String),
+});
+export type PluginMeta = Schema.Schema.Type<typeof PluginMetaSchema>;
+
+/**
+ * Health signal the registry service attaches to a hydrated entry when a refresh fails.
+ * Clients surface the appropriate badge or filter entries based on this field.
+ */
+export const PluginHealthSchema = Schema.Literal('ok', 'release-missing', 'manifest-invalid', 'repo-unavailable');
+export type PluginHealth = Schema.Schema.Type<typeof PluginHealthSchema>;
+
+/**
+ * Filename of the entry module every plugin must publish at the root of its bundle.
+ * The host dynamic-imports `<manifest URL base>/index.mjs` directly — no per-plugin
+ * configuration. `composerPlugin` outputs the bundle under this name so plugin authors
+ * never have to think about it.
+ */
+export const PLUGIN_ENTRY_FILENAME = 'index.mjs';
+
+/**
+ * Shape of the manifest-asset JSON the registry service fetches from each plugin's latest release.
+ *
+ * Emitted by `@dxos/app-framework/vite-plugin`'s `composerPlugin` (see
+ * `MANIFEST_ASSET_NAME`). Lists every file the plugin needs at runtime — the entry
+ * module ({@link PLUGIN_ENTRY_FILENAME}) plus any sibling CSS, code-split chunks,
+ * fonts, etc. — so the host can eagerly precache the whole bundle for offline use.
+ * Paths in `assets` are relative to the manifest's URL.
+ */
+export const PluginManifestSchema = Schema.Struct({
+  ...PluginMetaSchema.fields,
+  /** Plugin version (semver). Sourced from the publishing project's `package.json`. */
+  version: Schema.String.pipe(Schema.nonEmptyString()),
+  /**
+   * Relative paths of every file the plugin needs at runtime, including the entry.
+   * Must include {@link PLUGIN_ENTRY_FILENAME}; consumers verify on parse.
+   */
+  assets: Schema.Array(Schema.String).pipe(Schema.minItems(1)),
+});
+export type PluginManifest = Schema.Schema.Type<typeof PluginManifestSchema>;
+
+/**
+ * Single hydrated plugin entry returned by the registry service.
+ */
+export const PluginEntrySchema = Schema.Struct({
+  /** GitHub repository in `owner/name` form. Empty string for entries sourced from a `manifestUrl`. */
+  repo: Schema.String,
+  /** Plugin metadata from the repo's latest-release `manifest.json`. */
+  meta: PluginMetaSchema,
+  /**
+   * URL of the plugin's `manifest.json`. Composer's URL loader fetches this, eagerly caches
+   * every declared asset via the platform `PluginAssetCache`, then dynamic-imports the entry.
+   * The URL must be CORS-safe and have its declared assets reachable as siblings.
+   */
+  moduleUrl: Schema.String,
+  /** Release tag the entry was resolved from (e.g. `v0.1.0`). Empty string for `manifestUrl` entries. */
+  releaseTag: Schema.String,
+  /** Health signal set by the service when an entry fails to refresh. */
+  health: PluginHealthSchema,
+  /** Unix ms when this entry was last successfully hydrated. */
+  hydratedAt: Schema.Number,
+});
+export type PluginEntry = Schema.Schema.Type<typeof PluginEntrySchema>;
+
+/**
+ * Response body of `GET /registry/plugins`.
+ */
+export const GetPluginsResponseBodySchema = Schema.Struct({
+  /** Wire-format schema version, pinned to 1. */
+  version: Schema.Literal(1),
+  /** Hydrated entries. Order matches the order in the upstream catalog manifest. */
+  plugins: Schema.Array(PluginEntrySchema),
+  /** Unix ms timestamp of the most recent successful refresh cycle. */
+  refreshedAt: Schema.Number,
+});
+export type GetPluginsResponseBody = Schema.Schema.Type<typeof GetPluginsResponseBodySchema>;
+
+/**
+ * A catalog entry. Two flavours:
+ *  - `{ repo }`: the registry service hydrates from the GitHub repo's latest release.
+ *    Used by the production catalog.
+ *  - `{ manifestUrl }`: the registry service skips GitHub and fetches the manifest directly.
+ *    Used for local development against an in-progress plugin (e.g. served by `vite preview`)
+ *    so authors can iterate without publishing a release.
+ */
+export const RegistryEntrySchema = Schema.Union(
+  Schema.Struct({ repo: Schema.String.pipe(Schema.nonEmptyString()) }),
+  Schema.Struct({ manifestUrl: Schema.String.pipe(Schema.nonEmptyString()) }),
+);
+export type RegistryEntry = Schema.Schema.Type<typeof RegistryEntrySchema>;
+
+/**
+ * Shape of the catalog manifest published in the upstream community-plugins repo.
+ * Extra keys (e.g. `$schema`) are permitted.
+ */
+export const RegistryManifestSchema = Schema.Struct(
+  {
+    version: Schema.Literal(1),
+    plugins: Schema.Array(RegistryEntrySchema),
+  },
+  Schema.Record({ key: Schema.String, value: Schema.Unknown }),
+);
+export type RegistryManifest = Schema.Schema.Type<typeof RegistryManifestSchema>;

package/src/errors/encoding.ts

@@ -3,7 +3,6 @@
 //
 
 import { type Error as SerializedErrorProto } from '../proto/gen/dxos/error.ts';
-
 import { reconstructError } from './helpers.ts';
 
 export const encodeError = (err: any): SerializedErrorProto => {

package/src/errors/errors.ts

@@ -6,7 +6,6 @@ import { BaseError } from '@dxos/errors';
 import { PublicKey } from '@dxos/keys';
 
 import type { ObjectId } from '../types.ts';
-
 import { registerError, registerErrorMessageContext, registerErrorNoArgs } from './helpers.ts';
 
 /**

package/src/index.ts

@@ -10,7 +10,6 @@ export * from './messenger.ts';
 export * from './profile-archive.ts';
 export * from './space-archive.ts';
 export * from './storage.ts';
-export * from './tracing.ts';
 export type * from './types.ts';
 export * as FunctionProtocol from './FunctionProtocol.ts';
 export * as FeedProtocol from './FeedProtocol.ts';

package/src/proto/dxos/client/queue.proto

@@ -2,7 +2,6 @@ syntax = "proto3";
 
 package dxos.client.services;
 
-import "google/protobuf/struct.proto";
 import "google/protobuf/empty.proto";
 
 
@@ -34,9 +33,12 @@ message QueueQuery {
 }
 
 message QueueQueryResult {
-  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.
+  repeated string objects = 1;
 
-  /// 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.
   string next_cursor = 2;
 
   string prev_cursor = 3;
@@ -50,7 +52,8 @@ message InsertIntoQueueRequest {
   string subspace_tag = 1;
   string space_id = 2;
   string queue_id = 3;
-  repeated google.protobuf.Struct objects = 4;
+  /// JSON-encoded object payloads. Each entry is a serialized ObjectJSON.
+  repeated string objects = 4;
 }
 
 message DeleteFromQueueRequest {

package/src/proto/dxos/client/services.proto

@@ -332,6 +332,8 @@ message Space {
   optional PipelineState pipeline = 3;
   optional dxos.error.Error error = 4;
   optional dxos.echo.metadata.EdgeReplicationSetting edge_replication = 6;
+  repeated string tags = 7;
+  dxos.halo.credentials.MembershipPolicy membership_policy = 8;
 
   repeated SpaceMember members = 10;
   optional dxos.keys.PublicKey creator = 11;
@@ -342,6 +344,11 @@ message Space {
 
 // TODO(burdon): Create type for epoch?
 
+message CreateSpaceRequest {
+  repeated string tags = 1;
+  dxos.halo.credentials.MembershipPolicy membership_policy = 2;
+}
+
 message UpdateSpaceRequest {
   dxos.keys.PublicKey space_key = 1;
 
@@ -436,12 +443,22 @@ message JoinBySpaceKeyRequest {
 }
 
 message SpaceArchive {
+  enum Format {
+    // Tar-based binary archive (default).
+    BINARY = 0;
+    // JSON encoding of {@link dxos.echo.db.SerializedSpace}.
+    JSON = 1;
+  }
+
   string filename = 1;
   bytes contents = 2;
+  optional Format format = 3;
 }
 
 message ExportSpaceRequest {
   string space_id = 1;
+  // Archive format to produce. Defaults to BINARY.
+  optional SpaceArchive.Format format = 2;
 }
 
 message ExportSpaceResponse {
@@ -458,7 +475,7 @@ message ImportSpaceResponse {
 }
 
 service SpacesService {
-  rpc CreateSpace(google.protobuf.Empty) returns (Space);
+  rpc CreateSpace(CreateSpaceRequest) returns (Space);
   rpc UpdateSpace(UpdateSpaceRequest) returns (google.protobuf.Empty);
   rpc QuerySpaces(google.protobuf.Empty) returns (stream QuerySpacesResponse);