@pulumi/pulumi 3.142.1-alpha.xffff19d → 3.143.0-alpha.xfd2b278

package/proto/plugin_pb.d.ts

@@ -79,3 +79,71 @@ export namespace PluginAttach {
         address: string,
     }
 }
+
+export class PackageParameterization extends jspb.Message { 
+    getName(): string;
+    setName(value: string): PackageParameterization;
+    getVersion(): string;
+    setVersion(value: string): PackageParameterization;
+    getValue(): Uint8Array | string;
+    getValue_asU8(): Uint8Array;
+    getValue_asB64(): string;
+    setValue(value: Uint8Array | string): PackageParameterization;
+
+    serializeBinary(): Uint8Array;
+    toObject(includeInstance?: boolean): PackageParameterization.AsObject;
+    static toObject(includeInstance: boolean, msg: PackageParameterization): PackageParameterization.AsObject;
+    static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+    static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+    static serializeBinaryToWriter(message: PackageParameterization, writer: jspb.BinaryWriter): void;
+    static deserializeBinary(bytes: Uint8Array): PackageParameterization;
+    static deserializeBinaryFromReader(message: PackageParameterization, reader: jspb.BinaryReader): PackageParameterization;
+}
+
+export namespace PackageParameterization {
+    export type AsObject = {
+        name: string,
+        version: string,
+        value: Uint8Array | string,
+    }
+}
+
+export class PackageDependency extends jspb.Message { 
+    getName(): string;
+    setName(value: string): PackageDependency;
+    getKind(): string;
+    setKind(value: string): PackageDependency;
+    getVersion(): string;
+    setVersion(value: string): PackageDependency;
+    getServer(): string;
+    setServer(value: string): PackageDependency;
+
+    getChecksumsMap(): jspb.Map<string, Uint8Array | string>;
+    clearChecksumsMap(): void;
+
+    hasParameterization(): boolean;
+    clearParameterization(): void;
+    getParameterization(): PackageParameterization | undefined;
+    setParameterization(value?: PackageParameterization): PackageDependency;
+
+    serializeBinary(): Uint8Array;
+    toObject(includeInstance?: boolean): PackageDependency.AsObject;
+    static toObject(includeInstance: boolean, msg: PackageDependency): PackageDependency.AsObject;
+    static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+    static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+    static serializeBinaryToWriter(message: PackageDependency, writer: jspb.BinaryWriter): void;
+    static deserializeBinary(bytes: Uint8Array): PackageDependency;
+    static deserializeBinaryFromReader(message: PackageDependency, reader: jspb.BinaryReader): PackageDependency;
+}
+
+export namespace PackageDependency {
+    export type AsObject = {
+        name: string,
+        kind: string,
+        version: string,
+        server: string,
+
+        checksumsMap: Array<[string, Uint8Array | string]>,
+        parameterization?: PackageParameterization.AsObject,
+    }
+}

package/proto/plugin_pb.js

@@ -15,6 +15,8 @@ var jspb = require('google-protobuf');
 var goog = jspb;
 var proto = { pulumirpc: { codegen: { }, testing: { } } }, global = proto;
 
+goog.exportSymbol('proto.pulumirpc.PackageDependency', null, global);
+goog.exportSymbol('proto.pulumirpc.PackageParameterization', null, global);
 goog.exportSymbol('proto.pulumirpc.PluginAttach', null, global);
 goog.exportSymbol('proto.pulumirpc.PluginDependency', null, global);
 goog.exportSymbol('proto.pulumirpc.PluginInfo', null, global);
@@ -81,6 +83,48 @@ if (goog.DEBUG && !COMPILED) {
    */
   proto.pulumirpc.PluginAttach.displayName = 'proto.pulumirpc.PluginAttach';
 }
+/**
+ * Generated by JsPbCodeGenerator.
+ * @param {Array=} opt_data Optional initial data array, typically from a
+ * server response, or constructed directly in Javascript. The array is used
+ * in place and becomes part of the constructed object. It is not cloned.
+ * If no data is provided, the constructed object will be empty, but still
+ * valid.
+ * @extends {jspb.Message}
+ * @constructor
+ */
+proto.pulumirpc.PackageParameterization = function(opt_data) {
+  jspb.Message.initialize(this, opt_data, 0, -1, null, null);
+};
+goog.inherits(proto.pulumirpc.PackageParameterization, jspb.Message);
+if (goog.DEBUG && !COMPILED) {
+  /**
+   * @public
+   * @override
+   */
+  proto.pulumirpc.PackageParameterization.displayName = 'proto.pulumirpc.PackageParameterization';
+}
+/**
+ * Generated by JsPbCodeGenerator.
+ * @param {Array=} opt_data Optional initial data array, typically from a
+ * server response, or constructed directly in Javascript. The array is used
+ * in place and becomes part of the constructed object. It is not cloned.
+ * If no data is provided, the constructed object will be empty, but still
+ * valid.
+ * @extends {jspb.Message}
+ * @constructor
+ */
+proto.pulumirpc.PackageDependency = function(opt_data) {
+  jspb.Message.initialize(this, opt_data, 0, -1, null, null);
+};
+goog.inherits(proto.pulumirpc.PackageDependency, jspb.Message);
+if (goog.DEBUG && !COMPILED) {
+  /**
+   * @public
+   * @override
+   */
+  proto.pulumirpc.PackageDependency.displayName = 'proto.pulumirpc.PackageDependency';
+}
 
 
 
@@ -594,4 +638,522 @@ proto.pulumirpc.PluginAttach.prototype.setAddress = function(value) {
 };
 
 
+
+
+
+if (jspb.Message.GENERATE_TO_OBJECT) {
+/**
+ * Creates an object representation of this proto.
+ * Field names that are reserved in JavaScript and will be renamed to pb_name.
+ * Optional fields that are not set will be set to undefined.
+ * To access a reserved field use, foo.pb_<name>, eg, foo.pb_default.
+ * For the list of reserved names please see:
+ *     net/proto2/compiler/js/internal/generator.cc#kKeyword.
+ * @param {boolean=} opt_includeInstance Deprecated. whether to include the
+ *     JSPB instance for transitional soy proto support:
+ *     http://goto/soy-param-migration
+ * @return {!Object}
+ */
+proto.pulumirpc.PackageParameterization.prototype.toObject = function(opt_includeInstance) {
+  return proto.pulumirpc.PackageParameterization.toObject(opt_includeInstance, this);
+};
+
+
+/**
+ * Static version of the {@see toObject} method.
+ * @param {boolean|undefined} includeInstance Deprecated. Whether to include
+ *     the JSPB instance for transitional soy proto support:
+ *     http://goto/soy-param-migration
+ * @param {!proto.pulumirpc.PackageParameterization} msg The msg instance to transform.
+ * @return {!Object}
+ * @suppress {unusedLocalVariables} f is only used for nested messages
+ */
+proto.pulumirpc.PackageParameterization.toObject = function(includeInstance, msg) {
+  var f, obj = {
+    name: jspb.Message.getFieldWithDefault(msg, 1, ""),
+    version: jspb.Message.getFieldWithDefault(msg, 2, ""),
+    value: msg.getValue_asB64()
+  };
+
+  if (includeInstance) {
+    obj.$jspbMessageInstance = msg;
+  }
+  return obj;
+};
+}
+
+
+/**
+ * Deserializes binary data (in protobuf wire format).
+ * @param {jspb.ByteSource} bytes The bytes to deserialize.
+ * @return {!proto.pulumirpc.PackageParameterization}
+ */
+proto.pulumirpc.PackageParameterization.deserializeBinary = function(bytes) {
+  var reader = new jspb.BinaryReader(bytes);
+  var msg = new proto.pulumirpc.PackageParameterization;
+  return proto.pulumirpc.PackageParameterization.deserializeBinaryFromReader(msg, reader);
+};
+
+
+/**
+ * Deserializes binary data (in protobuf wire format) from the
+ * given reader into the given message object.
+ * @param {!proto.pulumirpc.PackageParameterization} msg The message object to deserialize into.
+ * @param {!jspb.BinaryReader} reader The BinaryReader to use.
+ * @return {!proto.pulumirpc.PackageParameterization}
+ */
+proto.pulumirpc.PackageParameterization.deserializeBinaryFromReader = function(msg, reader) {
+  while (reader.nextField()) {
+    if (reader.isEndGroup()) {
+      break;
+    }
+    var field = reader.getFieldNumber();
+    switch (field) {
+    case 1:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setName(value);
+      break;
+    case 2:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setVersion(value);
+      break;
+    case 3:
+      var value = /** @type {!Uint8Array} */ (reader.readBytes());
+      msg.setValue(value);
+      break;
+    default:
+      reader.skipField();
+      break;
+    }
+  }
+  return msg;
+};
+
+
+/**
+ * Serializes the message to binary data (in protobuf wire format).
+ * @return {!Uint8Array}
+ */
+proto.pulumirpc.PackageParameterization.prototype.serializeBinary = function() {
+  var writer = new jspb.BinaryWriter();
+  proto.pulumirpc.PackageParameterization.serializeBinaryToWriter(this, writer);
+  return writer.getResultBuffer();
+};
+
+
+/**
+ * Serializes the given message to binary data (in protobuf wire
+ * format), writing to the given BinaryWriter.
+ * @param {!proto.pulumirpc.PackageParameterization} message
+ * @param {!jspb.BinaryWriter} writer
+ * @suppress {unusedLocalVariables} f is only used for nested messages
+ */
+proto.pulumirpc.PackageParameterization.serializeBinaryToWriter = function(message, writer) {
+  var f = undefined;
+  f = message.getName();
+  if (f.length > 0) {
+    writer.writeString(
+      1,
+      f
+    );
+  }
+  f = message.getVersion();
+  if (f.length > 0) {
+    writer.writeString(
+      2,
+      f
+    );
+  }
+  f = message.getValue_asU8();
+  if (f.length > 0) {
+    writer.writeBytes(
+      3,
+      f
+    );
+  }
+};
+
+
+/**
+ * optional string name = 1;
+ * @return {string}
+ */
+proto.pulumirpc.PackageParameterization.prototype.getName = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 1, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.pulumirpc.PackageParameterization} returns this
+ */
+proto.pulumirpc.PackageParameterization.prototype.setName = function(value) {
+  return jspb.Message.setProto3StringField(this, 1, value);
+};
+
+
+/**
+ * optional string version = 2;
+ * @return {string}
+ */
+proto.pulumirpc.PackageParameterization.prototype.getVersion = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 2, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.pulumirpc.PackageParameterization} returns this
+ */
+proto.pulumirpc.PackageParameterization.prototype.setVersion = function(value) {
+  return jspb.Message.setProto3StringField(this, 2, value);
+};
+
+
+/**
+ * optional bytes value = 3;
+ * @return {!(string|Uint8Array)}
+ */
+proto.pulumirpc.PackageParameterization.prototype.getValue = function() {
+  return /** @type {!(string|Uint8Array)} */ (jspb.Message.getFieldWithDefault(this, 3, ""));
+};
+
+
+/**
+ * optional bytes value = 3;
+ * This is a type-conversion wrapper around `getValue()`
+ * @return {string}
+ */
+proto.pulumirpc.PackageParameterization.prototype.getValue_asB64 = function() {
+  return /** @type {string} */ (jspb.Message.bytesAsB64(
+      this.getValue()));
+};
+
+
+/**
+ * optional bytes value = 3;
+ * Note that Uint8Array is not supported on all browsers.
+ * @see http://caniuse.com/Uint8Array
+ * This is a type-conversion wrapper around `getValue()`
+ * @return {!Uint8Array}
+ */
+proto.pulumirpc.PackageParameterization.prototype.getValue_asU8 = function() {
+  return /** @type {!Uint8Array} */ (jspb.Message.bytesAsU8(
+      this.getValue()));
+};
+
+
+/**
+ * @param {!(string|Uint8Array)} value
+ * @return {!proto.pulumirpc.PackageParameterization} returns this
+ */
+proto.pulumirpc.PackageParameterization.prototype.setValue = function(value) {
+  return jspb.Message.setProto3BytesField(this, 3, value);
+};
+
+
+
+
+
+if (jspb.Message.GENERATE_TO_OBJECT) {
+/**
+ * Creates an object representation of this proto.
+ * Field names that are reserved in JavaScript and will be renamed to pb_name.
+ * Optional fields that are not set will be set to undefined.
+ * To access a reserved field use, foo.pb_<name>, eg, foo.pb_default.
+ * For the list of reserved names please see:
+ *     net/proto2/compiler/js/internal/generator.cc#kKeyword.
+ * @param {boolean=} opt_includeInstance Deprecated. whether to include the
+ *     JSPB instance for transitional soy proto support:
+ *     http://goto/soy-param-migration
+ * @return {!Object}
+ */
+proto.pulumirpc.PackageDependency.prototype.toObject = function(opt_includeInstance) {
+  return proto.pulumirpc.PackageDependency.toObject(opt_includeInstance, this);
+};
+
+
+/**
+ * Static version of the {@see toObject} method.
+ * @param {boolean|undefined} includeInstance Deprecated. Whether to include
+ *     the JSPB instance for transitional soy proto support:
+ *     http://goto/soy-param-migration
+ * @param {!proto.pulumirpc.PackageDependency} msg The msg instance to transform.
+ * @return {!Object}
+ * @suppress {unusedLocalVariables} f is only used for nested messages
+ */
+proto.pulumirpc.PackageDependency.toObject = function(includeInstance, msg) {
+  var f, obj = {
+    name: jspb.Message.getFieldWithDefault(msg, 1, ""),
+    kind: jspb.Message.getFieldWithDefault(msg, 2, ""),
+    version: jspb.Message.getFieldWithDefault(msg, 3, ""),
+    server: jspb.Message.getFieldWithDefault(msg, 4, ""),
+    checksumsMap: (f = msg.getChecksumsMap()) ? f.toObject(includeInstance, undefined) : [],
+    parameterization: (f = msg.getParameterization()) && proto.pulumirpc.PackageParameterization.toObject(includeInstance, f)
+  };
+
+  if (includeInstance) {
+    obj.$jspbMessageInstance = msg;
+  }
+  return obj;
+};
+}
+
+
+/**
+ * Deserializes binary data (in protobuf wire format).
+ * @param {jspb.ByteSource} bytes The bytes to deserialize.
+ * @return {!proto.pulumirpc.PackageDependency}
+ */
+proto.pulumirpc.PackageDependency.deserializeBinary = function(bytes) {
+  var reader = new jspb.BinaryReader(bytes);
+  var msg = new proto.pulumirpc.PackageDependency;
+  return proto.pulumirpc.PackageDependency.deserializeBinaryFromReader(msg, reader);
+};
+
+
+/**
+ * Deserializes binary data (in protobuf wire format) from the
+ * given reader into the given message object.
+ * @param {!proto.pulumirpc.PackageDependency} msg The message object to deserialize into.
+ * @param {!jspb.BinaryReader} reader The BinaryReader to use.
+ * @return {!proto.pulumirpc.PackageDependency}
+ */
+proto.pulumirpc.PackageDependency.deserializeBinaryFromReader = function(msg, reader) {
+  while (reader.nextField()) {
+    if (reader.isEndGroup()) {
+      break;
+    }
+    var field = reader.getFieldNumber();
+    switch (field) {
+    case 1:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setName(value);
+      break;
+    case 2:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setKind(value);
+      break;
+    case 3:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setVersion(value);
+      break;
+    case 4:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setServer(value);
+      break;
+    case 5:
+      var value = msg.getChecksumsMap();
+      reader.readMessage(value, function(message, reader) {
+        jspb.Map.deserializeBinary(message, reader, jspb.BinaryReader.prototype.readString, jspb.BinaryReader.prototype.readBytes, null, "", "");
+         });
+      break;
+    case 6:
+      var value = new proto.pulumirpc.PackageParameterization;
+      reader.readMessage(value,proto.pulumirpc.PackageParameterization.deserializeBinaryFromReader);
+      msg.setParameterization(value);
+      break;
+    default:
+      reader.skipField();
+      break;
+    }
+  }
+  return msg;
+};
+
+
+/**
+ * Serializes the message to binary data (in protobuf wire format).
+ * @return {!Uint8Array}
+ */
+proto.pulumirpc.PackageDependency.prototype.serializeBinary = function() {
+  var writer = new jspb.BinaryWriter();
+  proto.pulumirpc.PackageDependency.serializeBinaryToWriter(this, writer);
+  return writer.getResultBuffer();
+};
+
+
+/**
+ * Serializes the given message to binary data (in protobuf wire
+ * format), writing to the given BinaryWriter.
+ * @param {!proto.pulumirpc.PackageDependency} message
+ * @param {!jspb.BinaryWriter} writer
+ * @suppress {unusedLocalVariables} f is only used for nested messages
+ */
+proto.pulumirpc.PackageDependency.serializeBinaryToWriter = function(message, writer) {
+  var f = undefined;
+  f = message.getName();
+  if (f.length > 0) {
+    writer.writeString(
+      1,
+      f
+    );
+  }
+  f = message.getKind();
+  if (f.length > 0) {
+    writer.writeString(
+      2,
+      f
+    );
+  }
+  f = message.getVersion();
+  if (f.length > 0) {
+    writer.writeString(
+      3,
+      f
+    );
+  }
+  f = message.getServer();
+  if (f.length > 0) {
+    writer.writeString(
+      4,
+      f
+    );
+  }
+  f = message.getChecksumsMap(true);
+  if (f && f.getLength() > 0) {
+    f.serializeBinary(5, writer, jspb.BinaryWriter.prototype.writeString, jspb.BinaryWriter.prototype.writeBytes);
+  }
+  f = message.getParameterization();
+  if (f != null) {
+    writer.writeMessage(
+      6,
+      f,
+      proto.pulumirpc.PackageParameterization.serializeBinaryToWriter
+    );
+  }
+};
+
+
+/**
+ * optional string name = 1;
+ * @return {string}
+ */
+proto.pulumirpc.PackageDependency.prototype.getName = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 1, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.pulumirpc.PackageDependency} returns this
+ */
+proto.pulumirpc.PackageDependency.prototype.setName = function(value) {
+  return jspb.Message.setProto3StringField(this, 1, value);
+};
+
+
+/**
+ * optional string kind = 2;
+ * @return {string}
+ */
+proto.pulumirpc.PackageDependency.prototype.getKind = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 2, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.pulumirpc.PackageDependency} returns this
+ */
+proto.pulumirpc.PackageDependency.prototype.setKind = function(value) {
+  return jspb.Message.setProto3StringField(this, 2, value);
+};
+
+
+/**
+ * optional string version = 3;
+ * @return {string}
+ */
+proto.pulumirpc.PackageDependency.prototype.getVersion = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 3, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.pulumirpc.PackageDependency} returns this
+ */
+proto.pulumirpc.PackageDependency.prototype.setVersion = function(value) {
+  return jspb.Message.setProto3StringField(this, 3, value);
+};
+
+
+/**
+ * optional string server = 4;
+ * @return {string}
+ */
+proto.pulumirpc.PackageDependency.prototype.getServer = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 4, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.pulumirpc.PackageDependency} returns this
+ */
+proto.pulumirpc.PackageDependency.prototype.setServer = function(value) {
+  return jspb.Message.setProto3StringField(this, 4, value);
+};
+
+
+/**
+ * map<string, bytes> checksums = 5;
+ * @param {boolean=} opt_noLazyCreate Do not create the map if
+ * empty, instead returning `undefined`
+ * @return {!jspb.Map<string,!(string|Uint8Array)>}
+ */
+proto.pulumirpc.PackageDependency.prototype.getChecksumsMap = function(opt_noLazyCreate) {
+  return /** @type {!jspb.Map<string,!(string|Uint8Array)>} */ (
+      jspb.Message.getMapField(this, 5, opt_noLazyCreate,
+      null));
+};
+
+
+/**
+ * Clears values from the map. The map will be non-null.
+ * @return {!proto.pulumirpc.PackageDependency} returns this
+ */
+proto.pulumirpc.PackageDependency.prototype.clearChecksumsMap = function() {
+  this.getChecksumsMap().clear();
+  return this;};
+
+
+/**
+ * optional PackageParameterization parameterization = 6;
+ * @return {?proto.pulumirpc.PackageParameterization}
+ */
+proto.pulumirpc.PackageDependency.prototype.getParameterization = function() {
+  return /** @type{?proto.pulumirpc.PackageParameterization} */ (
+    jspb.Message.getWrapperField(this, proto.pulumirpc.PackageParameterization, 6));
+};
+
+
+/**
+ * @param {?proto.pulumirpc.PackageParameterization|undefined} value
+ * @return {!proto.pulumirpc.PackageDependency} returns this
+*/
+proto.pulumirpc.PackageDependency.prototype.setParameterization = function(value) {
+  return jspb.Message.setWrapperField(this, 6, value);
+};
+
+
+/**
+ * Clears the message field making it undefined.
+ * @return {!proto.pulumirpc.PackageDependency} returns this
+ */
+proto.pulumirpc.PackageDependency.prototype.clearParameterization = function() {
+  return this.setParameterization(undefined);
+};
+
+
+/**
+ * Returns whether this field is set.
+ * @return {boolean}
+ */
+proto.pulumirpc.PackageDependency.prototype.hasParameterization = function() {
+  return jspb.Message.getField(this, 6) != null;
+};
+
+
 goog.object.extend(exports, proto.pulumirpc);

package/proto/provider_grpc_pb.js

@@ -380,7 +380,12 @@ function deserialize_pulumirpc_UpdateResponse(buffer_arg) {
 // operations on resources and invocations of functions. Resource providers are primarily managed by the Pulumi engine
 // as part of a deployment in order to interact with the cloud providers underpinning a Pulumi application.
 var ResourceProviderService = exports.ResourceProviderService = {
-  handshake: {
+  // `Handshake` is the first call made by the engine to a provider. It is used to pass the engine's address to the
+// provider so that it may establish its own connections back, and to establish protocol configuration that will be
+// used to communicate between the two parties. Providers that support `Handshake` implicitly support the set of
+// feature flags previously handled by `Configure` prior to `Handshake`'s introduction, such as secrets and resource
+// references.
+handshake: {
     path: '/pulumirpc.ResourceProvider/Handshake',
     requestStream: false,
     responseStream: false,
@@ -491,7 +496,7 @@ diffConfig: {
     responseSerialize: serialize_pulumirpc_DiffResponse,
     responseDeserialize: deserialize_pulumirpc_DiffResponse,
   },
-  // `Configure` is the final stage in configuring a provider instance. Callers supply two sets of data:
+  // `Configure` is the final stage in configuring a provider instance. Callers may supply two sets of data:
 //
 // * Provider-specific configuration, which is the set of inputs that have been validated by a previous
 //   [](pulumirpc.ResourceProvider.CheckConfig) call.
@@ -503,6 +508,19 @@ diffConfig: {
 // Providers may expect a *single* call to `Configure`. If a call to `Configure` is missing required configuration,
 // the provider may return a set of error details containing [](pulumirpc.ConfigureErrorMissingKeys) values to
 // indicate which keys are missing.
+//
+// :::{important}
+// The use of `Configure` to configure protocol features is deprecated in favour of the
+// [](pulumirpc.ResourceProvider.Handshake) method, which should be implemented by newer providers. To enable
+// compatibility between older engines and providers:
+//
+// * Callers which call `Handshake` *must* call `Configure` with flags such as `acceptSecrets` and `acceptResources`
+//   set to `true`, since these features predate the introduction of `Handshake` and thus `Handshake`-aware callers
+//   must support them. See [](pulumirpc.ConfigureRequest) for more information.
+// * Providers which implement `Handshake` *must* support flags such as `acceptSecrets` and `acceptResources`, and
+//   indicate as such by always returning `true` for these fields in [](pulumirpc.ConfigureResponse). See
+//   [](pulumirpc.ConfigureResponse) for more information.
+// :::
 configure: {
     path: '/pulumirpc.ResourceProvider/Configure',
     requestStream: false,