Merge pull request #13 from negz/bump

Replicate run_function.proto from c/c master

proto/v1beta1/run_function.proto

@@ -43,9 +43,8 @@ message RunFunctionRequest {
  State observed = 2;
 
  // Desired state according to a Function pipeline. The state passed to a
- // particular Function may have been accumulated by processing a Composition's
- // patch-and-transform resources array. It may also have been accumulated by
- // previous Functions in the pipeline.
+ // particular Function may have been accumulated by previous Functions in the
+ // pipeline.
  State desired = 3;
 
  // Optional input specific to this Function invocation. A JSON representation
@@ -96,9 +95,23 @@ message State {
  map<string, Resource> resources = 2;
 }
 
-// A Resource represents the state of a resource.
+// A Resource represents the state of a composite or composed resource.
 message Resource {
  // The JSON representation of the resource.
+ //
+ // * Crossplane will set this field in a RunFunctionRequest to the entire
+ // observed state of a resource - including its metadata, spec, and status.
+ //
+ // * A Function should set this field in a RunFunctionRequest to communicate
+ // the desired state of a composite or composed resource.
+ //
+ // * A Function may only specify the desired status of a composite resource -
+ // not its metadata or spec. A Function should not return desired metadata
+ // or spec for a composite resource. This will be ignored.
+ //
+ // * A Function may not specify the desired status of a composed resource -
+ // only its metadata and spec. A Function should not return desired status
+ // for a composed resource. This will be ignored.
  google.protobuf.Struct resource = 1;
 
  // The resource's connection details.