@dxos/protocols 0.6.13 → 0.6.14-main.2b6a0f3

package/src/buf/proto/gen/dxos/mesh/teleport/gossip_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2022 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/mesh/teleport/gossip.proto (package dxos.mesh.teleport.gossip, syntax proto3)
 /* eslint-disable */
 
@@ -10,8 +10,8 @@ import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegen
 import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
 import type { Any, EmptySchema, Timestamp } from "@bufbuild/protobuf/wkt";
 import { file_google_protobuf_any, file_google_protobuf_empty, file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
-import type { PublicKey } from "../../keys_pb";
-import { file_dxos_keys } from "../../keys_pb";
+import type { PublicKey } from "../../keys_pb.js";
+import { file_dxos_keys } from "../../keys_pb.js";
 import type { Message } from "@bufbuild/protobuf";
 
 /**

package/src/buf/proto/gen/dxos/mesh/teleport/notarization_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2022 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/mesh/teleport/notarization.proto (package dxos.mesh.teleport.notarization, syntax proto3)
 /* eslint-disable */
 
@@ -10,9 +10,9 @@ import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegen
 import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
 import type { EmptySchema } from "@bufbuild/protobuf/wkt";
 import { file_google_protobuf_empty } from "@bufbuild/protobuf/wkt";
-import { file_dxos_keys } from "../../keys_pb";
-import type { Credential } from "../../halo/credentials_pb";
-import { file_dxos_halo_credentials } from "../../halo/credentials_pb";
+import { file_dxos_keys } from "../../keys_pb.js";
+import type { Credential } from "../../halo/credentials_pb.js";
+import { file_dxos_halo_credentials } from "../../halo/credentials_pb.js";
 import type { Message } from "@bufbuild/protobuf";
 
 /**

package/src/buf/proto/gen/dxos/mesh/teleport/replicator_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2022 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/mesh/teleport/replicator.proto (package dxos.mesh.teleport.replicator, syntax proto3)
 /* eslint-disable */
 
@@ -10,8 +10,8 @@ import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegen
 import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
 import type { EmptySchema } from "@bufbuild/protobuf/wkt";
 import { file_google_protobuf_empty } from "@bufbuild/protobuf/wkt";
-import type { PublicKey } from "../../keys_pb";
-import { file_dxos_keys } from "../../keys_pb";
+import type { PublicKey } from "../../keys_pb.js";
+import { file_dxos_keys } from "../../keys_pb.js";
 import type { Message } from "@bufbuild/protobuf";
 
 /**

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

@@ -2,7 +2,7 @@
 // Copyright 2021 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/registry.proto (package dxos.registry, syntax proto3)
 /* eslint-disable */
 

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

@@ -2,7 +2,7 @@
 // Copyright 2020 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/rpc.proto (package dxos.rpc, syntax proto3)
 /* eslint-disable */
 
@@ -12,8 +12,8 @@ import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1"
 import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
 import type { Any } from "@bufbuild/protobuf/wkt";
 import { file_google_protobuf_any } from "@bufbuild/protobuf/wkt";
-import type { Error } from "./error_pb";
-import { file_dxos_error } from "./error_pb";
+import type { Error } from "./error_pb.js";
+import { file_dxos_error } from "./error_pb.js";
 import type { Message } from "@bufbuild/protobuf";
 
 /**

package/src/buf/proto/gen/dxos/service/agentmanager_pb.ts

@@ -2,18 +2,18 @@
 // Copyright 2022 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/service/agentmanager.proto (package dxos.service.agentmanager, syntax proto3)
 /* eslint-disable */
 
 import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv1";
 import { enumDesc, fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
 import { file_google_protobuf_any, file_google_protobuf_empty } from "@bufbuild/protobuf/wkt";
-import { file_dxos_config } from "../config_pb";
-import type { Credential, Presentation } from "../halo/credentials_pb";
-import { file_dxos_halo_credentials } from "../halo/credentials_pb";
-import type { PublicKey } from "../keys_pb";
-import { file_dxos_keys } from "../keys_pb";
+import { file_dxos_config } from "../config_pb.js";
+import type { Credential, Presentation } from "../halo/credentials_pb.js";
+import { file_dxos_halo_credentials } from "../halo/credentials_pb.js";
+import type { PublicKey } from "../keys_pb.js";
+import { file_dxos_keys } from "../keys_pb.js";
 import type { Message } from "@bufbuild/protobuf";
 
 /**

package/src/buf/proto/gen/dxos/service/publisher_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/service/publisher.proto (package dxos.service.publisher, syntax proto3)
 /* eslint-disable */
 
@@ -10,8 +10,8 @@ import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegen
 import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
 import type { EmptySchema } from "@bufbuild/protobuf/wkt";
 import { file_google_protobuf_empty } from "@bufbuild/protobuf/wkt";
-import type { Module, Package } from "../config_pb";
-import { file_dxos_config } from "../config_pb";
+import type { Module, Package } from "../config_pb.js";
+import { file_dxos_config } from "../config_pb.js";
 import type { Message } from "@bufbuild/protobuf";
 
 /**

package/src/buf/proto/gen/dxos/service/supervisor_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2022 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/service/supervisor.proto (package dxos.service.supervisor, syntax proto3)
 /* eslint-disable */
 
@@ -10,12 +10,12 @@ import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobu
 import { enumDesc, fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
 import type { EmptySchema } from "@bufbuild/protobuf/wkt";
 import { file_google_protobuf_empty } from "@bufbuild/protobuf/wkt";
-import type { Config } from "../config_pb";
-import { file_dxos_config } from "../config_pb";
-import type { Credential, Presentation } from "../halo/credentials_pb";
-import { file_dxos_halo_credentials } from "../halo/credentials_pb";
-import type { PublicKey } from "../keys_pb";
-import { file_dxos_keys } from "../keys_pb";
+import type { Config } from "../config_pb.js";
+import { file_dxos_config } from "../config_pb.js";
+import type { Credential, Presentation } from "../halo/credentials_pb.js";
+import { file_dxos_halo_credentials } from "../halo/credentials_pb.js";
+import type { PublicKey } from "../keys_pb.js";
+import { file_dxos_keys } from "../keys_pb.js";
 import type { Message } from "@bufbuild/protobuf";
 
 /**

package/src/buf/proto/gen/dxos/service/tunnel_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/service/tunnel.proto (package dxos.service.tunnel, syntax proto3)
 /* eslint-disable */
 

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

@@ -1,4 +1,4 @@
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/tracing.proto (package dxos.tracing, syntax proto3)
 /* eslint-disable */
 
@@ -6,10 +6,10 @@ import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobu
 import { enumDesc, fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
 import type { EmptySchema } from "@bufbuild/protobuf/wkt";
 import { file_google_protobuf_empty, file_google_protobuf_struct } from "@bufbuild/protobuf/wkt";
-import type { Error } from "./error_pb";
-import { file_dxos_error } from "./error_pb";
-import type { LogEntry } from "./client/logging_pb";
-import { file_dxos_client_logging } from "./client/logging_pb";
+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";
 
 /**

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

@@ -2,7 +2,7 @@
 // Copyright 2022 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/type.proto (package dxos.type, syntax proto3)
 /* eslint-disable */
 
@@ -11,8 +11,8 @@
 import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
 import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
 import { file_google_protobuf_struct } from "@bufbuild/protobuf/wkt";
-import type { Record_Extension } from "./registry_pb";
-import { file_dxos_registry } from "./registry_pb";
+import type { Record_Extension } from "./registry_pb.js";
+import { file_dxos_registry } from "./registry_pb.js";
 import type { JsonObject, Message } from "@bufbuild/protobuf";
 
 /**

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

@@ -2,7 +2,7 @@
 // Copyright 2021 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file dxos/value.proto (package dxos.value, syntax proto3)
 /* eslint-disable */
 

package/src/buf/proto/gen/example/testing/data_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2020 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file example/testing/data.proto (package example.testing.data, syntax proto3)
 /* eslint-disable */
 

package/src/buf/proto/gen/example/testing/rpc_pb.ts

@@ -2,7 +2,7 @@
 // Copyright 2020 DXOS.org
 //
 
-// @generated by protoc-gen-es v2.0.0 with parameter "target=ts"
+// @generated by protoc-gen-es v2.1.0 with parameter "target=ts,import_extension=js"
 // @generated from file example/testing/rpc.proto (package example.testing.rpc, syntax proto3)
 /* eslint-disable */
 

package/src/codec.test.ts

@@ -2,11 +2,9 @@
 // Copyright 2022 DXOS.org
 //
 
-import { expect } from 'chai';
+import { describe, expect, test } from 'vitest';
 
-import { describe, test } from '@dxos/test';
-
-import { schema } from './proto';
+import { schema } from './proto/index.js';
 
 describe('Codec', () => {
   test('encodes and decodes messages', async () => {

package/src/edge.ts

@@ -2,9 +2,179 @@
 // Copyright 2024 DXOS.org
 //
 
+import { type SpaceId } from '@dxos/keys';
+
 export enum EdgeService {
   AUTOMERGE_REPLICATOR = 'automerge-replicator',
   FEED_REPLICATOR = 'feed-replicator',
   SWARM_SERVICE_ID = 'swarm',
   SIGNAL_SERVICE_ID = 'signal',
 }
+
+export type EdgeHttpSuccess<T> = {
+  success: true;
+  data: T;
+};
+
+export type EdgeErrorData = { type: string } & Record<string, any>;
+
+export type EdgeHttpFailure = {
+  success: false;
+  /**
+   * An explanation of why the call failed. Used mostly for logging and monitoring.
+   */
+  reason: string;
+  /**
+   * Information that can be used to retry the request such that it will succeed, for example:
+   * 1. { type: 'auth_required', challenge: string }
+   *    Requires retrying the request with challenge signature included.
+   * 2. { type: 'user_confirmation_required', dialog: { title: string, message: string, confirmation_payload: string } }
+   *    Requires showing a confirmation dialog to a user and retrying the request with confirmation_payload included
+   *    if the user confirms.
+   * When errorData is returned simply retrying the request won't have any effect.
+   * EdgeHttpClient should parse well-known errorData into Error types and throw.
+   */
+  errorData?: EdgeErrorData;
+};
+
+export type EdgeHttpResponse<T> = EdgeHttpSuccess<T> | EdgeHttpFailure;
+
+export type GetNotarizationResponseBody = {
+  awaitingNotarization: { credentials: string[] };
+};
+
+export type PostNotarizationRequestBody = {
+  credentials: string[];
+};
+
+export type JoinSpaceRequest = {
+  invitationId: string;
+  identityKey: string;
+  /**
+   * Base64 encoded signed challenge.
+   * Used to verify the IdentityKey in case of `invitation.authMethod === Invitation.AuthMethod.KNOWN_PUBLIC_KEY`
+   */
+  signature?: string;
+};
+
+export type JoinSpaceResponseBody = {
+  spaceMemberCredential: string;
+  spaceGenesisFeedKey: string;
+};
+
+export type RecoverIdentityRequest = {
+  recoveryKey: string;
+  deviceKey: string;
+  controlFeedKey: string;
+  signature?: string;
+};
+
+export type RecoverIdentityResponseBody = {
+  identityKey: string;
+  haloSpaceKey: string;
+  genesisFeedKey: string;
+  deviceAuthCredential: string;
+};
+
+export type CreateAgentRequestBody = {
+  identityKey: string;
+  haloSpaceId: SpaceId;
+  haloSpaceKey: string;
+};
+
+export type CreateAgentResponseBody = {
+  deviceKey: string;
+  feedKey: string;
+};
+
+export type GetAgentStatusResponseBody = {
+  agent: {
+    deviceKey?: string;
+    status: EdgeAgentStatus;
+  };
+};
+
+export enum EdgeAgentStatus {
+  ACTIVE = 'active',
+  INACTIVE = 'inactive',
+  NOT_FOUND = 'not_found',
+}
+
+export class EdgeCallFailedError extends Error {
+  public static fromProcessingFailureCause(cause: Error) {
+    return new EdgeCallFailedError({
+      reason: 'Error processing request.',
+      isRetryable: true,
+      cause,
+    });
+  }
+
+  public static fromHttpFailure(response: Response) {
+    return new EdgeCallFailedError({
+      reason: `HTTP code ${response.status}: ${response.statusText}.`,
+      isRetryable: isRetryableCode(response.status),
+      retryAfterMs: getRetryAfterMillis(response),
+    });
+  }
+
+  public static fromUnsuccessfulResponse(response: Response, body: EdgeHttpFailure) {
+    return new EdgeCallFailedError({
+      reason: body.reason,
+      errorData: body.errorData,
+      isRetryable: body.errorData == null && response.headers.has('Retry-After'),
+      retryAfterMs: getRetryAfterMillis(response),
+    });
+  }
+
+  readonly reason: string;
+  readonly errorData?: EdgeErrorData;
+  readonly isRetryable?: boolean;
+  readonly retryAfterMs?: number;
+
+  constructor(args: {
+    reason: string;
+    isRetryable?: boolean;
+    errorData?: EdgeErrorData;
+    retryAfterMs?: number;
+    cause?: Error;
+  }) {
+    super(args.reason, { cause: args.cause });
+    this.reason = args.reason;
+    this.errorData = args.errorData;
+    this.retryAfterMs = args.retryAfterMs;
+    this.isRetryable = Boolean(args.isRetryable);
+  }
+}
+
+export class EdgeAuthChallengeError extends EdgeCallFailedError {
+  constructor(
+    public readonly challenge: string,
+    errorData: EdgeErrorData,
+  ) {
+    super({ reason: 'Auth challenge.', errorData, isRetryable: false });
+  }
+}
+
+export type EdgeAuthChallenge = {
+  type: 'auth_challenge';
+  challenge: string;
+};
+
+const getRetryAfterMillis = (response: Response) => {
+  const retryAfter = Number(response.headers.get('Retry-After'));
+  return Number.isNaN(retryAfter) || retryAfter === 0 ? undefined : retryAfter * 1000;
+};
+
+export const createRetryableHttpFailure = (args: { reason: any; retryAfterSeconds: number }) => {
+  return new Response(JSON.stringify({ success: false, reason: args.reason }), {
+    headers: { 'Retry-After': String(args.retryAfterSeconds) },
+  });
+};
+
+const isRetryableCode = (status: number) => {
+  if (status === 501) {
+    // Not Implemented
+    return false;
+  }
+  return !(status >= 400 && status < 500);
+};

package/src/errors/encoding.ts

@@ -2,8 +2,8 @@
 // Copyright 2023 DXOS.org
 //
 
-import { reconstructError } from './helpers';
-import { type Error as SerializedErrorProto } from '../proto/gen/dxos/error';
+import { reconstructError } from './helpers.js';
+import { type Error as SerializedErrorProto } from '../proto/gen/dxos/error.js';
 
 export const encodeError = (err: any): SerializedErrorProto => {
   if (typeof err === 'object' && err?.message) {

package/src/errors/errors.test.ts

@@ -2,14 +2,9 @@
 // Copyright 2022 DXOS.org
 //
 
-import chai, { expect } from 'chai';
-import chaiAsPromised from 'chai-as-promised';
+import { describe, expect, test } from 'vitest';
 
-import { describe, test } from '@dxos/test';
-
-import { ApiError } from './base-errors';
-
-chai.use(chaiAsPromised);
+import { ApiError } from './base-errors.js';
 
 describe('Errors', () => {
   test('test', async () => {
@@ -17,6 +12,6 @@ describe('Errors', () => {
       throw new ApiError('Test error');
     };
 
-    await expect(runTest()).to.be.rejectedWith('Test error');
+    await expect(runTest()).rejects.toThrowError('Test error');
   });
 });

package/src/errors/errors.ts

@@ -4,9 +4,9 @@
 
 import { PublicKey } from '@dxos/keys';
 
-import { ApiError, BaseError, DatabaseError, SystemError } from './base-errors';
-import { registerError, registerErrorMessageContext, registerErrorNoArgs } from './helpers';
-import type { ObjectId } from '../types';
+import { ApiError, BaseError, DatabaseError, SystemError } from './base-errors.js';
+import { registerError, registerErrorMessageContext, registerErrorNoArgs } from './helpers.js';
+import type { ObjectId } from '../types.js';
 
 /**
  * Thrown when request was terminated because the RPC endpoint has been closed.

package/src/errors/helpers.ts

@@ -4,8 +4,8 @@
 
 import { invariant } from '@dxos/invariant';
 
-import { SystemError } from './base-errors';
-import { type Error as SerializedErrorProto } from '../proto/gen/dxos/error';
+import { SystemError } from './base-errors.js';
+import { type Error as SerializedErrorProto } from '../proto/gen/dxos/error.js';
 
 export const reconstructError = (error: SerializedErrorProto) => {
   const { name, message, context } = error;

package/src/errors/index.ts

@@ -2,7 +2,7 @@
 // Copyright 2022 DXOS.org
 //
 
-export * from './encoding';
-export * from './errors';
-export * from './helpers';
-export * from './base-errors';
+export * from './encoding.js';
+export * from './errors.js';
+export * from './helpers.js';
+export * from './base-errors.js';

package/src/index.ts

@@ -2,12 +2,12 @@
 // Copyright 2021 DXOS.org
 //
 
-export * from './errors';
-export * from './indexing';
-export * from './storage';
-export * from './tracing';
-export * from './types';
-export * from './query';
-export * from './profile-archive';
-export * from './collection-sync';
-export * from './edge';
+export * from './errors/index.js';
+export * from './indexing.js';
+export * from './storage.js';
+export * from './tracing.js';
+export * from './types.js';
+export * from './query.js';
+export * from './profile-archive.js';
+export * from './automerge.js';
+export * from './edge.js';

package/src/indexing.test.ts

@@ -2,11 +2,9 @@
 // Copyright 2022 DXOS.org
 //
 
-import { expect } from 'chai';
+import { describe, expect, test } from 'vitest';
 
-import { describe, test } from '@dxos/test';
-
-import { ObjectPointerVersion, objectPointerCodec } from './indexing';
+import { ObjectPointerVersion, objectPointerCodec } from './indexing.js';
 
 describe('Indexing object pointer codec', () => {
   test('getVersion', async () => {

package/src/invitation.ts

@@ -0,0 +1,12 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { ParamKeyAnnotation, S } from '@dxos/effect';
+
+// TODO(burdon): Use uniformly for processing HTTP params.
+export const InvitationUrl = S.Struct({
+  accessToken: S.String, // TODO(burdon): Remove.
+  deviceInvitationCode: S.String.pipe(ParamKeyAnnotation({ key: 'deviceInvitationCode' })),
+  spaceInvitationCode: S.String.pipe(ParamKeyAnnotation({ key: 'spaceInvitationCode' })),
+});

package/src/proto/dxos/client/invitation.proto

@@ -168,4 +168,7 @@ message Invitation {
 
   /// Role of the admitted member, defaults to ADMIN.
   optional dxos.halo.credentials.SpaceMember.Role role = 18;
+
+  /// Id of a the space to join (only present if kind is SPACE).
+  optional string space_id = 19;
 }

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

@@ -122,7 +122,11 @@ message Identity {
 }
 
 message RecoverIdentityRequest {
-  bytes recovery_key = 1;
+  string seedphrase = 1;
+}
+
+message CreateRecoveryPhraseResponse {
+  string seedphrase = 1;
 }
 
 message QueryIdentityResponse {
@@ -145,6 +149,7 @@ message CreateIdentityRequest {
 service IdentityService {
   rpc CreateIdentity(CreateIdentityRequest) returns (Identity);
   rpc RecoverIdentity(RecoverIdentityRequest) returns (Identity);
+  rpc CreateRecoveryPhrase(google.protobuf.Empty) returns (CreateRecoveryPhraseResponse);
   rpc QueryIdentity(google.protobuf.Empty) returns (stream QueryIdentityResponse);
   rpc UpdateProfile(halo.credentials.ProfileDocument) returns (Identity);
   rpc SignPresentation(SignPresentationRequest) returns (dxos.halo.credentials.Presentation);
@@ -219,6 +224,7 @@ message SpaceMember {
   dxos.halo.credentials.SpaceMember.Role role = 4;
 }
 
+
 // TODO(burdon): Rename SpaceInfo?
 message Space {
   message Metrics {
@@ -283,6 +289,7 @@ message Space {
   SpaceState state = 2;
   optional PipelineState pipeline = 3;
   optional dxos.error.Error error = 4;
+  optional dxos.echo.metadata.EdgeReplicationSetting edge_replication = 6;
 
   repeated SpaceMember members = 10;
   optional dxos.keys.PublicKey creator = 11;
@@ -298,6 +305,8 @@ message UpdateSpaceRequest {
 
   /// Allowed values: ACTIVE, INACTIVE.
   optional SpaceState state = 2;
+
+  optional dxos.echo.metadata.EdgeReplicationSetting edge_replication = 3;
 }
 
 message QuerySpacesResponse {
@@ -501,3 +510,19 @@ service NetworkService {
   rpc UpdateConfig(UpdateConfigRequest) returns (google.protobuf.Empty);
   rpc QueryStatus(google.protobuf.Empty) returns (stream NetworkStatus);
 }
+
+service EdgeAgentService {
+  rpc CreateAgent(google.protobuf.Empty) returns (google.protobuf.Empty);
+  rpc QueryAgentStatus(google.protobuf.Empty) returns (stream QueryAgentStatusResponse);
+}
+
+message QueryAgentStatusResponse {
+  enum AgentStatus {
+    UNKNOWN = 0;
+    ACTIVE = 1;
+    INACTIVE = 2;
+    NOT_FOUND = 3;
+  }
+
+  AgentStatus status = 1;
+}

package/src/proto/dxos/config.proto

@@ -119,6 +119,7 @@ message Runtime {
       optional bool feed_replicator = 1;
       optional bool echo_replicator = 2;
       optional bool signaling = 3;
+      optional bool agents = 4;
     }
 
     optional Log log = 1;