pulumi-language-ruby 0.0.1

data/pulumi/resource.proto

@@ -0,0 +1,394 @@
+// Copyright 2016-2022, Pulumi Corporation.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+import "google/protobuf/empty.proto";
+import "google/protobuf/struct.proto";
+import "pulumi/provider.proto";
+import "pulumi/alias.proto";
+import "pulumi/source.proto";
+import "pulumi/callback.proto";
+
+package pulumirpc;
+
+option go_package = "github.com/pulumi/pulumi/sdk/v3/proto/go;pulumirpc";
+
+// ResourceMonitor is the interface a source uses to talk back to the planning monitor orchestrating the execution.
+service ResourceMonitor {
+    rpc SupportsFeature(SupportsFeatureRequest) returns (SupportsFeatureResponse) {}
+    rpc Invoke(ResourceInvokeRequest) returns (InvokeResponse) {}
+    rpc Call(ResourceCallRequest) returns (CallResponse) {}
+    rpc ReadResource(ReadResourceRequest) returns (ReadResourceResponse) {}
+    rpc RegisterResource(RegisterResourceRequest) returns (RegisterResourceResponse) {}
+    rpc RegisterResourceOutputs(RegisterResourceOutputsRequest) returns (google.protobuf.Empty) {}
+
+    // Register a resource transform for the stack
+    rpc RegisterStackTransform(Callback) returns (google.protobuf.Empty) {}
+    // Register an invoke transform for the stack
+    rpc RegisterStackInvokeTransform(Callback) returns (google.protobuf.Empty) {}
+
+    // Register a resource hook that can be called by the engine during certain
+    // steps of a resource's lifecycle.
+    rpc RegisterResourceHook(RegisterResourceHookRequest) returns (google.protobuf.Empty) {}
+
+    // Register an error hook that can be called by the engine when an operation fails and is retryable.
+    //
+    // Error hooks are a separate type of hook to other life cycle hooks as they have different inputs and outputs.
+    rpc RegisterErrorHook(RegisterErrorHookRequest) returns (google.protobuf.Empty) {}
+
+    // Registers a package and allocates a packageRef. The same package can be registered multiple times in Pulumi.
+    // Multiple requests are idempotent and guaranteed to return the same result.
+    rpc RegisterPackage(RegisterPackageRequest) returns (RegisterPackageResponse) {}
+
+    // SignalAndWaitForShutdown lets the resource monitor know that no more
+    // events will be generated. This call blocks until the resource monitor is
+    // finished, which will happen once all the steps have executed. This allows
+    // the language runtime to stay running and handle callback requests, even
+    // after the user program has completed. Runtime SDKs should call this after
+    // executing the user's program. This can only be called once.
+    rpc SignalAndWaitForShutdown(google.protobuf.Empty) returns (google.protobuf.Empty) {}
+}
+
+// SupportsFeatureRequest allows a client to test if the resource monitor supports a certain feature, which it may use
+// to control the format or types of messages it sends.
+message SupportsFeatureRequest {
+    string id = 1;  // the ID of the feature to test support for.
+}
+
+message SupportsFeatureResponse {
+    bool hasSupport = 1; // true when the resource monitor supports this feature.
+}
+
+// There is a clear distinction here between the "properties" bag sent across the wire as part of these RPCs and
+// properties that exist on Pulumi resources as projected into the target language. It is important to call out that the
+// properties here are in the format that a provider will expect. This is to say that they are usually in camel case.
+// If a language wants to project properties in a format *other* than camel-case, it is the job of the language to
+// ensure that the properties are translated into camel case before invoking an RPC.
+
+// ReadResourceRequest contains enough information to uniquely qualify and read a resource's state.
+message ReadResourceRequest {
+    string id = 1;                         // the ID of the resource to read.
+    string type = 2;                       // the type of the resource object.
+    string name = 3;                       // the name, for URN purposes, of the object.
+    string parent = 4;                     // an optional parent URN that this child resource belongs to.
+    google.protobuf.Struct properties = 5; // optional state sufficient to uniquely identify the resource.
+    repeated string dependencies = 6;      // a list of URNs that this read depends on, as observed by the language host.
+    string provider = 7;                   // an optional reference to the provider to use for this read.
+    string version = 8;                    // the version of the provider to use when servicing this request.
+    bool acceptSecrets = 9;                // when true operations should return secrets as strongly typed.
+    repeated string additionalSecretOutputs = 10;   // a list of output properties that should also be treated as secret, in addition to ones we detect.
+
+    // We used to declare an alias field here, but nothing ever used it. But to ensure we don't confuse any
+    // old plugins/monitors making sure that field doesn't get reused.
+    reserved "aliases";
+    reserved 11;
+
+    bool acceptResources = 12;             // when true operations should return resource references as strongly typed.
+    string pluginDownloadURL = 13;         // the server url of the provider to use when servicing this request.
+    map<string, bytes> pluginChecksums = 15; // a map of checksums of the provider to use when servicing this request.
+
+    SourcePosition sourcePosition = 14; // the optional source position of the user code that initiated the read.
+    StackTrace stackTrace = 17;         // the optional stack trace at the time of the request.
+    string parentStackTraceHandle = 18; // the optional parent stack trace handle for the request. Supports stitching stack traces across plugins.
+
+    string packageRef = 16; // a reference from RegisterPackageRequest.
+}
+
+// ReadResourceResponse contains the result of reading a resource's state.
+message ReadResourceResponse {
+    string urn = 1;                        // the URN for this resource.
+    google.protobuf.Struct properties = 2; // the state of the resource read from the live environment.
+}
+
+// RegisterResourceRequest contains information about a resource object that was newly allocated.
+message RegisterResourceRequest {
+    // PropertyDependencies describes the resources that a particular property depends on.
+    message PropertyDependencies {
+        repeated string urns = 1; // A list of URNs this property depends on.
+    }
+    // CustomTimeouts allows a user to be able to create a set of custom timeout parameters.
+    message CustomTimeouts {
+        string create = 1; // The create resource timeout represented as a string e.g. 5m.
+        string update = 2; // The update resource timeout represented as a string e.g. 5m.
+        string delete = 3; // The delete resource timeout represented as a string e.g. 5m.
+    }
+
+    string type = 1;                                            // the type of the object allocated.
+    string name = 2;                                            // the name, for URN purposes, of the object.
+    string parent = 3;                                          // an optional parent URN that this child resource belongs to.
+    bool custom = 4;                                            // true if the resource is a custom, managed by a plugin's CRUD operations.
+    google.protobuf.Struct object = 5;                          // an object produced by the interpreter/source.
+    optional bool protect = 6;                                  // true if the resource should be marked protected.
+    repeated string dependencies = 7;                           // a list of URNs that this resource depends on, as observed by the language host.
+    string provider = 8;                                        // an optional reference to the provider to manage this resource's CRUD operations.
+    map<string, PropertyDependencies> propertyDependencies = 9; // a map from property keys to the dependencies of the property.
+    bool deleteBeforeReplace = 10;                              // true if this resource should be deleted before replacement.
+    string version = 11;                                        // the version of the provider to use when servicing this request.
+    repeated string ignoreChanges = 12;                         // a list of property selectors to ignore during updates.
+    bool acceptSecrets = 13;                                    // when true operations should return secrets as strongly typed.
+    repeated string additionalSecretOutputs = 14;               // a list of output properties that should also be treated as secret, in addition to ones we detect.
+    repeated string aliasURNs = 15;                             // a list of additional URNs that should be considered the same.
+    string importId = 16;                                       // if set, this resource's state should be imported from the given ID.
+    CustomTimeouts customTimeouts = 17;                         // ability to pass a custom Timeout block.
+    bool deleteBeforeReplaceDefined = 18;                       // true if the deleteBeforeReplace property should be treated as defined even if it is false.
+    bool supportsPartialValues = 19;                            // true if the request is from an SDK that supports partially-known properties during preview.
+    bool remote = 20;                                           // true if the resource is a plugin-managed component resource.
+    bool acceptResources = 21;                                  // when true operations should return resource references as strongly typed.
+    map<string, string> providers = 22;                         // an optional reference to the provider map to manage this resource's CRUD operations.
+    repeated string replaceOnChanges = 23;                      // a list of properties that if changed should force a replacement.
+    string pluginDownloadURL = 24;                              // the server URL of the provider to use when servicing this request.
+    map<string, bytes> pluginChecksums = 30;                    // a map of checksums expected for the provider plugin.
+    optional bool retainOnDelete = 25;                          // if true the engine will not call the resource providers delete method for this resource.
+    repeated Alias aliases = 26;                                // a list of additional aliases that should be considered the same.
+    string deletedWith = 27;                                    // if set the engine will not call the resource providers delete method for this resource when specified resource is deleted.
+    repeated string replace_with = 38;                          // if set the engine will replace this resource when any of the specified resources are replaced.
+    google.protobuf.Value replacement_trigger = 39;             // if set, the engine will diff this with the last recorded value, and trigger a replace if they are not equal.
+
+    // Indicates that alias specs are specified correctly according to the spec.
+    // Older versions of the Node.js SDK did not send alias specs correctly.
+    // If this is not set to true and the engine detects the request is from the
+    // Node.js runtime, the engine will transform incorrect alias specs into
+    // correct ones.
+    // Other SDKs that are correctly specifying alias specs could set this to
+    // true, but it's not necessary.
+    bool aliasSpecs = 28;
+
+    SourcePosition sourcePosition = 29; // the optional source position of the user code that initiated the register.
+    StackTrace stackTrace = 35;         // the optional stack trace at the time of the request.
+    string parentStackTraceHandle = 36; // the optional parent stack trace handle for the request. Supports stitching stack traces across plugins.
+
+    repeated Callback transforms = 31; // a list of transforms to apply to the resource before registering it.
+    bool supportsResultReporting = 32; // true if the request is from an SDK that supports the result field in the response.
+
+    string packageRef = 33; // a reference from RegisterPackageRequest.
+
+    message ResourceHooksBinding {
+        repeated string before_create = 1;
+        repeated string after_create = 2;
+        repeated string before_update = 3;
+        repeated string after_update = 4;
+        repeated string before_delete = 5;
+        repeated string after_delete = 6;
+        repeated string on_error = 7;
+    }
+
+    // The resource hooks that should run at certain points in the resource's lifecycle.
+    optional ResourceHooksBinding hooks = 34;
+    repeated string hideDiffs = 37;
+    map<string, string> envVarMappings = 41;   // environment variable remappings for provider resources (NEW_KEY -> OLD_KEY)
+}
+
+enum Result {
+	SUCCESS = 0;
+	FAIL = 1;
+	SKIP = 2;
+}
+
+// RegisterResourceResponse is returned by the engine after a resource has finished being initialized.  It includes the
+// auto-assigned URN, the provider-assigned ID, and any other properties initialized by the engine.
+message RegisterResourceResponse {
+    // PropertyDependencies describes the resources that a particular property depends on.
+    message PropertyDependencies {
+        repeated string urns = 1; // A list of URNs this property depends on.
+    }
+
+    string urn = 1;                                             // the URN assigned by the engine.
+    string id = 2;                                              // the unique ID assigned by the provider.
+    google.protobuf.Struct object = 3;                          // the resulting object properties, including provider defaults.
+    bool stable = 4;                                            // if true, the object's state is stable and may be trusted not to change.
+    repeated string stables = 5;                                // an optional list of guaranteed-stable properties.
+    map<string, PropertyDependencies> propertyDependencies = 6; // a map from property keys to the dependencies of the property.
+    Result result = 7;                                          // the reason, whether the resource registration was successful, failed, or skipped.
+}
+
+// RegisterResourceOutputsRequest adds extra resource outputs created by the program after registration has occurred.
+message RegisterResourceOutputsRequest {
+    string urn = 1;                     // the URN for the resource to attach output properties to.
+    google.protobuf.Struct outputs = 2; // additional output properties to add to the existing resource.
+}
+
+message ResourceInvokeRequest {
+    string tok = 1;                  // the function token to invoke.
+    google.protobuf.Struct args = 2; // the arguments for the function invocation.
+    string provider = 3;             // an optional reference to the provider version to use for this invoke.
+    string version = 4;              // the version of the provider to use when servicing this request.
+    bool acceptResources = 5;        // when true operations should return resource references as strongly typed.
+    string pluginDownloadURL = 6;    // an optional reference to the provider url to use for this invoke.
+    map<string, bytes> pluginChecksums = 8; // a map of checksums expected for the provider plugin.
+
+    SourcePosition sourcePosition = 7;  // the optional source position of the user code that initiated the invoke.
+    StackTrace stackTrace = 10;         // the optional stack trace at the time of the request.
+    string parentStackTraceHandle = 11; // the optional parent stack trace handle for the request. Supports stitching stack traces across plugins.
+
+    string packageRef = 9; // a reference from RegisterPackageRequest.
+}
+
+message ResourceCallRequest {
+    // ArgumentDependencies describes the resources that a particular argument depends on.
+    message ArgumentDependencies {
+        repeated string urns = 1; // A list of URNs this argument depends on.
+    }
+
+    string tok = 1;                                        // the function token to invoke.
+    google.protobuf.Struct args = 2;                       // the arguments for the function invocation.
+    map<string, ArgumentDependencies> argDependencies = 3; // a map from argument keys to the dependencies of the argument.
+    string provider = 4;                                   // an optional reference to the provider to use for this invoke.
+    string version = 5;                                    // the version of the provider to use when servicing this request.
+    string pluginDownloadURL = 13;                         // the pluginDownloadURL of the provider to use when servicing this request.
+    map<string, bytes> pluginChecksums = 16;               // a map of checksums of the provider to use when servicing this request.
+
+    // We used to send CallRequest for both provider calls and monitor calls, despite them being different.
+    // We've now split them but need to make sure we don't confuse any old plugins/monitors making sure those
+    // fields don't get reused.
+    reserved 6, 7, 8, 9, 10, 11, 12, 14;
+    reserved "project", "stack", "config", "configSecretKeys", "dryRun", "parallel", "monitorEndpoint", "organization";
+
+    SourcePosition sourcePosition = 15; // the optional source position of the user code that initiated the call.
+    StackTrace stackTrace = 18;         // the optional stack trace at the time of the request.
+    string parentStackTraceHandle = 19; // the optional parent stack trace handle for the request. Supports stitching stack traces across plugins.
+
+    string packageRef = 17; // a reference from RegisterPackageRequest.
+}
+
+// TransformResourceOptions is a subset of all resource options that are relevant to transforms.
+message TransformResourceOptions {
+    repeated string depends_on = 1;
+    optional bool protect = 2;
+    repeated string ignore_changes = 3;
+    repeated string replace_on_changes = 4;
+    string version = 5;
+    repeated Alias aliases = 6;
+    string provider = 7;
+    RegisterResourceRequest.CustomTimeouts custom_timeouts = 8;
+    string plugin_download_url = 9;
+    optional bool retain_on_delete = 10;
+    string deleted_with = 11;
+    optional bool delete_before_replace = 12;
+    repeated string additional_secret_outputs = 13;
+    map<string, string> providers = 14;
+    map<string, bytes> plugin_checksums = 15;
+    RegisterResourceRequest.ResourceHooksBinding hooks = 16;
+    string import = 17;
+    repeated string hide_diff = 18;
+    repeated string replace_with = 19;
+    google.protobuf.Value replacement_trigger = 20;
+}
+
+message TransformRequest {
+    string type = 1; // the type of the resource.
+    string name = 2; // the name of the resource.
+    bool custom = 3; // true if the resource is a custom resource, else it's a component resource.
+    string parent = 4; // the parent of the resource, this can't be changed by the transform.
+    google.protobuf.Struct properties = 5; // the input properties of the resource.
+    TransformResourceOptions options = 6; // the options for the resource.
+}
+
+message TransformResponse {
+    google.protobuf.Struct properties = 1; // the transformed input properties.
+    TransformResourceOptions options = 2; // the options for the resource.
+}
+
+// TransformInvokeRequest is the request object for the TransformInvoke RPC.
+message TransformInvokeRequest {
+    string token = 1; // the token for the invoke request.
+    google.protobuf.Struct args = 2; // the input args of the resource.
+    TransformInvokeOptions options = 3; // the options for the resource.
+}
+
+// TransformInvokeResponse is the response object for the TransformInvoke RPC.
+message TransformInvokeResponse {
+    google.protobuf.Struct args = 1; // the transformed input args.
+    TransformInvokeOptions options = 2; // the options for the resource.
+}
+
+// TransformInvokeOptions is a subset of all invoke options that are relevant to transforms.
+message TransformInvokeOptions {
+    string provider = 1;
+    string plugin_download_url = 2;
+    string version = 3;
+    map<string, bytes> plugin_checksums = 4;
+}
+
+// ResourceHookRequest is the request object for resource hook callbacks in CallbackInvokeRequest.
+message ResourceHookRequest {
+    string urn = 1; // the urn of the resource for which the hook is called.
+    string id = 2; // the optional urn of the resource for which the hook is called.
+    string name = 3; // the name of the resource for which the hook is called.
+    string type = 4; // the type of the resource for which the hook is called.
+    google.protobuf.Struct new_inputs = 5; // the optional checked new inputs of the resource.
+    google.protobuf.Struct old_inputs = 6; // the optional checked old inputs of the resource.
+    google.protobuf.Struct new_outputs = 7; // the optional new outputs of the resource.
+    google.protobuf.Struct old_outputs = 8; // the optional old outputs of the resource.
+}
+
+// ResourceHookResponse is the response object for resource hook callbacks in CallbackInvokeResponse.
+message ResourceHookResponse {
+    string error = 1; // an optional error message to return from the hook.
+}
+
+// ErrorHookRequest is the request object for error hook callbacks in CallbackInvokeRequest.
+message ErrorHookRequest {
+    string urn = 1; // the urn of the resource for which the hook is called.
+    string id = 2; // the optional urn of the resource for which the hook is called.
+    string name = 3; // the name of the resource for which the hook is called.
+    string type = 4; // the type of the resource for which the hook is called.
+    google.protobuf.Struct new_inputs = 5; // the optional checked new inputs of the resource.
+    google.protobuf.Struct old_inputs = 6; // the optional checked old inputs of the resource.
+    google.protobuf.Struct old_outputs = 7; // the optional old outputs of the resource.
+    string failed_operation = 8; // the operation that failed (create, read, update, or delete).
+    repeated string errors = 9; // the errors that have been seen so far (newest-first).
+}
+
+// ErrorHookResponse is the response object for error hook callbacks in CallbackInvokeResponse.
+message ErrorHookResponse {
+    string error = 1; // an optional error message to return from the hook.
+    bool retry = 2; // whether we should retry the operation.
+}
+
+message RegisterPackageRequest {
+    string name = 1; // the plugin name.
+    string version = 2; // the plugin version.
+    string download_url = 3; // the optional plugin download url.
+    map<string, bytes> checksums = 4; // the optional plugin checksums.
+    Parameterization parameterization = 5; // the optional parameterization for this package.
+}
+
+message RegisterPackageResponse {
+    // The UUID package reference for this registered package.
+    //
+    // Lifecycle methods accept this reference in the 'packageRef' field.
+    string ref = 1;
+}
+
+message Parameterization {
+    string name = 1; // the parameterized package name.
+    string version = 2; // the parameterized package version.
+    bytes value = 3; // the parameter value for the parameterized package.
+}
+
+message RegisterResourceHookRequest {
+    // The name of the hook. Must be unique within a program, registering the
+    // same name twice is an error.
+    string name = 1;
+    Callback callback = 2; // the callback that the engine can call to run the hook.
+    bool on_dry_run = 3; // whether to run the hook on dry runs.
+}
+
+message RegisterErrorHookRequest {
+    // The name of the hook. Must be unique within a program, registering the
+    // same name twice is an error.
+    string name = 1;
+    Callback callback = 2; // the callback that the engine can call to run the hook.
+}

data/pulumi/resource_status.proto

@@ -0,0 +1,172 @@
+// Copyright 2025, Pulumi Corporation.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+import "google/protobuf/struct.proto";
+import "pulumi/provider.proto";
+
+package pulumirpc;
+
+option go_package = "github.com/pulumi/pulumi/sdk/v3/proto/go;pulumirpc";
+
+// ResourceStatus is an interface that can be called from a resource provider to update status about a resource.
+service ResourceStatus {
+    // `PublishViewSteps` is used to publish a series of steps for a view resource.
+    // Views can be materialized via create and update steps, and more complex
+    // changes, such as replacements, can be modeled as a series of steps.
+    // The engine does not actually apply these steps, but rather flows them through
+    // the engine such that the view resources are written to state and the view
+    // resources are displayed in the UI.
+    rpc PublishViewSteps(PublishViewStepsRequest) returns (PublishViewStepsResponse) {}
+}
+
+// `PublishViewStepsRequest` is the type of requests sent as part of a
+// [](pulumirpc.ResourceStatus.PublishViewSteps) call.
+message PublishViewStepsRequest {
+    // The service context token.
+    string token = 1;
+
+    // The steps to publish.
+    repeated ViewStep steps = 2;
+}
+
+// `PublishViewStepsResponse` is the type of responses sent as part of a
+// [](pulumirpc.ResourceStatus.PublishViewSteps) call.
+message PublishViewStepsResponse {
+}
+
+// `ViewStep` represents a deployment operation step for a view resource.
+message ViewStep {
+    // Represents the kind of operation performed by a step.
+    enum Op {
+        // An unspecified operation.
+        UNSPECIFIED = 0;
+
+        // Nothing to do.
+        SAME = 1;
+
+        // Creating a new resource.
+        CREATE = 2;
+
+        // Updating an existing resource.
+        UPDATE = 3;
+
+        // Deleting an existing resource.
+        DELETE = 4;
+
+        // Replacing a resource with a new one.
+        REPLACE = 5;
+
+        // Creating a new resource for a replacement.
+        CREATE_REPLACEMENT = 6;
+
+        // Deleting an existing resource after replacement.
+        DELETE_REPLACED = 7;
+
+        // Reading an existing resource.
+        READ = 8;
+
+        // Reading an existing resource for a replacement.
+        READ_REPLACEMENT = 9;
+
+        // Refreshing an existing resource.
+        REFRESH = 10;
+
+        // Removing a resource that was read.
+        READ_DISCARD = 11;
+
+        // Discarding a read resource that was replaced.
+        DISCARD_REPLACED = 12;
+
+        // Removing a pending replace resource.
+        REMOVE_PENDING_REPLACE = 13;
+
+        // Import an existing resource.
+        IMPORT = 14;
+
+        // Replace an existing resource.
+        IMPORT_REPLACEMENT = 15;
+    }
+
+    // Status is returned when an error has occurred during a resource provider operation.
+    // It indicates whether the operation could be rolled back cleanly (OK). If not, it
+    // means the resource was left in an indeterminate state.
+    enum Status {
+        OK = 0;
+        PARTIAL_FAILURE = 1;
+        UNKNOWN = 2;
+    }
+
+    // The status of the operation.
+    Status status = 1;
+
+    // An optional error message indicating the operation failed.
+    string error = 2;
+
+    // The operation being performed.
+    Op op = 3;
+
+    // The type of the view resource.
+    string type = 4;
+
+    // The name of the view resource.
+    string name = 5;
+
+    // The state of the view resource before performing the step.
+    ViewStepState old = 6;
+
+    // The state of the view resource after performing the step.
+    ViewStepState new = 7;
+
+    // The keys causing a replacement (only applicable for "create" and "replace" ops).
+    repeated string keys = 8;
+
+    // The keys that changed with this step.
+    repeated string diffs = 9;
+
+    // A detailed diff is a map from [property paths](property-paths) to [](pulumirpc.PropertyDiff)s,
+    // which describe the kind of change that occurred to the property located at that path.
+    map<string, PropertyDiff> detailed_diff = 10;
+
+    // Whether the detailed diff is present.
+    bool has_detailed_diff = 11;
+}
+
+// `ViewStepState` represents the state of a view resource.
+message ViewStepState {
+    // The type of the view resource.
+    string type = 1;
+
+    // The name of the view resource.
+    string name = 2;
+
+    // An optional type of the parent view resource. By default, a view resource will
+    // be a child of the owning resource, but views can be nested within other views,
+    // as long as they're all under the same owner. Both parent_type and parent_name
+    // must be set together.
+    string parent_type = 3;
+
+    // An optional name of the parent view resource. By default, a view resource will
+    // be a child of the owning resource, but views can be nested within other views,
+    // as long as they're all under the same owner. Both parent_type and parent_name
+    // must be set together.
+    string parent_name = 4;
+
+    // The view resource's inputs.
+    google.protobuf.Struct inputs = 5;
+
+    // The view resource's outputs.
+    google.protobuf.Struct outputs = 6;
+}

data/pulumi/source.proto

@@ -0,0 +1,36 @@
+// Copyright 2016-2022, Pulumi Corporation.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package pulumirpc;
+
+option go_package = "github.com/pulumi/pulumi/sdk/v3/proto/go;pulumirpc";
+
+// A SourcePosition represents a position in a source file.
+message SourcePosition {
+    string uri = 1; // The URI of the file. Currently only the file scheme with an absolute path is supported.
+    int32 line = 2; // The line in the file
+    int32 column = 3; // The column in the line
+}
+
+// A StackFrame represents a single stack frame.
+message StackFrame {
+    SourcePosition pc = 1; // The position of the frame's program counter. Optional.
+}
+
+// A StackTrace represents the frames on the stack at the point of an RPC call.
+message StackTrace {
+    repeated StackFrame frames = 1; // The frames on the stack.
+}