@dxos/protocols 0.8.4-main.8360d9e660 → 0.8.4-main.8baae0fced

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

@@ -2,11 +2,12 @@
 // Copyright 2025 DXOS.org
 //
 
-import { type SpaceId } from '@dxos/keys';
+import { type DXN, type SpaceId } from '@dxos/keys';
 
 import type * as FeedProtocol from '../FeedProtocol';
-import { type CreateDocumentRequest, type CreateDocumentResponse } from '../proto/gen/dxos/echo/service';
+import type { SerializedError } from '../index';
 import { type QueryRequest, type QueryResponse } from '../proto/gen/dxos/echo/query';
+import { type CreateDocumentResponse } from '../proto/gen/dxos/echo/service';
 
 /*
 
@@ -79,7 +80,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>;
@@ -110,6 +115,42 @@ export interface FunctionsAiService {
   fetch(request: Request): Promise<RpcResult<Response>>;
 }
 
+export type FunctionInvokeOptions = {
+  spaceId?: SpaceId;
+  /**
+   * DXN string of the conversation feed (queue).
+   * Forwarded into the function context so nested operations can resolve
+   * `AiContext.Service` and related conversation-scoped services.
+   */
+  conversation?: DXN.String;
+  cpuTimeLimit?: number;
+  subrequestsLimit?: number;
+};
+
+export type FunctionInvokeResult =
+  | {
+      _kind: 'success';
+      data: unknown;
+    }
+  | {
+      _kind: 'error';
+      error: SerializedError;
+    };
+
+export interface FunctionsQuery {
+  spaceId?: SpaceId;
+}
+
+export interface FunctionsService {
+  query(query: FunctionsQuery): Promise<RpcResult<unknown[]>>; // TODO(dmaretskyi): The type is Operation.PersistentOperation[].
+
+  invoke(
+    deploymentId: string,
+    input: unknown,
+    options?: FunctionInvokeOptions,
+  ): Promise<RpcResult<FunctionInvokeResult>>;
+}
+
 export type ObjectDocumentJson = {
   type?: string;
   objectId: string;

package/src/edge/edge.ts

@@ -8,10 +8,16 @@ 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 {
   AUTOMERGE_REPLICATOR = 'automerge-replicator',
+  SUBDUCTION_REPLICATOR = 'subduction-replicator',
   /**
    * Control feed replicator (hypercore append only logs) for the space.
    */
@@ -309,8 +315,17 @@ export type EdgeAuthChallenge = {
 };
 
 export enum OAuthProvider {
-  GOOGLE = 'google',
+  ATLASSIAN = 'atlassian',
+  ATPROTO = 'atproto',
+  /** @deprecated Use ATPROTO instead. */
   BLUESKY = 'bluesky',
+  DISCORD = 'discord',
+  GITHUB = 'github',
+  GOOGLE = 'google',
+  LINEAR = 'linear',
+  NOTION = 'notion',
+  SLACK = 'slack',
+  TRELLO = 'trello',
 }
 
 export const InitiateOAuthFlowRequestSchema = Schema.Struct({
@@ -491,3 +506,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,164 @@
+//
+// 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 single published version of a plugin, as returned by the registry service's
+ * versions endpoint. Sourced from the publishing project's GitHub releases.
+ *
+ * The host treats `tag` opaquely; ordering — newest first — is the service's
+ * responsibility (typically reverse-chronological by release date).
+ */
+export const PluginVersionSchema = Schema.Struct({
+  /** Release tag (e.g. `v0.1.21`). Stable identifier for this version. */
+  tag: Schema.String.pipe(Schema.nonEmptyString()),
+  /**
+   * URL of this version's `manifest.json`. Matches the shape of {@link PluginEntrySchema.fields.moduleUrl}
+   * but pinned to a specific release rather than the latest. Composer's URL loader fetches
+   * this when the user installs / rolls back to this version.
+   */
+  moduleUrl: Schema.String.pipe(Schema.nonEmptyString()),
+  /** Unix ms when the version was released. Optional — services that lack this signal can omit. */
+  releasedAt: Schema.optional(Schema.Number),
+});
+export type PluginVersion = Schema.Schema.Type<typeof PluginVersionSchema>;
+
+/**
+ * Response body of `GET /registry/plugins/:repo/versions`.
+ *
+ * `:repo` is the GitHub `owner/name` form, URL-encoded (so `/` is escaped).
+ * Returns all hydratable releases for the repo, newest first; clients display them
+ * in the version picker for install / roll-back. Unauthenticated; same surface area
+ * as `GET /registry/plugins`.
+ */
+export const GetPluginVersionsResponseBodySchema = Schema.Struct({
+  /** Wire-format schema version, pinned to 1. */
+  version: Schema.Literal(1),
+  /** Available versions for the requested repo, newest first. */
+  versions: Schema.Array(PluginVersionSchema),
+  /** Unix ms timestamp of the most recent successful refresh cycle for this repo. */
+  refreshedAt: Schema.Number,
+});
+export type GetPluginVersionsResponseBody = Schema.Schema.Type<typeof GetPluginVersionsResponseBodySchema>;
+
+/**
+ * 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,7 @@ 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';
+export * as TraceProtocol from './TraceProtocol.ts';