@dxos/protocols 0.8.4-main.fffef41 → 0.8.4-staging.60fe92afc8

package/dist/src/FeedProtocol.js

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

package/dist/src/FeedProtocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedProtocol.js","sourceRoot":"","sources":["../../src/FeedProtocol.ts"],"names":[],"mappings":"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"}

package/dist/src/FunctionProtocol.d.ts

@@ -1,7 +1,9 @@
 import { type SpaceId } from '@dxos/keys';
 import type * as QueryProto from '@dxos/protocols/proto/dxos/echo/query';
 import type * as DataProto from '@dxos/protocols/proto/dxos/echo/service';
-import { type QueueService } from './queue';
+import { type EdgeFunctionEnv } from './edge';
+import type * as FeedProtocol from './FeedProtocol';
+import type * as TraceProtocol from './TraceProtocol';
 /**
  * Function implementation.
  * This is a contract between the user-defined function and the runtime.
@@ -57,7 +59,18 @@ export interface Context {
          * Queue service.
          * Available if the function is invoked in context of a space.
          */
-        queueService?: QueueService;
+        queueService?: FeedProtocol.QueueService;
+        /**
+         * Functions service.
+         * 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;
     };
     /**
      * That space that the function is invoked in context of.

package/dist/src/FunctionProtocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FunctionProtocol.d.ts","sourceRoot":"","sources":["../../src/FunctionProtocol.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,KAAK,UAAU,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,KAAK,SAAS,MAAM,yCAAyC,CAAC;AAE1E,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAa5C;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE;QACR;;;WAGG;QACH,YAAY,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC;QAEvC;;;WAGG;QACH,WAAW,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC;QAEpC;;;WAGG;QACH,YAAY,CAAC,EAAE,YAAY,CAAC;KAI7B,CAAC;IAEF;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"FunctionProtocol.d.ts","sourceRoot":"","sources":["../../src/FunctionProtocol.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,KAAK,UAAU,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,KAAK,SAAS,MAAM,yCAAyC,CAAC;AAE1E,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,KAAK,YAAY,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,KAAK,aAAa,MAAM,iBAAiB,CAAC;AAWtD;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE;QACR;;;WAGG;QACH,YAAY,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC;QAEvC;;;WAGG;QACH,WAAW,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC;QAEpC;;;WAGG;QACH,YAAY,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC;QAEzC;;;WAGG;QACH,kBAAkB,CAAC,EAAE,eAAe,CAAC,kBAAkB,CAAC;QAExD;;;WAGG;QACH,gBAAgB,CAAC,EAAE,eAAe,CAAC,gBAAgB,CAAC;QAEpD,YAAY,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC;KAC3C,CAAC;IAEF;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/src/TraceProtocol.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=TraceProtocol.d.ts.map

package/dist/src/TraceProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceProtocol.d.ts","sourceRoot":"","sources":["../../src/TraceProtocol.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;CACf"}

package/dist/src/TraceProtocol.js

@@ -0,0 +1,4 @@
+//
+// Copyright 2026 DXOS.org
+//
+//# sourceMappingURL=TraceProtocol.js.map

package/dist/src/TraceProtocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceProtocol.js","sourceRoot":"","sources":["../../src/TraceProtocol.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE"}

package/dist/src/automerge.d.ts

@@ -1,6 +1,20 @@
+/**
+ * Opaque identifier of a peer participating in automerge-repo sync.
+ *
+ * Branded `string` so it cannot be accidentally confused with arbitrary
+ * strings. Matches the `PeerId` type exported by `@automerge/automerge-repo`.
+ */
 export type PeerId = string & {
     __peerId: true;
 };
+/**
+ * Sent by a peer when joining a connection.
+ *
+ * @remarks
+ * Upstream automerge-repo: first frame after `peer-candidate` to negotiate
+ * supported protocol versions. The other side responds with a
+ * {@link PeerProtocolMessage} containing the selected version.
+ */
 export type JoinProtocolMessage = {
     type: 'join';
     targetId?: PeerId;
@@ -8,12 +22,26 @@ export type JoinProtocolMessage = {
     supportedProtocolVersions: string;
     metadata?: Record<string, unknown>;
 };
+/**
+ * Sent by a peer when leaving a connection.
+ *
+ * @remarks
+ * Upstream automerge-repo: signals graceful disconnect so the remote tears
+ * down its sync state for this peer before the underlying transport closes.
+ */
 export type LeaveProtocolMessage = {
     type: 'leave';
     targetId?: PeerId;
     senderId: PeerId;
     metadata?: Record<string, unknown>;
 };
+/**
+ * Sent in response to a {@link JoinProtocolMessage} confirming the handshake
+ * and the selected protocol version.
+ *
+ * @remarks
+ * Upstream automerge-repo: completes the version negotiation handshake.
+ */
 export type PeerProtocolMessage = {
     type: 'peer';
     senderId: PeerId;
@@ -25,8 +53,10 @@ export type PeerProtocolMessage = {
  * Sent by a {@link Repo} to request a document from a peer.
  *
  * @remarks
- * This is identical to a {@link SyncMessage} except that it is sent by a {@link Repo}
- * as the initial sync message when asking the other peer if it has the document.
+ * Upstream automerge-repo: identical wire shape to {@link SyncProtocolMessage}
+ * except this is the initial sync message used when asking the other peer if
+ * it has the document. The peer replies with sync messages or
+ * {@link UnavailableProtocolMessage}.
  */
 export type RequestProtocolMessage = {
     type: 'request';
@@ -37,7 +67,12 @@ export type RequestProtocolMessage = {
     metadata?: Record<string, unknown>;
 };
 /**
- * A sync message for a particular document
+ * Automerge sync message for a particular document.
+ *
+ * @remarks
+ * Upstream automerge-repo: carries the binary delta produced by Automerge's
+ * sync algorithm (`Automerge.generateSyncMessage`). Symmetric: peers exchange
+ * sync messages until both sides have converged.
  */
 export type SyncProtocolMessage = {
     type: 'sync';
@@ -48,8 +83,12 @@ export type SyncProtocolMessage = {
     metadata?: Record<string, unknown>;
 };
 /**
- * Sent by a {@link Repo} to indicate that it does not have the document and none of its connected
- * peers do either.
+ * Sent by a {@link Repo} to indicate that it does not have the document and
+ * none of its connected peers do either.
+ *
+ * @remarks
+ * Upstream automerge-repo: terminates a {@link RequestProtocolMessage} fan-out
+ * when no peer in the cluster can serve the document.
  */
 export type UnavailableProtocolMessage = {
     type: 'doc-unavailable';
@@ -59,16 +98,17 @@ export type UnavailableProtocolMessage = {
     metadata?: Record<string, unknown>;
 };
 /**
- * An ephemeral message.
+ * An ephemeral message gossiped between peers.
  *
  * @remarks
- * Ephemeral messages are not persisted anywhere. The data property can be used by the application
- * as needed. The repo gossips these around.
+ * Upstream automerge-repo: ephemeral messages are not persisted anywhere.
+ * The `data` property can be used by the application as needed. The repo
+ * gossips these around.
  *
- * In order to avoid infinite loops of ephemeral messages, every message has (a) a session ID, which
- * is a random number generated by the sender at startup time; and (b) a sequence number. The
- * combination of these two things allows us to discard messages we have already seen.
- * */
+ * To avoid infinite loops, every message carries (a) a `sessionId` randomly
+ * generated by the sender at startup time and (b) a sequence number
+ * (`count`). The pair lets receivers discard messages they have already seen.
+ */
 export type EphemeralProtocolMessage = {
     type: 'ephemeral';
     senderId: PeerId;
@@ -79,14 +119,96 @@ export type EphemeralProtocolMessage = {
     data: Uint8Array;
     metadata?: Record<string, unknown>;
 };
+/** Wire literal for {@link ErrorProtocolMessage}. */
+export declare const MESSAGE_TYPE_ERROR = "error";
+/**
+ * Out-of-band error reported by a peer.
+ *
+ * @remarks
+ * Upstream automerge-repo: surfaces protocol-level failures (e.g. version
+ * mismatch, malformed frame). `senderId` and `targetId` are optional so the
+ * frame can be emitted before the handshake completes.
+ *
+ * The `connectionId` field is a DXOS extension carried on the subduction
+ * channel only. Edge → client errors with `connectionId` are restart signals
+ * for a specific {@link EdgeSubductionReplicatorConnection} lifetime; the
+ * client matches it against its local `_connectionId` and tears down only
+ * that connection. The field is optional so the same type can carry
+ * upstream-style classical-channel errors that have no connection identity.
+ */
 export type ErrorProtocolMessage = {
-    type: 'error';
+    type: typeof MESSAGE_TYPE_ERROR;
     senderId?: PeerId;
     targetId?: PeerId;
     message: string;
+    connectionId?: string;
     metadata?: Record<string, unknown>;
 };
+/** Wire literal for {@link SubductionConnectionMessage}. */
+export declare const MESSAGE_TYPE_SUBDUCTION_CONNECTION = "subduction-connection";
+/** Wire literal for {@link SubductionFrameEnvelope}. */
+export declare const MESSAGE_TYPE_SUBDUCTION_FRAME = "subduction-frame";
+/**
+ * Inner subduction transport frame emitted by automerge-repo's
+ * `NetworkAdapterTransport.#sendFrame`.
+ *
+ * @remarks
+ * Owned by upstream `@automerge/automerge-subduction`: `data` is an opaque
+ * byte blob (handshake bytes prefixed with `SUH\0`, or post-handshake
+ * sedimentree messages prefixed with `SUM\0`); DXOS code MUST NOT inspect
+ * `data`.
+ *
+ * The literal value `'subduction-connection'` matches the
+ * `SUBDUCTION_MESSAGE_TYPE` constant in
+ * `@automerge/automerge-repo/src/subduction/network.ts`. Do not redefine the
+ * value; if upstream renames it, update {@link MESSAGE_TYPE_SUBDUCTION_CONNECTION}.
+ *
+ * On the Edge subduction channel this frame never appears top-level — it is
+ * always wrapped in a {@link SubductionFrameEnvelope}. In-memory subduction
+ * adapters carry it directly.
+ */
+export type SubductionConnectionMessage = {
+    type: typeof MESSAGE_TYPE_SUBDUCTION_CONNECTION;
+    senderId: PeerId;
+    targetId: PeerId;
+    data: Uint8Array;
+    metadata?: Record<string, unknown>;
+};
+/**
+ * DXOS-specific wire envelope around a {@link SubductionConnectionMessage}.
+ *
+ * @remarks
+ * Specific to the DXOS edge subduction channel; not used by upstream
+ * automerge-repo or in-memory subduction adapters.
+ *
+ * Carries the originator's `connectionId` (the value of
+ * `EdgeSubductionReplicatorConnection._connectionId` on the client, and of
+ * the matching `ClientSession` on the edge). The edge uses `connectionId` as
+ * the session key and echoes it back on every outbound reply.
+ *
+ * Frames whose `connectionId` does not match the local connection's UUID are
+ * stale (e.g. left over from a previous lifetime after
+ * `_onRestartRequested` rotated the UUID) and MUST be dropped on receipt.
+ */
+export type SubductionFrameEnvelope = {
+    type: typeof MESSAGE_TYPE_SUBDUCTION_FRAME;
+    connectionId: string;
+    subductionFrame: SubductionConnectionMessage;
+};
+/** Wire literal for {@link CollectionQueryMessage}. */
 export declare const MESSAGE_TYPE_COLLECTION_QUERY = "collection-query";
+/**
+ * Request the remote peer's view of a collection.
+ *
+ * @remarks
+ * DXOS-specific. Sent by `CollectionSynchronizer` to ask a peer for the set
+ * of document heads it has for a given `collectionId`. The peer replies with
+ * a {@link CollectionStateMessage}.
+ *
+ * If the requester already has a `stateTag` from a previous reply, the peer
+ * MAY skip sending the state when its current tag matches (no change since
+ * the last query).
+ */
 export type CollectionQueryMessage = {
     type: typeof MESSAGE_TYPE_COLLECTION_QUERY;
     senderId: PeerId;
@@ -99,7 +221,21 @@ export type CollectionQueryMessage = {
     stateTag?: string;
     metadata?: Record<string, unknown>;
 };
+/** Wire literal for {@link CollectionStateMessage}. */
 export declare const MESSAGE_TYPE_COLLECTION_STATE = "collection-state";
+/**
+ * Reply to a {@link CollectionQueryMessage} carrying the responder's view of
+ * a collection.
+ *
+ * @remarks
+ * DXOS-specific. The `state` payload shape is implementation-defined — today
+ * it is a `{ documents: Record<DocumentId, Heads[]> }` map produced by the
+ * edge from `Subduction.getAllHeads()`, but the type leaves this open for
+ * alternative encodings.
+ *
+ * `stateTag` lets the requester short-circuit future queries when nothing
+ * has changed (see {@link CollectionQueryMessage.stateTag}).
+ */
 export type CollectionStateMessage = {
     type: typeof MESSAGE_TYPE_COLLECTION_STATE;
     senderId: PeerId;
@@ -115,5 +251,59 @@ export type CollectionStateMessage = {
     stateTag?: string;
     metadata?: Record<string, unknown>;
 };
+/**
+ * Union of every message that flows through the **classical automerge-repo**
+ * sync channel (`EchoEdgeReplicator`, in-memory `TestAdapter`).
+ *
+ * @remarks
+ * Combines the upstream automerge-repo sync messages (join / leave / peer /
+ * request / sync / doc-unavailable / ephemeral / error) with DXOS's
+ * collection-sync extension (collection-query / collection-state).
+ *
+ * Does NOT include subduction transport frames or the reconnect marker —
+ * those live on a separate channel; see {@link SubductionProtocolMessage}.
+ */
 export type AutomergeProtocolMessage = JoinProtocolMessage | PeerProtocolMessage | LeaveProtocolMessage | RequestProtocolMessage | SyncProtocolMessage | UnavailableProtocolMessage | EphemeralProtocolMessage | ErrorProtocolMessage | CollectionQueryMessage | CollectionStateMessage;
+/**
+ * Union of every message that flows through the subduction channel **in
+ * process** — i.e. between automerge-repo's `NetworkAdapterTransport` and the
+ * DXOS adapter / replicator layer, before wire encoding.
+ *
+ * @remarks
+ * Distinct from {@link AutomergeProtocolMessage}, which describes the classical
+ * automerge-repo sync protocol carried by `EchoEdgeReplicator` (mesh sync,
+ * in-memory test adapters). The subduction channel multiplexes:
+ *
+ *   - opaque transport frames ({@link SubductionConnectionMessage}) produced
+ *     by `@automerge/automerge-repo/subduction/network.ts`;
+ *   - DXOS collection sync messages ({@link CollectionQueryMessage} /
+ *     {@link CollectionStateMessage});
+ *   - edge-initiated restart signals ({@link ErrorProtocolMessage} carrying
+ *     the offending `connectionId`).
+ *
+ * The {@link SubductionFrameEnvelope} is intentionally NOT a member: it only
+ * exists on the wire to attach a `connectionId` to a raw
+ * {@link SubductionConnectionMessage}. See {@link SubductionProtocolMessageEnveloped}
+ * for the corresponding wire union.
+ */
+export type SubductionProtocolMessage = CollectionQueryMessage | CollectionStateMessage | SubductionConnectionMessage | ErrorProtocolMessage;
+/**
+ * Union of every message that flows over the **Edge subduction byte channel
+ * wire** (`EdgeService.SUBDUCTION_REPLICATOR`), i.e. the cbor-encoded payload
+ * of a `RouterMessage` targeting the subduction service.
+ *
+ * @remarks
+ * The wire counterpart of {@link SubductionProtocolMessage} — identical except
+ * that {@link SubductionConnectionMessage} is replaced by
+ * {@link SubductionFrameEnvelope}, which wraps it together with the originator's
+ * `connectionId` so the peer can drop stale frames from previous connection
+ * lifetimes.
+ *
+ * The wrap/unwrap happens at the
+ * {@link EdgeSubductionReplicatorConnection} boundary on the client and the
+ * matching `SubductionTransport` boundary on the edge. Other code paths (the
+ * in-memory `TestAdapter` pair, in-process subduction adapter) carry
+ * {@link SubductionProtocolMessage} directly without ever building an envelope.
+ */
+export type SubductionProtocolMessageEnveloped = CollectionQueryMessage | CollectionStateMessage | SubductionFrameEnvelope | ErrorProtocolMessage;
 //# sourceMappingURL=automerge.d.ts.map

package/dist/src/automerge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automerge.d.ts","sourceRoot":"","sources":["../../src/automerge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"automerge.d.ts","sourceRoot":"","sources":["../../src/automerge.ts"],"names":[],"mappings":"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"}

package/dist/src/automerge.js

@@ -1,6 +1,23 @@
 //
 // Copyright 2024 DXOS.org
 //
+/** Wire literal for {@link ErrorProtocolMessage}. */
+export const MESSAGE_TYPE_ERROR = 'error';
+// ─── Subduction transport / control protocol ──────────────────────────────────
+// Frames produced and consumed by `@automerge/automerge-repo`'s subduction
+// transport bridge (`NetworkAdapterTransport`) plus the DXOS-side envelope
+// and reconnect marker. Carried by the Edge subduction channel
+// (`EdgeService.SUBDUCTION_REPLICATOR`) and the in-memory subduction adapter.
+/** Wire literal for {@link SubductionConnectionMessage}. */
+export const MESSAGE_TYPE_SUBDUCTION_CONNECTION = 'subduction-connection';
+/** Wire literal for {@link SubductionFrameEnvelope}. */
+export const MESSAGE_TYPE_SUBDUCTION_FRAME = 'subduction-frame';
+// ─── DXOS collection sync protocol ────────────────────────────────────────────
+// DXOS extension on top of the automerge-repo Message type, used by
+// `CollectionSynchronizer` to negotiate per-collection sync state. Carried
+// by both the classical and subduction channels.
+/** Wire literal for {@link CollectionQueryMessage}. */
 export const MESSAGE_TYPE_COLLECTION_QUERY = 'collection-query';
+/** Wire literal for {@link CollectionStateMessage}. */
 export const MESSAGE_TYPE_COLLECTION_STATE = 'collection-state';
 //# sourceMappingURL=automerge.js.map

package/dist/src/automerge.js.map

@@ -1 +1 @@
-{"version":3,"file":"automerge.js","sourceRoot":"","sources":["../../src/automerge.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAiGF,MAAM,CAAC,MAAM,6BAA6B,GAAG,kBAAkB,CAAC;AAgBhE,MAAM,CAAC,MAAM,6BAA6B,GAAG,kBAAkB,CAAC"}
+{"version":3,"file":"automerge.js","sourceRoot":"","sources":["../../src/automerge.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAyIF,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AA0B1C,iFAAiF;AACjF,2EAA2E;AAC3E,2EAA2E;AAC3E,+DAA+D;AAC/D,8EAA8E;AAE9E,4DAA4D;AAC5D,MAAM,CAAC,MAAM,kCAAkC,GAAG,uBAAuB,CAAC;AAE1E,wDAAwD;AACxD,MAAM,CAAC,MAAM,6BAA6B,GAAG,kBAAkB,CAAC;AAmDhE,iFAAiF;AACjF,oEAAoE;AACpE,2EAA2E;AAC3E,iDAAiD;AAEjD,uDAAuD;AACvD,MAAM,CAAC,MAAM,6BAA6B,GAAG,kBAAkB,CAAC;AA4BhE,uDAAuD;AACvD,MAAM,CAAC,MAAM,6BAA6B,GAAG,kBAAkB,CAAC"}