@dxos/protocols 0.8.4-main.9be5663bfe → 0.8.4-main.abd8ff62ef

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/edge.ts

@@ -314,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({

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/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

@@ -443,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 {

package/src/proto/dxos/config.proto

@@ -84,6 +84,17 @@ message Module {
 
 message Runtime {
   message Client {
+    /// Where client services run. Drives `createClientServices` routing.
+    enum ServicesMode {
+      UNSPECIFIED_SERVICES_MODE = 0;
+      /// Run services in the same thread as the client.
+      HOST = 1;
+      /// Run services in a SharedWorker (single instance shared across tabs).
+      SHARED_WORKER = 2;
+      /// Run services in a dedicated Worker elected via a lock (leader/follower).
+      DEDICATED_WORKER = 3;
+    }
+
     message Storage {
       enum StorageDriver {
         RAM = 0;
@@ -98,6 +109,20 @@ message Runtime {
         JSONDOWN = 12;
       }
 
+      /// Storage backing for SQLite (indexes & persistent state). The caller must supply the
+      /// matching worker factory / path — `createClientServices` does not pick a mode from the
+      /// presence of options.
+      enum SqliteMode {
+        UNSPECIFIED_SQLITE_MODE = 0;
+        /// Ephemeral in-memory SQLite. Indexes are rebuilt on each start.
+        MEMORY = 1;
+        /// OPFS-backed SQLite running in a dedicated worker (browser).
+        /// Requires `createOpfsWorker` to be passed to `createClientServices`.
+        OPFS = 2;
+        /// File-backed SQLite (Node/Bun). Uses `data_root` to locate the database file.
+        FILE = 3;
+      }
+
       optional bool persistent = 1;
       optional StorageDriver key_store = 2;
       optional StorageDriver data_store = 3;
@@ -107,6 +132,9 @@ message Runtime {
        * @deprecated
        */
       optional bool space_fragmentation = 5;
+
+      /// Backing store for SQLite runtimes. Defaults to MEMORY when unset.
+      optional SqliteMode sqlite_mode = 6;
     }
 
     message Log {
@@ -155,6 +183,25 @@ message Runtime {
     optional bool enable_vector_indexing = 12;
 
     optional EdgeFeatures edge_features = 11;
+
+    /// Observability group attached as metadata to signaling requests.
+    /// NOTE: When running through a shared worker, subsequent client connections can refresh this
+    /// value (last-writer-wins); the first client still determines the worker's other config.
+    optional string observability_group = 13;
+
+    /// Enable telemetry metadata attached to signaling requests.
+    /// NOTE: When running through a shared worker, subsequent client connections can refresh this
+    /// value (last-writer-wins); the first client still determines the worker's other config.
+    optional bool signal_telemetry_enabled = 14;
+
+    /// Use in-process (single-client) coordinator for dedicated-worker mode.
+    /// Bypasses SharedWorker; used for WKWebView where the coordinator SharedWorker port is unreliable.
+    optional bool single_client_mode = 15;
+
+    /// Deployment mode for client services. Read by `createClientServices` to select between
+    /// in-process (HOST), SharedWorker, and dedicated Worker runtimes. Required when no
+    /// `remote_source` is configured.
+    optional ServicesMode services_mode = 16;
   }
 
   message App {

package/src/proto/dxos/iframe.proto

@@ -15,9 +15,6 @@ message StartRequest {
   string origin = 1;
   /// Key for the iframe resource lock used to determine when the service is closing.
   optional string lock_key = 2;
-  // TODO(nf): extract or remove?
-  optional string observabilityGroup = 3;
-  optional bool signalTelemetryEnabled = 4;
 }
 
 /// Iframe-to-worker RPCs.

package/src/proto/dxos/rpc.proto

@@ -29,11 +29,18 @@ message RpcMessage {
   }
 }
 
+/// W3C trace context carried across RPC boundaries.
+message TraceContext {
+  string traceparent = 1;
+  optional string tracestate = 2;
+}
+
 message Request {
   int32 id = 1;
   string method = 2;
   google.protobuf.Any payload = 3;
   bool stream = 4;
+  optional TraceContext trace_context = 5;
 }
 
 message Response {

package/src/proto/dxos/tracing.proto

@@ -30,42 +30,6 @@ message ResourceLink {
   google.protobuf.Struct attributes = 4;
 }
 
-message Span {
-  int32 id = 1;
-  optional int32 parent_id = 2;
-  optional int32 resource_id = 3;
-  string method_name = 4;
-
-  // TODO(dmaretskyi): Figure out proper sub-millisecond timestamp type.
-  string start_ts = 5;
-  optional string end_ts = 6;
-
-  optional dxos.error.Error error = 11;
-}
-
-message StreamTraceEvent {
-  message ResourceAdded {
-    Resource resource = 1;
-  }
-
-  message ResourceRemoved {
-    int32 id = 1;
-  }
-
-  message SpanAdded {
-    Span span = 1;
-  }
-
-  message LogAdded {
-    dxos.client.services.LogEntry log = 1;
-  }
-
-  repeated ResourceAdded resource_added = 1;
-  repeated ResourceRemoved resource_removed = 2;
-  repeated SpanAdded span_added = 3;
-  repeated LogAdded log_added = 4;
-}
-
 message Metric {
   message Counter {
     double value = 1;
@@ -110,7 +74,3 @@ message Metric {
     Custom custom = 199;
   }
 }
-
-service TracingService {
-  rpc StreamTrace(google.protobuf.Empty) returns (stream StreamTraceEvent);
-}

package/src/proto/gen/dxos/agent/dashboard.ts

@@ -66,8 +66,7 @@ import * as example_testing_data from "../../example/testing/data.js";
 import * as example_testing_rpc from "../../example/testing/rpc.js";
 import * as google_protobuf from "../../google/protobuf.js";
 /**
- * Defined in:
- *   {@link file://./../../../dxos/agent/dashboard.proto}
+ * Defined in: `../../../dxos/agent/dashboard.proto`
  */
 export interface AgentStatus {
     status: AgentStatus.Status;
@@ -88,8 +87,7 @@ export namespace AgentStatus {
         OFF = 1
     }
     /**
-     * Defined in:
-     *   {@link file://./../../../dxos/agent/dashboard.proto}
+     * Defined in: `../../../dxos/agent/dashboard.proto`
      */
     export interface Memory {
         /**
@@ -104,8 +102,7 @@ export namespace AgentStatus {
     }
 }
 /**
- * Defined in:
- *   {@link file://./../../../dxos/agent/dashboard.proto}
+ * Defined in: `../../../dxos/agent/dashboard.proto`
  */
 export interface PluginState {
     id: string;