@dxos/protocols 2.33.9-dev.7d11f506 → 2.33.9-dev.9bbef4e2

package/src/proto/dxos/echo/snapshot.proto

@@ -6,8 +6,8 @@ syntax = "proto3";
 
 package dxos.echo.snapshot;
 
-import "./feed.proto";
 import "../halo/keys.proto";
+import "./feed.proto";
 
 //
 // Snapshots define full party state at a given point in time.
@@ -20,10 +20,11 @@ import "../halo/keys.proto";
 
 message PartySnapshot {
   bytes partyKey = 1;
-  TimeframeVector timeframe = 2;
+  optional TimeframeVector timeframe = 2;
 
   // Unix timestamp of the snapshot creation time. For information purposes only.
-  int32 timestamp = 3;
+  // TODO(dmaretskyi): Convert to google.protobuf.Timestamp.
+  optional int32 timestamp = 3;
 
   HaloStateSnapshot halo = 11;
   // TODO(dmaretskyi): Rename to EchoSnapshot.
@@ -48,7 +49,7 @@ message DatabaseSnapshot {
 message ItemSnapshot {
   optional string itemId = 1;
   optional string itemType = 2;
-  optional string modelType = 3;
+  string modelType = 3;
   optional string modelVersion = 4;
   optional string parentId = 5;
   optional ModelSnapshot model = 6;
@@ -57,7 +58,7 @@ message ItemSnapshot {
 message LinkSnapshot {
   optional string linkId = 1;
   optional string linkType = 2;
-  optional string modelType = 3;
+  string modelType = 3;
   optional string modelVersion = 4;
   required string source = 5;
   required string target = 6;

package/src/proto/dxos/halo/auth.proto

@@ -6,25 +6,25 @@ syntax = "proto3";
 
 package dxos.credentials.auth;
 
-import "keys.proto";
-import "signed.proto";
+import "./keys.proto";
+import "./signed.proto";
 
 /**
  * The payload for a SignedMessage sent during handshake for replication authentication.
  */
 message Auth {
   /// The publicKey of the target Party for these credentials.
-  PubKey partyKey = 1;     
-  
+  PubKey partyKey = 1;
+
   /// The publicKey of the authenticating Device.
-  PubKey deviceKey = 2;    
-  
+  PubKey deviceKey = 2;
+
   /// The publicKey of the authenticating Identity.
-  PubKey identityKey = 3;  
-  
+  PubKey identityKey = 3;
+
   /// The publicKey of the authenticating Identity.
-  PubKey feedKey = 4;      
+  optional PubKey feedKey = 4;
 
   /// FeedAdmit message to the should be written to a control feed in case the `feedKey` is not admitted to the party.
-  google.protobuf.Any feed_admit = 5;
+  optional google.protobuf.Any feed_admit = 5;
 }

package/src/proto/dxos/halo/greet.proto

@@ -6,11 +6,12 @@ syntax = "proto3";
 
 package dxos.credentials.greet;
 
-import "keys.proto";
-import "party.proto";
 import "google/protobuf/any.proto";
 import "google/protobuf/wrappers.proto";
 
+import "./keys.proto";
+import "./party.proto";
+
 //
 // Greeting protocol:
 //
@@ -57,7 +58,7 @@ message Command {
   Type command = 1;
 
   // Auth secret (PIN, hash, AuthMessage, etc.).
-  bytes secret = 2;
+  optional bytes secret = 2;
 
   // TODO(burdon): These seem to be signed messages? In which case we already know the type.
   // TODO(dboreham): static typing of contained messages is not yet supported, change from any when it is.

package/src/proto/dxos/halo/identity.proto

@@ -7,18 +7,19 @@ syntax = "proto3";
 package dxos.credentials.identity;
 
 import "google/protobuf/any.proto";
-import "greet.proto";
-import "keys.proto";
-import "signed.proto";
+
+import "./greet.proto";
+import "./keys.proto";
+import "./signed.proto";
 
 // Additional, descriptive information about an Identity. Must be signed by the Identity's key.
 message IdentityInfo {
-  PubKey publicKey = 1;          // The publicKey of the Identity (must be signed by this key).
-  string displayName = 2;       // The display name to use for this key.
+  PubKey publicKey = 1;           // The publicKey of the Identity (must be signed by this key).
+  string displayName = 2;         // The display name to use for this key.
 }
 
 // Additional, descriptive information about a Device. Must be signed by the Device's key.
 message DeviceInfo {
-  PubKey publicKey = 1;          // The publicKey of the Device (must be signed by this key).
-  string displayName = 2;       // The display name to use for this key.
+  PubKey publicKey = 1;           // The publicKey of the Device (must be signed by this key).
+  string displayName = 2;         // The display name to use for this key.
 }

package/src/proto/dxos/halo/keys.proto

@@ -6,9 +6,10 @@ syntax = "proto3";
 
 package dxos.halo.keys;
 
-import "signed.proto";
 import "google/protobuf/any.proto";
 
+import "./signed.proto";
+
 //
 // The type/use of a public key.
 //
@@ -43,33 +44,33 @@ message KeyRecord {
   /**
    * The secret key as a Buffer (this will never be visible outside the Keyring).
    */
-  PrivKey secretKey = 3;
+  optional PrivKey secretKey = 3;
 
   /**
    * Is this key from a Greeting "hint"?
    */
-  bool hint = 4;
+  optional bool hint = 4;
 
   /**
    * Determines if this is our key?
    * Usually true if `secretKey` is present; may be false for "inception keys" such as the Party key.
    */
-  bool own = 5; // TODO(burdon): Rename "local" or "private".
+  optional bool own = 5; // TODO(burdon): Rename "local" or "private".
 
   /**
    * Is this key to be trusted?
    */
-  bool trusted = 6; // TODO(burdon): Rename "trust". How is this determined?
+  optional bool trusted = 6; // TODO(burdon): Rename "trust". How is this determined?
 
   /**
    * An RFC-3339 date/time string for when the key was added to the Keyring.
    */
-  string added = 7;
+  optional string added = 7;
 
   /**
    * An RFC-3339 date/time string for when the key was created.
    */
-  string created = 8;
+  optional string created = 8;
 }
 
 message KeyRecordList {

package/src/proto/dxos/halo/party.proto

@@ -6,10 +6,11 @@ syntax = "proto3";
 
 package dxos.credentials.party;
 
-import "keys.proto";
-import "signed.proto";
 import "google/protobuf/any.proto";
 
+import "./keys.proto";
+import "./signed.proto";
+
 //
 // Party Credentials are messages that, by virtue of their being signed by a key that is a
 // recognized authority, convey to the recipient that something should be allowed or done.

package/src/proto/dxos/halo/signed.proto

@@ -7,9 +7,10 @@ syntax = "proto3";
 // TODO(burdon): Rename dxos.halo?
 package dxos.credentials;
 
-import "keys.proto";
 import "google/protobuf/any.proto";
 
+import "./keys.proto";
+
 // TODO(burdon): Use default from codec-protobuf.
 message Message {
   required google.protobuf.Any payload = 1;
@@ -23,20 +24,27 @@ message SignedMessage {
   // Provides the common metadata needed for all signed objects.
   //
   message Signed {
-    required string created = 1;                    // RFC-3339 datetime string.
+    /// RFC-3339 datetime string.
+    required string created = 1;
     required bytes nonce = 2;
-    required google.protobuf.Any payload = 10;      // The payload to be signed.
+    /// The payload to be signed.
+    required google.protobuf.Any payload = 10;
   }
 
   //
   // The signature data itself.
   //
   message Signature {
-    required PubKey key = 1;                        // The publicKey of the keypair that made this signature.
-    required bytes signature = 2;                   // The bytes of the signature.
-    KeyChain keyChain = 3;                          // Optional. The certification chain of SignedMessages for this key.
+    /// The publicKey of the keypair that made this signature.
+    required PubKey key = 1;
+    /// The bytes of the signature.
+    required bytes signature = 2;
+    /// The certification chain of SignedMessages for this key.
+    optional KeyChain keyChain = 3;
   }
 
-  required Signed signed = 1;                       // The signed message contents.
-  repeated Signature signatures = 2;                // An array of Signatures, one for each key that signed the message.
+  /// The signed message contents.
+  required Signed signed = 1;
+  /// An array of Signatures, one for each key that signed the message.
+  repeated Signature signatures = 2;
 }

package/src/proto/dxos/rpc.proto

@@ -4,9 +4,11 @@
 
 syntax = "proto3";
 
+package dxos.rpc;
+
 import "google/protobuf/any.proto";
 
-package dxos.rpc;
+option go_package = "github.com/dxos/kube/go/dxrpc/pb";
 
 message RpcMessage {
   oneof content {
@@ -34,8 +36,16 @@ message Response {
   oneof content {
     google.protobuf.Any payload = 2;
     Error error = 3;
-    // Sent when stream is closed without an error.
+    /// Sent when stream is closed without an error.
     bool close = 4;
+
+    /**
+     * Sent when the server has processed a request with a streaming response.
+     *
+     * Can be skipped by the server.
+     * In this case the first payload should be treated as the server being ready.
+     */
+    bool stream_ready = 5;
   }
 }
 
@@ -45,9 +55,9 @@ message StreamClose {
 }
 
 message Error {
-  string name = 1;
-  string message = 2;
-  string stack = 3;
+  optional string name = 1;
+  optional string message = 2;
+  optional string stack = 3;
 }
 
 message MessageTrace {

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

@@ -17,6 +17,10 @@ import * as dxos_halo_keys from "./halo/keys";
 import * as dxos_rpc from "./rpc";
 import * as dxos_test_echo from "./test/echo";
 import * as google_protobuf from "../google/protobuf";
+/**
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
+ */
 export interface BotPackageSpecifier {
     /**
      * DXN of the bot in the DXNS registry.
@@ -25,21 +29,60 @@ export interface BotPackageSpecifier {
     ipfsCid?: string;
     localPath?: string;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
+ */
 export interface Bot {
-    id?: string;
+    id: string;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     status?: Bot.Status;
     /**
      * The state that the bot aims to be in. Can be only either RUNNING or STOPPED.
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     desiredState?: Bot.Status;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     attemptsToAchieveDesiredState?: number;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     packageSpecifier?: BotPackageSpecifier;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     lastStart?: google_protobuf.Timestamp;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     partyKey?: dxos_halo_keys.PubKey;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     runtime?: Bot.Runtime;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     report?: BotReport;
 }
 export namespace Bot {
+    /**
+     * Defined in:
+     *   {@link file://./../../dxos/bot.proto}
+     */
     export enum Status {
         STOPPED = 0,
         STARTING = 1,
@@ -47,47 +90,119 @@ export namespace Bot {
         STOPPING = 3,
         SPAWNING = 4
     }
+    /**
+     * Defined in:
+     *   {@link file://./../../dxos/bot.proto}
+     */
     export interface Runtime {
+        /**
+         * Options:
+         *   - proto3_optional = true
+         */
         exitCode?: number;
+        /**
+         * Options:
+         *   - proto3_optional = true
+         */
         exitSignal?: string;
+        /**
+         * Options:
+         *   - proto3_optional = true
+         */
         error?: string;
     }
 }
+/**
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
+ */
 export interface GetBotsResponse {
     bots?: Bot[];
 }
+/**
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
+ */
 export interface SpawnBotRequest {
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     package?: BotPackageSpecifier;
     /**
      * Invitation for the bot to join the target party.
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     invitation?: dxos_echo_invitation.InvitationDescriptor;
     /**
      * Key of the party bot is invited to.
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     partyKey?: dxos_halo_keys.PubKey;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
+ */
 export interface SendCommandRequest {
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     botId?: string;
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     command?: Uint8Array;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
+ */
 export interface SendCommandResponse {
+    /**
+     * Options:
+     *   - proto3_optional = true
+     */
     response?: Uint8Array;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
+ */
 export interface GetLogsResponse {
-    chunk?: Uint8Array;
+    chunk: Uint8Array;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
+ */
 export interface GetLogsRequest {
-    botId?: string;
+    botId: string;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
+ */
 export interface BotReport {
     /**
      * Details of the party the bot was spawned for.
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     partyDetails?: dxos_client.PartyDetails;
 }
 /**
  * Service that is used by clients to communicate with bot factory.
+ *
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
  */
 export interface BotFactoryService {
     getBots: (request: void) => Promise<GetBotsResponse>;
@@ -99,28 +214,48 @@ export interface BotFactoryService {
     sendCommand: (request: SendCommandRequest) => Promise<SendCommandResponse>;
     removeAll: (request: void) => Promise<void>;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
+ */
 export interface InitializeRequest {
     /**
      * Bot runtime configuration.
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     config?: dxos_config.Config;
     /**
      * Invitation for the bot to join the target party.
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     invitation?: dxos_echo_invitation.InvitationDescriptor;
     /**
      * ID of the bot.
+     *
+     * Options:
+     *   - proto3_optional = true
      */
     id?: string;
 }
+/**
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
+ */
 export interface StartRequest {
     /**
      * Bot runtime configuration.
      */
-    config?: dxos_config.Config;
+    config: dxos_config.Config;
 }
 /**
  * Service that is used by bots communicating with bot factory.
+ *
+ * Defined in:
+ *   {@link file://./../../dxos/bot.proto}
  */
 export interface BotService {
     /**