@dxos/protocols 0.1.41 → 0.1.45-next.45667d4

package/dist/esm/src/proto/substitutions.js

@@ -7,26 +7,26 @@ import { Timeframe } from '@dxos/timeframe';
 export const substitutions = {
     'dxos.keys.PublicKey': {
         encode: (value) => ({ data: value.asUint8Array() }),
-        decode: (value) => PublicKey.from(new Uint8Array(value.data))
+        decode: (value) => PublicKey.from(new Uint8Array(value.data)),
     },
     // TODO(dmaretskyi): Shouldn't be substituted to PublicKey.
     'dxos.keys.PrivateKey': {
         encode: (value) => ({ data: new Uint8Array(value) }),
-        decode: (value) => PublicKey.from(new Uint8Array(value.data)).asBuffer()
+        decode: (value) => PublicKey.from(new Uint8Array(value.data)).asBuffer(),
     },
     'dxos.echo.timeframe.TimeframeVector': {
         encode: (timeframe) => ({
-            frames: timeframe.frames().map(([feedKey, seq]) => ({ feedKey: feedKey.asUint8Array(), seq }))
+            frames: timeframe.frames().map(([feedKey, seq]) => ({ feedKey: feedKey.asUint8Array(), seq })),
         }),
         decode: (vector) => new Timeframe((vector.frames ?? [])
             .filter((frame) => frame.feedKey != null && frame.seq != null)
-            .map((frame) => [PublicKey.from(new Uint8Array(frame.feedKey)), frame.seq]))
-    }
+            .map((frame) => [PublicKey.from(new Uint8Array(frame.feedKey)), frame.seq])),
+    },
 };
 export default {
     ...anySubstitutions,
     ...structSubstitutions,
     ...substitutions,
-    ...timestampSubstitutions
+    ...timestampSubstitutions,
 };
 //# sourceMappingURL=substitutions.js.map

package/dist/esm/src/testing.js

@@ -20,14 +20,14 @@ export const createTestItemMutation = (objectId, key, value, timeframe = new Tim
                                 model: {
                                     '@type': 'google.protobuf.Any',
                                     typeUrl: 'todo',
-                                    value: schema.getCodecForType('example.testing.data.TestItemMutation').encode({ key, value })
-                                }
-                            }
-                        ]
-                    }
-                ]
-            }
-        }
-    }
+                                    value: schema.getCodecForType('example.testing.data.TestItemMutation').encode({ key, value }),
+                                },
+                            },
+                        ],
+                    },
+                ],
+            },
+        },
+    },
 });
 //# sourceMappingURL=testing.js.map

package/dist/esm/src/tracing.d.ts

@@ -1,9 +1,7 @@
-export declare type Command = 'begin' | 'end' | 'update';
-export declare type TraceStatus = 'ok' | 'error';
-export declare type DataType = {
-    [key: string]: any;
-};
-export declare type TracingContext = {
+export type Command = 'begin' | 'end' | 'update';
+export type TraceStatus = 'ok' | 'error';
+export type DataType = Record<string, any>;
+export type TracingContext = {
     span?: {
         id: string;
         command?: Command;
@@ -12,7 +10,7 @@ export declare type TracingContext = {
         data?: DataType;
     };
 };
-export declare type Trace = {
+export type Trace = {
     begin: (opts: {
         id: string;
         parentId?: string;

package/dist/esm/src/tracing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/tracing.ts"],"names":[],"mappings":"AAIA,oBAAY,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEjD,oBAAY,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC;AAEzC,oBAAY,QAAQ,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC;AAE9C,oBAAY,cAAc,GAAG;IAC3B,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,IAAI,CAAC,EAAE,QAAQ,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,oBAAY,KAAK,GAAG;IAClB,KAAK,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,KAAK,cAAc,CAAC;IACpF,GAAG,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,KAAK,cAAc,CAAC;IACxF,MAAM,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,KAAK,cAAc,CAAC;IACjE,KAAK,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,KAAK,cAAc,CAAC;CAChF,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAgDnB,CAAC"}
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/tracing.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC;AAEzC,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE3C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,IAAI,CAAC,EAAE,QAAQ,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,KAAK,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,KAAK,cAAc,CAAC;IACpF,GAAG,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,KAAK,cAAc,CAAC;IACxF,MAAM,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,KAAK,cAAc,CAAC;IACjE,KAAK,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,KAAK,cAAc,CAAC;CAChF,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAgDnB,CAAC"}

package/dist/esm/src/tracing.js

@@ -8,8 +8,8 @@ export const trace = {
                 command: 'begin',
                 id,
                 parent: parentId,
-                data
-            }
+                data,
+            },
         };
     },
     end: ({ id, status, data }) => {
@@ -17,9 +17,9 @@ export const trace = {
             span: {
                 command: 'end',
                 id,
-                status,
-                data
-            }
+                status: status ?? 'ok',
+                data,
+            },
         };
     },
     update: ({ id, data }) => {
@@ -27,8 +27,8 @@ export const trace = {
             span: {
                 command: 'update',
                 id,
-                data
-            }
+                data,
+            },
         };
     },
     error: ({ id, error, data }) => {
@@ -41,10 +41,10 @@ export const trace = {
                     errorMessage: error.message,
                     errorName: error.name,
                     errorStack: error.stack,
-                    ...data
-                }
-            }
+                    ...data,
+                },
+            },
         };
-    }
+    },
 };
 //# sourceMappingURL=tracing.js.map

package/dist/esm/src/tracing.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../../src/tracing.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAyBF,MAAM,CAAC,MAAM,KAAK,GAAU;IAC1B,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;QAChC,OAAO;YACL,IAAI,EAAE;gBACJ,OAAO,EAAE,OAAO;gBAChB,EAAE;gBACF,MAAM,EAAE,QAAQ;gBAChB,IAAI;aACL;SACF,CAAC;IACJ,CAAC;IAED,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;QAC5B,OAAO;YACL,IAAI,EAAE;gBACJ,OAAO,EAAE,KAAK;gBACd,EAAE;gBACF,MAAM;gBACN,IAAI;aACL;SACF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACvB,OAAO;YACL,IAAI,EAAE;gBACJ,OAAO,EAAE,QAAQ;gBACjB,EAAE;gBACF,IAAI;aACL;SACF,CAAC;IACJ,CAAC;IAED,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;QAC7B,OAAO;YACL,IAAI,EAAE;gBACJ,OAAO,EAAE,KAAK;gBACd,EAAE;gBACF,MAAM,EAAE,OAAO;gBACf,IAAI,EAAE;oBACJ,YAAY,EAAE,KAAK,CAAC,OAAO;oBAC3B,SAAS,EAAE,KAAK,CAAC,IAAI;oBACrB,UAAU,EAAE,KAAK,CAAC,KAAK;oBACvB,GAAG,IAAI;iBACR;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../../src/tracing.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAyBF,MAAM,CAAC,MAAM,KAAK,GAAU;IAC1B,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;QAChC,OAAO;YACL,IAAI,EAAE;gBACJ,OAAO,EAAE,OAAO;gBAChB,EAAE;gBACF,MAAM,EAAE,QAAQ;gBAChB,IAAI;aACL;SACF,CAAC;IACJ,CAAC;IAED,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;QAC5B,OAAO;YACL,IAAI,EAAE;gBACJ,OAAO,EAAE,KAAK;gBACd,EAAE;gBACF,MAAM,EAAE,MAAM,IAAI,IAAI;gBACtB,IAAI;aACL;SACF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACvB,OAAO;YACL,IAAI,EAAE;gBACJ,OAAO,EAAE,QAAQ;gBACjB,EAAE;gBACF,IAAI;aACL;SACF,CAAC;IACJ,CAAC;IAED,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;QAC7B,OAAO;YACL,IAAI,EAAE;gBACJ,OAAO,EAAE,KAAK;gBACd,EAAE;gBACF,MAAM,EAAE,OAAO;gBACf,IAAI,EAAE;oBACJ,YAAY,EAAE,KAAK,CAAC,OAAO;oBAC3B,SAAS,EAAE,KAAK,CAAC,IAAI;oBACrB,UAAU,EAAE,KAAK,CAAC,KAAK;oBACvB,GAAG,IAAI;iBACR;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/esm/src/types.d.ts

@@ -4,17 +4,17 @@ import { Timeframe } from '@dxos/timeframe';
 import { TYPES } from './proto';
 import { FeedMessage, CredentialsMessage } from './proto/gen/dxos/echo/feed';
 import { EchoObjectBatch } from './proto/gen/dxos/echo/object';
-export declare type TypedMessage = TypedProtoMessage<TYPES>;
-export declare type FeedMeta = {
+export type TypedMessage = TypedProtoMessage<TYPES>;
+export type FeedMeta = {
     feedKey: PublicKey;
     seq: number;
 };
-export declare type FeedBlock<T> = {
+export type FeedBlock<T> = {
     feedKey: PublicKey;
     seq: number;
     data: T;
 };
-export declare type FeedMessageBlock = FeedBlock<FeedMessage>;
+export type FeedMessageBlock = FeedBlock<FeedMessage>;
 export interface MutationMeta extends FeedMeta {
     memberKey: PublicKey;
 }
@@ -29,6 +29,6 @@ export interface IEchoStream {
     meta: MutationMetaWithTimeframe;
     batch: EchoObjectBatch;
 }
-export declare type ItemID = string;
-export declare type ItemType = string;
+export type ItemID = string;
+export type ItemType = string;
 //# sourceMappingURL=types.d.ts.map

package/dist/esm/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,oBAAY,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAGpD,oBAAY,QAAQ,GAAG;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,oBAAY,SAAS,CAAC,CAAC,IAAI;IACzB,OAAO,EAAE,SAAS,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,CAAC,CAAC;CACT,CAAC;AAEF,oBAAY,gBAAgB,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;AAEtD,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,yBAA0B,SAAQ,YAAY;IAC7D,SAAS,EAAE,SAAS,CAAC;CACtB;AAGD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAGD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,yBAAyB,CAAC;IAChC,KAAK,EAAE,eAAe,CAAC;CACxB;AAGD,oBAAY,MAAM,GAAG,MAAM,CAAC;AAC5B,oBAAY,QAAQ,GAAG,MAAM,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,MAAM,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAGpD,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IACzB,OAAO,EAAE,SAAS,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,CAAC,CAAC;CACT,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;AAEtD,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,yBAA0B,SAAQ,YAAY;IAC7D,SAAS,EAAE,SAAS,CAAC;CACtB;AAGD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAGD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,yBAAyB,CAAC;IAChC,KAAK,EAAE,eAAe,CAAC;CACxB;AAGD,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAC5B,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/protocols",
-  "version": "0.1.41",
+  "version": "0.1.45-next.45667d4",
   "description": "Protobuf definitions for DXOS protocols.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -33,10 +33,10 @@
     "src"
   ],
   "dependencies": {
-    "@dxos/codec-protobuf": "0.1.41",
-    "@dxos/hypercore": "0.1.41",
-    "@dxos/keys": "0.1.41",
-    "@dxos/timeframe": "0.1.41"
+    "@dxos/codec-protobuf": "0.1.45-next.45667d4",
+    "@dxos/hypercore": "0.1.45-next.45667d4",
+    "@dxos/keys": "0.1.45-next.45667d4",
+    "@dxos/timeframe": "0.1.45-next.45667d4"
   },
   "devDependencies": {
     "@types/debug": "^4.1.7",

package/src/codec.test.ts

@@ -15,7 +15,7 @@ describe('Codec', () => {
     // TODO(burdon): Test substitutions.
     const buffer = codec.encode({
       key: 'key-1',
-      value: 'value-1'
+      value: 'value-1',
     });
 
     const { key, value } = codec.decode(buffer);

package/src/errors.ts

@@ -0,0 +1,80 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Error as SerializedErrorProto } from './proto/gen/dxos/error';
+
+export const encodeError = (err: any): SerializedErrorProto => {
+  if (typeof err === 'object' && err?.message) {
+    return {
+      name: err.name,
+      message: err.message,
+      stack: err.stack,
+    };
+  } else if (typeof err === 'string') {
+    return {
+      message: err,
+    };
+  } else {
+    return {
+      message: JSON.stringify(err),
+    };
+  }
+};
+
+export type DecodeOptions = {
+  appendStack?: string;
+};
+
+export const decodeError = (err: SerializedErrorProto, { appendStack }: DecodeOptions = {}): Error => {
+  let error: Error;
+  switch (err.name) {
+    case 'RpcClosedError':
+      error = new RpcClosedError();
+      break;
+    case 'RpcNotOpenError':
+      error = new RpcNotOpenError();
+      break;
+    default:
+      error = new SerializedError(err.name ?? 'Error', err.message ?? 'Unknown Error');
+  }
+  if (appendStack) {
+    error.stack = (err.stack ?? `${error.message}\n`) + appendStack;
+  } else {
+    error.stack = err.stack;
+  }
+
+  return error;
+};
+
+/**
+ * Error that is reconstructed after being sent over the RPC boundary.
+ */
+export class SerializedError extends Error {
+  // prettier-ignore
+  constructor(
+    name: string,
+    message: string
+  ) {
+    super(message);
+    this.name = name;
+  }
+}
+
+/**
+ * Thrown when request was terminated because the RPC endpoint has been closed.
+ */
+export class RpcClosedError extends Error {
+  constructor() {
+    super('Request was terminated because the RPC endpoint is closed.');
+  }
+}
+
+/**
+ * Thrown when `request` is called when RPC has not been opened.
+ */
+export class RpcNotOpenError extends Error {
+  constructor() {
+    super('RPC has not been opened.');
+  }
+}

package/src/index.ts

@@ -6,3 +6,4 @@ export * from './proto';
 export * from './testing';
 export * from './types';
 export * from './tracing';
+export * from './errors';

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

@@ -10,6 +10,8 @@ import "dxos/config.proto";
 import "dxos/halo/credentials.proto";
 import "dxos/mesh/teleport/gossip.proto";
 import "dxos/keys.proto";
+import "dxos/echo/metadata.proto";
+import "dxos/error.proto";
 
 // TODO(burdon): Reorganize packages (e.g., client.services, echo.database).
 
@@ -151,9 +153,21 @@ enum SpaceState {
 
   /// Data pipeline is ready.
   READY = 3;
+
+  /// Space errored.
+  ERROR = 5;
 }
 
 message Space {
+  message Metrics {
+    optional google.protobuf.Timestamp open = 1;
+    optional google.protobuf.Timestamp pipeline_init_begin = 2;
+    optional google.protobuf.Timestamp control_pipeline_ready = 3;
+    optional google.protobuf.Timestamp data_pipeline_open = 4;
+    optional google.protobuf.Timestamp data_pipeline_ready = 5;
+    optional google.protobuf.Timestamp ready = 6;
+  }
+
   // TODO(dmaretskyi): Consider merging with space metadata records.
   // TODO(dmaretskyi): ...or split into two separate pipeline messages.
   message PipelineState {
@@ -194,9 +208,13 @@ message Space {
   SpaceState state = 2;
   optional PipelineState pipeline = 3;
 
+  optional dxos.error.Error error = 4;
+
   repeated SpaceMember members = 10;
 
-  // TODO(dmaretskyi): Inline a snapshot of space.properties here so that inactive spaces still display their title.
+  optional dxos.echo.metadata.SpaceCache cache = 20;
+
+  Metrics metrics = 21;
 }
 
 message UpdateSpaceRequest {
@@ -227,6 +245,10 @@ message QueryCredentialsRequest {
   dxos.keys.PublicKey space_key = 1;
 }
 
+message CreateEpochRequest {
+  dxos.keys.PublicKey space_key = 1;
+}
+
 service SpacesService {
   rpc CreateSpace(google.protobuf.Empty) returns (Space);
   rpc UpdateSpace(UpdateSpaceRequest) returns (google.protobuf.Empty);
@@ -241,6 +263,8 @@ service SpacesService {
   rpc WriteCredentials(WriteCredentialsRequest) returns (google.protobuf.Empty);
   /// Query credentials from the space control feed.
   rpc QueryCredentials(QueryCredentialsRequest) returns (stream dxos.halo.credentials.Credential);
+
+  rpc CreateEpoch(CreateEpochRequest) returns (google.protobuf.Empty);
 }
 
 //
@@ -360,24 +384,30 @@ service InvitationsService {
 // MESH
 //
 
+// TODO(wittjosiah): Rename to SwarnState?
 enum ConnectionState {
   OFFLINE = 0;
   ONLINE = 1;
 }
 
 message NetworkStatus {
-  ConnectionState state = 1;
+  message Signal {
+    string server = 1;
+    dxos.mesh.signal.SignalState state = 2;
+  }
+
+  ConnectionState swarm = 1;
+  repeated Signal signaling = 2;
 }
 
-message SetNetworkOptionsRequest {
-  ConnectionState state = 1;
+message UpdateConfigRequest {
+  ConnectionState swarm = 1;
 }
 
 // TODO(burdon): Widen API (too heavy for single feature: e.g., status).
 service NetworkService {
-  // TODO(wittjosiah): Align verbs with other services.
-  rpc SubscribeToNetworkStatus(google.protobuf.Empty) returns (stream NetworkStatus);
-  rpc SetNetworkOptions(SetNetworkOptionsRequest) returns (google.protobuf.Empty);
+  rpc UpdateConfig(UpdateConfigRequest) returns (google.protobuf.Empty);
+  rpc QueryStatus(google.protobuf.Empty) returns (stream NetworkStatus);
 }
 
 //
@@ -415,7 +445,7 @@ message LogEntry {
   string message = 2;
   optional google.protobuf.Struct context = 3;
   optional Meta meta = 4;
-  optional dxos.rpc.Error error = 5;
+  optional Error error = 5;
 }
 
 service LoggingService {

package/src/proto/dxos/devtools/host.proto

@@ -34,8 +34,11 @@ service DevtoolsHost {
   // Get client config.
   rpc GetConfig(google.protobuf.Empty) returns (GetConfigResponse);
 
+  rpc GetStorageInfo(google.protobuf.Empty) returns (StorageInfo);
   rpc ResetStorage(ResetStorageRequest) returns (google.protobuf.Empty);
 
+  rpc GetSnapshots(google.protobuf.Empty) returns (GetSnapshotsResponse);
+  
   // TODO(burdon): Single RPC with action.
   rpc EnableDebugLogging(EnableDebugLoggingRequest) returns (EnableDebugLoggingResponse);
   rpc DisableDebugLogging(EnableDebugLoggingRequest) returns (EnableDebugLoggingResponse);
@@ -84,6 +87,13 @@ message GetConfigResponse {
   string config = 1;
 }
 
+message StorageInfo {
+  string type = 1;
+  uint32 storage_usage = 2;
+  uint32 origin_usage = 3;
+  uint32 usage_quota = 4; 
+}
+
 //
 // Logging
 //
@@ -132,6 +142,15 @@ message SubscribeToCredentialMessagesResponse {
 
 message ResetStorageRequest {}
 
+message StoredSnapshotInfo {
+  string key = 1;
+  uint32 size = 2;
+}
+
+message GetSnapshotsResponse {
+  repeated StoredSnapshotInfo snapshots = 1;
+}
+
 //
 // Spaces
 //
@@ -178,6 +197,7 @@ message SubscribeToFeedsResponse {
   message Feed {
     dxos.keys.PublicKey feed_key = 1;
     int32 length = 2;
+    int32 disk_usage = 3;
   }
 
   repeated Feed feeds = 1;
@@ -259,8 +279,7 @@ message SubscribeToSignalStatusResponse {
   message SignalServer {
     string host = 1;
 
-    // SignalApi.State enum.
-    string state = 2;
+    dxos.mesh.signal.SignalState state = 2;
 
     optional string error = 3;
 

package/src/proto/dxos/echo/metadata.proto

@@ -6,6 +6,7 @@ syntax = "proto3";
 
 import "google/protobuf/timestamp.proto";
 
+import "dxos/echo/model/document.proto";
 import "dxos/echo/timeframe.proto";
 import "dxos/keys.proto";
 
@@ -29,6 +30,11 @@ message EchoMetadata {
   repeated SpaceMetadata spaces = 11;
 }
 
+message SpaceCache {
+  /// Properties snapshot.
+  optional dxos.echo.model.document.ObjectSnapshot properties = 1;
+}
+
 // TODO(dmaretskyi): Cleanup numbering.
 message SpaceMetadata {
   /// Space key.
@@ -52,7 +58,7 @@ message SpaceMetadata {
   // Latest data timeframe reached while processing space messages.
   optional timeframe.TimeframeVector data_timeframe = 5;
 
-  optional string snapshot = 7;
+  optional SpaceCache cache = 9;
 }
 
 /// Information needed to bootstrap an Identity.

package/src/proto/dxos/error.proto

@@ -0,0 +1,14 @@
+//
+// Copyright 2020 DXOS.org
+//
+
+syntax = "proto3";
+
+package dxos.error;
+
+/// Serialized error.
+message Error {
+  optional string name = 1;
+  optional string message = 2;
+  optional string stack = 3;
+}

package/src/proto/dxos/halo/credentials.proto

@@ -92,6 +92,22 @@ message AdmittedFeed {
   Designation designation = 4;
 }
 
+// [ASSERTION]: New epoch is started in the space.
+// Subject is the space.
+message Epoch {
+  /// Epoch number.
+  uint32 number = 1;
+
+  /// Id of the previous epoch. Identitfied by the credential id.
+  optional dxos.keys.PublicKey previous_id = 2;
+
+  /// Epoch start timeframe. Indexes correspond to last mutations included into the snapshot.
+  timeframe.TimeframeVector timeframe = 10;
+
+  /// Epoch start snapshot.
+  optional string snapshot_cid = 11;
+}
+
 /// [ASSERTION]: Associtaes a space that will implement Agent's HALO with an Identity.
 message HaloSpace {
   dxos.keys.PublicKey identity_key = 1;

package/src/proto/dxos/iframe.proto

@@ -13,11 +13,8 @@ package dxos.iframe;
 
 message StartRequest {
   string origin = 1;
-}
-
-/// Worker-to-iframe RPCs.
-service IframeService {
-  rpc Heartbeat(google.protobuf.Empty) returns (google.protobuf.Empty);
+  /// Key for the iframe resource lock used to determine when the service is closing.
+  optional string lock_key = 2;
 }
 
 /// Iframe-to-worker RPCs.

package/src/proto/dxos/mesh/signal.proto

@@ -58,8 +58,12 @@ message SwarmEvent {
 
 /// Goes on a Pub/Sub host topic.
 message HostEvent {
+  message AnnounceBack {
+      bytes swarm = 1;
+      SwarmEvent.PeerAvailable peer_available = 2;
+  }
   oneof event {
-    SwarmEvent.PeerAvailable peer_available = 1;
+      AnnounceBack announce_back = 1;
   }
 }
 
@@ -70,6 +74,21 @@ message PeerEvent {
   }
 }
 
+enum SignalState {
+  /// Connection is being established.
+  CONNECTING = 0;
+  /// Connection is being re-established.
+  RECONNECTING = 1;
+  /// Connected.
+  CONNECTED = 2;
+  /// Server terminated the connection. Socket will be reconnected.
+  DISCONNECTED = 3;
+  /// Server terminated the connection with an ERROR. Socket will be reconnected.
+  ERROR = 4;
+  /// Socket was closed.
+  CLOSED = 5;
+}
+
 // TOOD(burdon): Rename.
 // TODO(burdon): Reconcile with `@dxos/kube`.
 service Signal {

package/src/proto/dxos/rpc.proto

@@ -5,6 +5,7 @@
 syntax = "proto3";
 
 import "google/protobuf/any.proto";
+import "dxos/error.proto";
 
 // TODO(burdon): Move to `dxos.mesh.rpc` (reconcile with @dxos/kube repo).
 package dxos.rpc;
@@ -36,7 +37,7 @@ message Response {
   int32 id = 1;
   oneof content {
     google.protobuf.Any payload = 2;
-    Error error = 3;
+    dxos.error.Error error = 3;
     /// Sent when stream is closed without an error.
     bool close = 4;
 
@@ -55,12 +56,6 @@ message StreamClose {
   int32 id = 1;
 }
 
-message Error {
-  optional string name = 1;
-  optional string message = 2;
-  optional string stack = 3;
-}
-
 // TODO(burdon): Rename Trace.
 message MessageTrace {
   enum Direction {

package/src/proto/gen/dxos/bot.ts

@@ -13,6 +13,7 @@ import * as dxos_echo_object from "./echo/object";
 import * as dxos_echo_service from "./echo/service";
 import * as dxos_echo_snapshot from "./echo/snapshot";
 import * as dxos_echo_timeframe from "./echo/timeframe";
+import * as dxos_error from "./error";
 import * as dxos_gravity from "./gravity";
 import * as dxos_halo_credentials from "./halo/credentials";
 import * as dxos_halo_credentials_auth from "./halo/credentials/auth";