crossplane-function-pythonic 0.6.2__py3-none-any.whl → 0.7.0__py3-none-any.whl

crossplane/pythonic/proto/v1/run_function_pb2.pyi

@@ -1,306 +1,1172 @@
-import datetime
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+This package defines the RPC for both composition and operation functions.
+Only composition functions are part of the 'apiextensions' API group. In
+retrospect this package should've been crossplane.proto.fn.v1, but it's too
+late to change it now.
 
+buf:lint:ignore PACKAGE_DIRECTORY_MATCH
+"""
+
+from collections import abc as _abc
+from google.protobuf import descriptor as _descriptor
 from google.protobuf import duration_pb2 as _duration_pb2
+from google.protobuf import message as _message
 from google.protobuf import struct_pb2 as _struct_pb2
 from google.protobuf.internal import containers as _containers
 from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import message as _message
-from collections.abc import Iterable as _Iterable, Mapping as _Mapping
-from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+import builtins as _builtins
+import sys
+import typing as _typing
+
+if sys.version_info >= (3, 11):
+    from typing import TypeAlias as _TypeAlias, Never as _Never
+else:
+    from typing_extensions import TypeAlias as _TypeAlias, Never as _Never
+
+if sys.version_info >= (3, 13):
+    from warnings import deprecated as _deprecated
+else:
+    from typing_extensions import deprecated as _deprecated
 
 DESCRIPTOR: _descriptor.FileDescriptor
 
-class Capability(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
-    __slots__ = ()
-    CAPABILITY_UNSPECIFIED: _ClassVar[Capability]
-    CAPABILITY_CAPABILITIES: _ClassVar[Capability]
-    CAPABILITY_REQUIRED_RESOURCES: _ClassVar[Capability]
-    CAPABILITY_CREDENTIALS: _ClassVar[Capability]
-    CAPABILITY_CONDITIONS: _ClassVar[Capability]
-    CAPABILITY_REQUIRED_SCHEMAS: _ClassVar[Capability]
-
-class Ready(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
-    __slots__ = ()
-    READY_UNSPECIFIED: _ClassVar[Ready]
-    READY_TRUE: _ClassVar[Ready]
-    READY_FALSE: _ClassVar[Ready]
-
-class Severity(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
-    __slots__ = ()
-    SEVERITY_UNSPECIFIED: _ClassVar[Severity]
-    SEVERITY_FATAL: _ClassVar[Severity]
-    SEVERITY_WARNING: _ClassVar[Severity]
-    SEVERITY_NORMAL: _ClassVar[Severity]
-
-class Target(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
-    __slots__ = ()
-    TARGET_UNSPECIFIED: _ClassVar[Target]
-    TARGET_COMPOSITE: _ClassVar[Target]
-    TARGET_COMPOSITE_AND_CLAIM: _ClassVar[Target]
-
-class Status(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
-    __slots__ = ()
-    STATUS_CONDITION_UNSPECIFIED: _ClassVar[Status]
-    STATUS_CONDITION_UNKNOWN: _ClassVar[Status]
-    STATUS_CONDITION_TRUE: _ClassVar[Status]
-    STATUS_CONDITION_FALSE: _ClassVar[Status]
-CAPABILITY_UNSPECIFIED: Capability
-CAPABILITY_CAPABILITIES: Capability
-CAPABILITY_REQUIRED_RESOURCES: Capability
-CAPABILITY_CREDENTIALS: Capability
-CAPABILITY_CONDITIONS: Capability
-CAPABILITY_REQUIRED_SCHEMAS: Capability
-READY_UNSPECIFIED: Ready
-READY_TRUE: Ready
-READY_FALSE: Ready
-SEVERITY_UNSPECIFIED: Severity
-SEVERITY_FATAL: Severity
-SEVERITY_WARNING: Severity
-SEVERITY_NORMAL: Severity
-TARGET_UNSPECIFIED: Target
-TARGET_COMPOSITE: Target
-TARGET_COMPOSITE_AND_CLAIM: Target
-STATUS_CONDITION_UNSPECIFIED: Status
-STATUS_CONDITION_UNKNOWN: Status
-STATUS_CONDITION_TRUE: Status
-STATUS_CONDITION_FALSE: Status
+class _Capability:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _CapabilityEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_Capability.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    CAPABILITY_UNSPECIFIED: _Capability.ValueType  # 0
+    CAPABILITY_CAPABILITIES: _Capability.ValueType  # 1
+    """Crossplane sends capabilities in RequestMeta. If this capability is
+    present, the function knows that if another capability is absent, it's
+    because Crossplane doesn't support it (not because Crossplane predates
+    capability advertisement). Added in Crossplane v2.2.
+    """
+    CAPABILITY_REQUIRED_RESOURCES: _Capability.ValueType  # 2
+    """Crossplane supports the requirements.resources field. Functions can return
+    resource requirements and Crossplane will fetch the requested resources and
+    return them in required_resources. Added in Crossplane v1.15.
+    """
+    CAPABILITY_CREDENTIALS: _Capability.ValueType  # 3
+    """Crossplane supports the credentials field. Functions can receive
+    credentials from secrets specified in the Composition. Added in Crossplane
+    v1.16.
+    """
+    CAPABILITY_CONDITIONS: _Capability.ValueType  # 4
+    """Crossplane supports the conditions field. Functions can return status
+    conditions to be applied to the XR and optionally its claim. Added in
+    Crossplane v1.17.
+    """
+    CAPABILITY_REQUIRED_SCHEMAS: _Capability.ValueType  # 5
+    """Crossplane supports the requirements.schemas field. Functions can request
+    OpenAPI schemas and Crossplane will return them in required_schemas. Added
+    in Crossplane v2.2.
+    """
+
+class Capability(_Capability, metaclass=_CapabilityEnumTypeWrapper):
+    """Capability indicates that Crossplane supports a particular feature.
+    Functions can check for capabilities to determine whether Crossplane will
+    honor a particular request or response field.
+    """
+
+CAPABILITY_UNSPECIFIED: Capability.ValueType  # 0
+CAPABILITY_CAPABILITIES: Capability.ValueType  # 1
+"""Crossplane sends capabilities in RequestMeta. If this capability is
+present, the function knows that if another capability is absent, it's
+because Crossplane doesn't support it (not because Crossplane predates
+capability advertisement). Added in Crossplane v2.2.
+"""
+CAPABILITY_REQUIRED_RESOURCES: Capability.ValueType  # 2
+"""Crossplane supports the requirements.resources field. Functions can return
+resource requirements and Crossplane will fetch the requested resources and
+return them in required_resources. Added in Crossplane v1.15.
+"""
+CAPABILITY_CREDENTIALS: Capability.ValueType  # 3
+"""Crossplane supports the credentials field. Functions can receive
+credentials from secrets specified in the Composition. Added in Crossplane
+v1.16.
+"""
+CAPABILITY_CONDITIONS: Capability.ValueType  # 4
+"""Crossplane supports the conditions field. Functions can return status
+conditions to be applied to the XR and optionally its claim. Added in
+Crossplane v1.17.
+"""
+CAPABILITY_REQUIRED_SCHEMAS: Capability.ValueType  # 5
+"""Crossplane supports the requirements.schemas field. Functions can request
+OpenAPI schemas and Crossplane will return them in required_schemas. Added
+in Crossplane v2.2.
+"""
+Global___Capability: _TypeAlias = Capability  # noqa: Y015
+
+class _Ready:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _ReadyEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_Ready.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    READY_UNSPECIFIED: _Ready.ValueType  # 0
+    READY_TRUE: _Ready.ValueType  # 1
+    """True means the resource has been observed to be ready."""
+    READY_FALSE: _Ready.ValueType  # 2
+    """False means the resource has not been observed to be ready."""
+
+class Ready(_Ready, metaclass=_ReadyEnumTypeWrapper):
+    """Ready indicates whether a resource should be considered ready."""
+
+READY_UNSPECIFIED: Ready.ValueType  # 0
+READY_TRUE: Ready.ValueType  # 1
+"""True means the resource has been observed to be ready."""
+READY_FALSE: Ready.ValueType  # 2
+"""False means the resource has not been observed to be ready."""
+Global___Ready: _TypeAlias = Ready  # noqa: Y015
+
+class _Severity:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _SeverityEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_Severity.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    SEVERITY_UNSPECIFIED: _Severity.ValueType  # 0
+    SEVERITY_FATAL: _Severity.ValueType  # 1
+    """Fatal results are fatal; subsequent functions may run, but the function
+    pipeline run will be considered a failure and the first fatal result will
+    be returned as an error.
+    """
+    SEVERITY_WARNING: _Severity.ValueType  # 2
+    """Warning results are non-fatal; the entire pipeline will run to completion
+    but warning events and debug logs associated with the XR or Operation will
+    be emitted.
+    """
+    SEVERITY_NORMAL: _Severity.ValueType  # 3
+    """Normal results are emitted as normal events and debug logs associated with
+    the XR or operation.
+    """
+
+class Severity(_Severity, metaclass=_SeverityEnumTypeWrapper):
+    """Severity of function results."""
+
+SEVERITY_UNSPECIFIED: Severity.ValueType  # 0
+SEVERITY_FATAL: Severity.ValueType  # 1
+"""Fatal results are fatal; subsequent functions may run, but the function
+pipeline run will be considered a failure and the first fatal result will
+be returned as an error.
+"""
+SEVERITY_WARNING: Severity.ValueType  # 2
+"""Warning results are non-fatal; the entire pipeline will run to completion
+but warning events and debug logs associated with the XR or Operation will
+be emitted.
+"""
+SEVERITY_NORMAL: Severity.ValueType  # 3
+"""Normal results are emitted as normal events and debug logs associated with
+the XR or operation.
+"""
+Global___Severity: _TypeAlias = Severity  # noqa: Y015
 
+class _Target:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _TargetEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_Target.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    TARGET_UNSPECIFIED: _Target.ValueType  # 0
+    """If the target is unspecified, the result targets the XR."""
+    TARGET_COMPOSITE: _Target.ValueType  # 1
+    """Target the XR. Results that target the XR should include detailed, advanced
+    information.
+    """
+    TARGET_COMPOSITE_AND_CLAIM: _Target.ValueType  # 2
+    """Target the XR and the claim. Results that target the XR and the claim
+    should include only end-user friendly information.
+    """
+
+class Target(_Target, metaclass=_TargetEnumTypeWrapper):
+    """Target of function results and conditions."""
+
+TARGET_UNSPECIFIED: Target.ValueType  # 0
+"""If the target is unspecified, the result targets the XR."""
+TARGET_COMPOSITE: Target.ValueType  # 1
+"""Target the XR. Results that target the XR should include detailed, advanced
+information.
+"""
+TARGET_COMPOSITE_AND_CLAIM: Target.ValueType  # 2
+"""Target the XR and the claim. Results that target the XR and the claim
+should include only end-user friendly information.
+"""
+Global___Target: _TypeAlias = Target  # noqa: Y015
+
+class _Status:
+    ValueType = _typing.NewType("ValueType", _builtins.int)
+    V: _TypeAlias = ValueType  # noqa: Y015
+
+class _StatusEnumTypeWrapper(_enum_type_wrapper._EnumTypeWrapper[_Status.ValueType], _builtins.type):
+    DESCRIPTOR: _descriptor.EnumDescriptor
+    STATUS_CONDITION_UNSPECIFIED: _Status.ValueType  # 0
+    STATUS_CONDITION_UNKNOWN: _Status.ValueType  # 1
+    STATUS_CONDITION_TRUE: _Status.ValueType  # 2
+    STATUS_CONDITION_FALSE: _Status.ValueType  # 3
+
+class Status(_Status, metaclass=_StatusEnumTypeWrapper): ...
+
+STATUS_CONDITION_UNSPECIFIED: Status.ValueType  # 0
+STATUS_CONDITION_UNKNOWN: Status.ValueType  # 1
+STATUS_CONDITION_TRUE: Status.ValueType  # 2
+STATUS_CONDITION_FALSE: Status.ValueType  # 3
+Global___Status: _TypeAlias = Status  # noqa: Y015
+
+@_typing.final
 class RunFunctionRequest(_message.Message):
-    __slots__ = ("meta", "observed", "desired", "input", "context", "extra_resources", "credentials", "required_resources", "required_schemas")
+    """A RunFunctionRequest requests that the function be run."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
     class ExtraResourcesEntry(_message.Message):
-        __slots__ = ("key", "value")
-        KEY_FIELD_NUMBER: _ClassVar[int]
-        VALUE_FIELD_NUMBER: _ClassVar[int]
-        key: str
-        value: Resources
-        def __init__(self, key: _Optional[str] = ..., value: _Optional[_Union[Resources, _Mapping]] = ...) -> None: ...
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___Resources: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___Resources | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    @_typing.final
     class CredentialsEntry(_message.Message):
-        __slots__ = ("key", "value")
-        KEY_FIELD_NUMBER: _ClassVar[int]
-        VALUE_FIELD_NUMBER: _ClassVar[int]
-        key: str
-        value: Credentials
-        def __init__(self, key: _Optional[str] = ..., value: _Optional[_Union[Credentials, _Mapping]] = ...) -> None: ...
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___Credentials: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___Credentials | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    @_typing.final
     class RequiredResourcesEntry(_message.Message):
-        __slots__ = ("key", "value")
-        KEY_FIELD_NUMBER: _ClassVar[int]
-        VALUE_FIELD_NUMBER: _ClassVar[int]
-        key: str
-        value: Resources
-        def __init__(self, key: _Optional[str] = ..., value: _Optional[_Union[Resources, _Mapping]] = ...) -> None: ...
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___Resources: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___Resources | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    @_typing.final
     class RequiredSchemasEntry(_message.Message):
-        __slots__ = ("key", "value")
-        KEY_FIELD_NUMBER: _ClassVar[int]
-        VALUE_FIELD_NUMBER: _ClassVar[int]
-        key: str
-        value: Schema
-        def __init__(self, key: _Optional[str] = ..., value: _Optional[_Union[Schema, _Mapping]] = ...) -> None: ...
-    META_FIELD_NUMBER: _ClassVar[int]
-    OBSERVED_FIELD_NUMBER: _ClassVar[int]
-    DESIRED_FIELD_NUMBER: _ClassVar[int]
-    INPUT_FIELD_NUMBER: _ClassVar[int]
-    CONTEXT_FIELD_NUMBER: _ClassVar[int]
-    EXTRA_RESOURCES_FIELD_NUMBER: _ClassVar[int]
-    CREDENTIALS_FIELD_NUMBER: _ClassVar[int]
-    REQUIRED_RESOURCES_FIELD_NUMBER: _ClassVar[int]
-    REQUIRED_SCHEMAS_FIELD_NUMBER: _ClassVar[int]
-    meta: RequestMeta
-    observed: State
-    desired: State
-    input: _struct_pb2.Struct
-    context: _struct_pb2.Struct
-    extra_resources: _containers.MessageMap[str, Resources]
-    credentials: _containers.MessageMap[str, Credentials]
-    required_resources: _containers.MessageMap[str, Resources]
-    required_schemas: _containers.MessageMap[str, Schema]
-    def __init__(self, meta: _Optional[_Union[RequestMeta, _Mapping]] = ..., observed: _Optional[_Union[State, _Mapping]] = ..., desired: _Optional[_Union[State, _Mapping]] = ..., input: _Optional[_Union[_struct_pb2.Struct, _Mapping]] = ..., context: _Optional[_Union[_struct_pb2.Struct, _Mapping]] = ..., extra_resources: _Optional[_Mapping[str, Resources]] = ..., credentials: _Optional[_Mapping[str, Credentials]] = ..., required_resources: _Optional[_Mapping[str, Resources]] = ..., required_schemas: _Optional[_Mapping[str, Schema]] = ...) -> None: ...
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___Schema: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___Schema | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    META_FIELD_NUMBER: _builtins.int
+    OBSERVED_FIELD_NUMBER: _builtins.int
+    DESIRED_FIELD_NUMBER: _builtins.int
+    INPUT_FIELD_NUMBER: _builtins.int
+    CONTEXT_FIELD_NUMBER: _builtins.int
+    EXTRA_RESOURCES_FIELD_NUMBER: _builtins.int
+    CREDENTIALS_FIELD_NUMBER: _builtins.int
+    REQUIRED_RESOURCES_FIELD_NUMBER: _builtins.int
+    REQUIRED_SCHEMAS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def meta(self) -> Global___RequestMeta:
+        """Metadata pertaining to this request."""
 
+    @_builtins.property
+    def observed(self) -> Global___State:
+        """The observed state prior to invocation of a function pipeline. State passed
+        to each function is fresh as of the time the pipeline was invoked, not as
+        of the time each function was invoked.
+        """
+
+    @_builtins.property
+    def desired(self) -> Global___State:
+        """Desired state according to a function pipeline. The state passed to a
+        particular function may have been accumulated by previous functions in the
+        pipeline.
+
+        Note that the desired state must be a partial object with only the fields
+        that this function (and its predecessors in the pipeline) wants to have set
+        in the object. Copying a non-partial observed state to desired is most
+        likely not what you want to do. Leaving out fields that had been returned
+        as desired before will result in them being deleted from the objects in the
+        cluster.
+        """
+
+    @_builtins.property
+    def input(self) -> _struct_pb2.Struct:
+        """Optional input specific to this function invocation. A JSON representation
+        of the 'input' block of the relevant entry in a function pipeline.
+        """
+
+    @_builtins.property
+    def context(self) -> _struct_pb2.Struct:
+        """Optional context. Crossplane may pass arbitrary contextual information to a
+        function. A function may also return context in its RunFunctionResponse,
+        and that context will be passed to subsequent functions. Crossplane
+        discards all context returned by the last function in the pipeline.
+        """
+
+    @_builtins.property
+    @_deprecated("""This field has been marked as deprecated using proto field options.""")
+    def extra_resources(self) -> _containers.MessageMap[_builtins.str, Global___Resources]:
+        """Optional resources that the function specified in its requirements. Note
+        that resources is a map to Resources, plural. The map key corresponds to
+        the key in a RunFunctionResponse's requirements.extra_resources field. If a
+        function requested extra resources that did not exist, Crossplane sets
+        the map key to an empty Resources message to indicate that it attempted to
+        satisfy the request. This field is only populated when the function uses
+        extra_resources in its requirements.
+
+        Deprecated: Use required_resources instead.
+        """
+
+    @_builtins.property
+    def credentials(self) -> _containers.MessageMap[_builtins.str, Global___Credentials]:
+        """Optional credentials that this function may use to communicate with an
+        external system.
+        """
+
+    @_builtins.property
+    def required_resources(self) -> _containers.MessageMap[_builtins.str, Global___Resources]:
+        """Optional resources that the function specified in its requirements. Note
+        that resources is a map to Resources, plural. The map key corresponds to
+        the key in a RunFunctionResponse's requirements.resources field. If a
+        function requested required resources that did not exist, Crossplane sets
+        the map key to an empty Resources message to indicate that it attempted to
+        satisfy the request. This field is only populated when the function uses
+        resources in its requirements.
+        """
+
+    @_builtins.property
+    def required_schemas(self) -> _containers.MessageMap[_builtins.str, Global___Schema]:
+        """Optional schemas that the function specified in its requirements. The map
+        key corresponds to the key in a RunFunctionResponse's requirements.schemas
+        field. If a function requested a schema that could not be found, Crossplane
+        sets the map key to an empty Schema message to indicate that it attempted
+        to satisfy the request.
+        """
+
+    def __init__(
+        self,
+        *,
+        meta: Global___RequestMeta | None = ...,
+        observed: Global___State | None = ...,
+        desired: Global___State | None = ...,
+        input: _struct_pb2.Struct | None = ...,
+        context: _struct_pb2.Struct | None = ...,
+        extra_resources: _abc.Mapping[_builtins.str, Global___Resources] | None = ...,
+        credentials: _abc.Mapping[_builtins.str, Global___Credentials] | None = ...,
+        required_resources: _abc.Mapping[_builtins.str, Global___Resources] | None = ...,
+        required_schemas: _abc.Mapping[_builtins.str, Global___Schema] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_context", b"_context", "_input", b"_input", "context", b"context", "desired", b"desired", "input", b"input", "meta", b"meta", "observed", b"observed"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_context", b"_context", "_input", b"_input", "context", b"context", "credentials", b"credentials", "desired", b"desired", "extra_resources", b"extra_resources", "input", b"input", "meta", b"meta", "observed", b"observed", "required_resources", b"required_resources", "required_schemas", b"required_schemas"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__context: _TypeAlias = _typing.Literal["context"]  # noqa: Y015
+    _WhichOneofArgType__context: _TypeAlias = _typing.Literal["_context", b"_context"]  # noqa: Y015
+    _WhichOneofReturnType__input: _TypeAlias = _typing.Literal["input"]  # noqa: Y015
+    _WhichOneofArgType__input: _TypeAlias = _typing.Literal["_input", b"_input"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__context) -> _WhichOneofReturnType__context | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__input) -> _WhichOneofReturnType__input | None: ...
+
+Global___RunFunctionRequest: _TypeAlias = RunFunctionRequest  # noqa: Y015
+
+@_typing.final
 class Credentials(_message.Message):
-    __slots__ = ("credential_data",)
-    CREDENTIAL_DATA_FIELD_NUMBER: _ClassVar[int]
-    credential_data: CredentialData
-    def __init__(self, credential_data: _Optional[_Union[CredentialData, _Mapping]] = ...) -> None: ...
+    """Credentials that a function may use to communicate with an external system."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    CREDENTIAL_DATA_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def credential_data(self) -> Global___CredentialData:
+        """Credential data loaded by Crossplane, for example from a Secret."""
 
+    def __init__(
+        self,
+        *,
+        credential_data: Global___CredentialData | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["credential_data", b"credential_data", "source", b"source"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["credential_data", b"credential_data", "source", b"source"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType_source: _TypeAlias = _typing.Literal["credential_data"]  # noqa: Y015
+    _WhichOneofArgType_source: _TypeAlias = _typing.Literal["source", b"source"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType_source) -> _WhichOneofReturnType_source | None: ...
+
+Global___Credentials: _TypeAlias = Credentials  # noqa: Y015
+
+@_typing.final
 class CredentialData(_message.Message):
-    __slots__ = ("data",)
+    """CredentialData loaded by Crossplane, for example from a Secret."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
     class DataEntry(_message.Message):
-        __slots__ = ("key", "value")
-        KEY_FIELD_NUMBER: _ClassVar[int]
-        VALUE_FIELD_NUMBER: _ClassVar[int]
-        key: str
-        value: bytes
-        def __init__(self, key: _Optional[str] = ..., value: _Optional[bytes] = ...) -> None: ...
-    DATA_FIELD_NUMBER: _ClassVar[int]
-    data: _containers.ScalarMap[str, bytes]
-    def __init__(self, data: _Optional[_Mapping[str, bytes]] = ...) -> None: ...
+        DESCRIPTOR: _descriptor.Descriptor
 
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        value: _builtins.bytes
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: _builtins.bytes = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    DATA_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def data(self) -> _containers.ScalarMap[_builtins.str, _builtins.bytes]: ...
+    def __init__(
+        self,
+        *,
+        data: _abc.Mapping[_builtins.str, _builtins.bytes] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["data", b"data"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___CredentialData: _TypeAlias = CredentialData  # noqa: Y015
+
+@_typing.final
 class Resources(_message.Message):
-    __slots__ = ("items",)
-    ITEMS_FIELD_NUMBER: _ClassVar[int]
-    items: _containers.RepeatedCompositeFieldContainer[Resource]
-    def __init__(self, items: _Optional[_Iterable[_Union[Resource, _Mapping]]] = ...) -> None: ...
+    """Resources represents the state of several Crossplane resources."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    ITEMS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def items(self) -> _containers.RepeatedCompositeFieldContainer[Global___Resource]: ...
+    def __init__(
+        self,
+        *,
+        items: _abc.Iterable[Global___Resource] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["items", b"items"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
+Global___Resources: _TypeAlias = Resources  # noqa: Y015
+
+@_typing.final
 class RunFunctionResponse(_message.Message):
-    __slots__ = ("meta", "desired", "results", "context", "requirements", "conditions", "output")
-    META_FIELD_NUMBER: _ClassVar[int]
-    DESIRED_FIELD_NUMBER: _ClassVar[int]
-    RESULTS_FIELD_NUMBER: _ClassVar[int]
-    CONTEXT_FIELD_NUMBER: _ClassVar[int]
-    REQUIREMENTS_FIELD_NUMBER: _ClassVar[int]
-    CONDITIONS_FIELD_NUMBER: _ClassVar[int]
-    OUTPUT_FIELD_NUMBER: _ClassVar[int]
-    meta: ResponseMeta
-    desired: State
-    results: _containers.RepeatedCompositeFieldContainer[Result]
-    context: _struct_pb2.Struct
-    requirements: Requirements
-    conditions: _containers.RepeatedCompositeFieldContainer[Condition]
-    output: _struct_pb2.Struct
-    def __init__(self, meta: _Optional[_Union[ResponseMeta, _Mapping]] = ..., desired: _Optional[_Union[State, _Mapping]] = ..., results: _Optional[_Iterable[_Union[Result, _Mapping]]] = ..., context: _Optional[_Union[_struct_pb2.Struct, _Mapping]] = ..., requirements: _Optional[_Union[Requirements, _Mapping]] = ..., conditions: _Optional[_Iterable[_Union[Condition, _Mapping]]] = ..., output: _Optional[_Union[_struct_pb2.Struct, _Mapping]] = ...) -> None: ...
+    """A RunFunctionResponse contains the result of a function run."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    META_FIELD_NUMBER: _builtins.int
+    DESIRED_FIELD_NUMBER: _builtins.int
+    RESULTS_FIELD_NUMBER: _builtins.int
+    CONTEXT_FIELD_NUMBER: _builtins.int
+    REQUIREMENTS_FIELD_NUMBER: _builtins.int
+    CONDITIONS_FIELD_NUMBER: _builtins.int
+    OUTPUT_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def meta(self) -> Global___ResponseMeta:
+        """Metadata pertaining to this response."""
+
+    @_builtins.property
+    def desired(self) -> Global___State:
+        """Desired state according to a function pipeline. functions may add desired
+        state, and may mutate or delete any part of the desired state they are
+        concerned with. A function must pass through any part of the desired state
+        that it is not concerned with.
+
+        Note that the desired state must be a partial object with only the fields
+        that this function (and its predecessors in the pipeline) wants to have set
+        in the object. Copying a non-partial observed state to desired is most
+        likely not what you want to do. Leaving out fields that had been returned
+        as desired before will result in them being deleted from the objects in the
+        cluster.
+        """
+
+    @_builtins.property
+    def results(self) -> _containers.RepeatedCompositeFieldContainer[Global___Result]:
+        """Results of the function run. Results are used for observability purposes."""
+
+    @_builtins.property
+    def context(self) -> _struct_pb2.Struct:
+        """Optional context to be passed to the next function in the pipeline as part
+        of the RunFunctionRequest. Dropped on the last function in the pipeline.
+        """
+
+    @_builtins.property
+    def requirements(self) -> Global___Requirements:
+        """Requirements that must be satisfied for this function to run successfully."""
+
+    @_builtins.property
+    def conditions(self) -> _containers.RepeatedCompositeFieldContainer[Global___Condition]:
+        """Status conditions to be applied to the XR. Conditions may also optionally
+        be applied to the XR's associated claim.
+
+        Conditions are only used for composition. They're ignored by Operations.
+        """
+
+    @_builtins.property
+    def output(self) -> _struct_pb2.Struct:
+        """Optional output specific to this function invocation.
+
+        Only Operations use function output. XRs will discard any function output.
+        """
 
+    def __init__(
+        self,
+        *,
+        meta: Global___ResponseMeta | None = ...,
+        desired: Global___State | None = ...,
+        results: _abc.Iterable[Global___Result] | None = ...,
+        context: _struct_pb2.Struct | None = ...,
+        requirements: Global___Requirements | None = ...,
+        conditions: _abc.Iterable[Global___Condition] | None = ...,
+        output: _struct_pb2.Struct | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_context", b"_context", "_output", b"_output", "context", b"context", "desired", b"desired", "meta", b"meta", "output", b"output", "requirements", b"requirements"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_context", b"_context", "_output", b"_output", "conditions", b"conditions", "context", b"context", "desired", b"desired", "meta", b"meta", "output", b"output", "requirements", b"requirements", "results", b"results"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__context: _TypeAlias = _typing.Literal["context"]  # noqa: Y015
+    _WhichOneofArgType__context: _TypeAlias = _typing.Literal["_context", b"_context"]  # noqa: Y015
+    _WhichOneofReturnType__output: _TypeAlias = _typing.Literal["output"]  # noqa: Y015
+    _WhichOneofArgType__output: _TypeAlias = _typing.Literal["_output", b"_output"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__context) -> _WhichOneofReturnType__context | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__output) -> _WhichOneofReturnType__output | None: ...
+
+Global___RunFunctionResponse: _TypeAlias = RunFunctionResponse  # noqa: Y015
+
+@_typing.final
 class RequestMeta(_message.Message):
-    __slots__ = ("tag", "capabilities")
-    TAG_FIELD_NUMBER: _ClassVar[int]
-    CAPABILITIES_FIELD_NUMBER: _ClassVar[int]
-    tag: str
-    capabilities: _containers.RepeatedScalarFieldContainer[Capability]
-    def __init__(self, tag: _Optional[str] = ..., capabilities: _Optional[_Iterable[_Union[Capability, str]]] = ...) -> None: ...
+    """RequestMeta contains metadata pertaining to a RunFunctionRequest."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    TAG_FIELD_NUMBER: _builtins.int
+    CAPABILITIES_FIELD_NUMBER: _builtins.int
+    tag: _builtins.str
+    """An opaque string identifying a request. Requests with identical tags will
+    be otherwise identical.
+    """
+    @_builtins.property
+    def capabilities(self) -> _containers.RepeatedScalarFieldContainer[Global___Capability.ValueType]:
+        """Capabilities supported by this version of Crossplane. Functions may use
+        this to determine whether Crossplane will honor certain fields in their
+        response, or populate certain fields in their request.
+        """
+
+    def __init__(
+        self,
+        *,
+        tag: _builtins.str = ...,
+        capabilities: _abc.Iterable[Global___Capability.ValueType] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["capabilities", b"capabilities", "tag", b"tag"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
+Global___RequestMeta: _TypeAlias = RequestMeta  # noqa: Y015
+
+@_typing.final
 class Requirements(_message.Message):
-    __slots__ = ("extra_resources", "resources", "schemas")
+    """Requirements that must be satisfied for a function to run successfully."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
     class ExtraResourcesEntry(_message.Message):
-        __slots__ = ("key", "value")
-        KEY_FIELD_NUMBER: _ClassVar[int]
-        VALUE_FIELD_NUMBER: _ClassVar[int]
-        key: str
-        value: ResourceSelector
-        def __init__(self, key: _Optional[str] = ..., value: _Optional[_Union[ResourceSelector, _Mapping]] = ...) -> None: ...
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___ResourceSelector: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___ResourceSelector | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    @_typing.final
     class ResourcesEntry(_message.Message):
-        __slots__ = ("key", "value")
-        KEY_FIELD_NUMBER: _ClassVar[int]
-        VALUE_FIELD_NUMBER: _ClassVar[int]
-        key: str
-        value: ResourceSelector
-        def __init__(self, key: _Optional[str] = ..., value: _Optional[_Union[ResourceSelector, _Mapping]] = ...) -> None: ...
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___ResourceSelector: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___ResourceSelector | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    @_typing.final
     class SchemasEntry(_message.Message):
-        __slots__ = ("key", "value")
-        KEY_FIELD_NUMBER: _ClassVar[int]
-        VALUE_FIELD_NUMBER: _ClassVar[int]
-        key: str
-        value: SchemaSelector
-        def __init__(self, key: _Optional[str] = ..., value: _Optional[_Union[SchemaSelector, _Mapping]] = ...) -> None: ...
-    EXTRA_RESOURCES_FIELD_NUMBER: _ClassVar[int]
-    RESOURCES_FIELD_NUMBER: _ClassVar[int]
-    SCHEMAS_FIELD_NUMBER: _ClassVar[int]
-    extra_resources: _containers.MessageMap[str, ResourceSelector]
-    resources: _containers.MessageMap[str, ResourceSelector]
-    schemas: _containers.MessageMap[str, SchemaSelector]
-    def __init__(self, extra_resources: _Optional[_Mapping[str, ResourceSelector]] = ..., resources: _Optional[_Mapping[str, ResourceSelector]] = ..., schemas: _Optional[_Mapping[str, SchemaSelector]] = ...) -> None: ...
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___SchemaSelector: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___SchemaSelector | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    EXTRA_RESOURCES_FIELD_NUMBER: _builtins.int
+    RESOURCES_FIELD_NUMBER: _builtins.int
+    SCHEMAS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    @_deprecated("""This field has been marked as deprecated using proto field options.""")
+    def extra_resources(self) -> _containers.MessageMap[_builtins.str, Global___ResourceSelector]:
+        """Resources that this function requires. The map key uniquely identifies the
+        group of resources.
+
+        Deprecated: Use resources instead.
+        """
+
+    @_builtins.property
+    def resources(self) -> _containers.MessageMap[_builtins.str, Global___ResourceSelector]:
+        """Resources that this function requires. The map key uniquely identifies the
+        group of resources.
+        """
+
+    @_builtins.property
+    def schemas(self) -> _containers.MessageMap[_builtins.str, Global___SchemaSelector]:
+        """Schemas that this function requires. The map key uniquely identifies the
+        schema request.
+        """
+
+    def __init__(
+        self,
+        *,
+        extra_resources: _abc.Mapping[_builtins.str, Global___ResourceSelector] | None = ...,
+        resources: _abc.Mapping[_builtins.str, Global___ResourceSelector] | None = ...,
+        schemas: _abc.Mapping[_builtins.str, Global___SchemaSelector] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["extra_resources", b"extra_resources", "resources", b"resources", "schemas", b"schemas"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
+Global___Requirements: _TypeAlias = Requirements  # noqa: Y015
+
+@_typing.final
 class SchemaSelector(_message.Message):
-    __slots__ = ("api_version", "kind")
-    API_VERSION_FIELD_NUMBER: _ClassVar[int]
-    KIND_FIELD_NUMBER: _ClassVar[int]
-    api_version: str
-    kind: str
-    def __init__(self, api_version: _Optional[str] = ..., kind: _Optional[str] = ...) -> None: ...
+    """SchemaSelector identifies a resource kind whose OpenAPI schema is requested."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    API_VERSION_FIELD_NUMBER: _builtins.int
+    KIND_FIELD_NUMBER: _builtins.int
+    api_version: _builtins.str
+    """API version of the resource kind, e.g. "example.org/v1"."""
+    kind: _builtins.str
+    """Kind of resource, e.g. "MyResource"."""
+    def __init__(
+        self,
+        *,
+        api_version: _builtins.str = ...,
+        kind: _builtins.str = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["api_version", b"api_version", "kind", b"kind"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
+Global___SchemaSelector: _TypeAlias = SchemaSelector  # noqa: Y015
+
+@_typing.final
 class Schema(_message.Message):
-    __slots__ = ("openapi_v3",)
-    OPENAPI_V3_FIELD_NUMBER: _ClassVar[int]
-    openapi_v3: _struct_pb2.Struct
-    def __init__(self, openapi_v3: _Optional[_Union[_struct_pb2.Struct, _Mapping]] = ...) -> None: ...
+    """Schema represents the OpenAPI schema for a resource kind."""
+
+    DESCRIPTOR: _descriptor.Descriptor
 
+    OPENAPI_V3_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def openapi_v3(self) -> _struct_pb2.Struct:
+        """The OpenAPI v3 schema of the resource kind as unstructured JSON.
+        For CRDs this is the spec.versions[].schema.openAPIV3Schema field.
+        Empty if Crossplane could not find a schema for the requested kind.
+        """
+
+    def __init__(
+        self,
+        *,
+        openapi_v3: _struct_pb2.Struct | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_openapi_v3", b"_openapi_v3", "openapi_v3", b"openapi_v3"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_openapi_v3", b"_openapi_v3", "openapi_v3", b"openapi_v3"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__openapi_v3: _TypeAlias = _typing.Literal["openapi_v3"]  # noqa: Y015
+    _WhichOneofArgType__openapi_v3: _TypeAlias = _typing.Literal["_openapi_v3", b"_openapi_v3"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__openapi_v3) -> _WhichOneofReturnType__openapi_v3 | None: ...
+
+Global___Schema: _TypeAlias = Schema  # noqa: Y015
+
+@_typing.final
 class ResourceSelector(_message.Message):
-    __slots__ = ("api_version", "kind", "match_name", "match_labels", "namespace")
-    API_VERSION_FIELD_NUMBER: _ClassVar[int]
-    KIND_FIELD_NUMBER: _ClassVar[int]
-    MATCH_NAME_FIELD_NUMBER: _ClassVar[int]
-    MATCH_LABELS_FIELD_NUMBER: _ClassVar[int]
-    NAMESPACE_FIELD_NUMBER: _ClassVar[int]
-    api_version: str
-    kind: str
-    match_name: str
-    match_labels: MatchLabels
-    namespace: str
-    def __init__(self, api_version: _Optional[str] = ..., kind: _Optional[str] = ..., match_name: _Optional[str] = ..., match_labels: _Optional[_Union[MatchLabels, _Mapping]] = ..., namespace: _Optional[str] = ...) -> None: ...
+    """ResourceSelector selects a group of resources, either by name or by label."""
+
+    DESCRIPTOR: _descriptor.Descriptor
 
+    API_VERSION_FIELD_NUMBER: _builtins.int
+    KIND_FIELD_NUMBER: _builtins.int
+    MATCH_NAME_FIELD_NUMBER: _builtins.int
+    MATCH_LABELS_FIELD_NUMBER: _builtins.int
+    NAMESPACE_FIELD_NUMBER: _builtins.int
+    api_version: _builtins.str
+    """API version of resources to select."""
+    kind: _builtins.str
+    """Kind of resources to select."""
+    match_name: _builtins.str
+    """Match the resource with this name."""
+    namespace: _builtins.str
+    """Match resources in this namespace. Omit namespace to match cluster scoped
+    resources, or to match namespaced resources by labels across all
+    namespaces.
+    """
+    @_builtins.property
+    def match_labels(self) -> Global___MatchLabels:
+        """Match all resources with these labels."""
+
+    def __init__(
+        self,
+        *,
+        api_version: _builtins.str = ...,
+        kind: _builtins.str = ...,
+        match_name: _builtins.str = ...,
+        match_labels: Global___MatchLabels | None = ...,
+        namespace: _builtins.str | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_namespace", b"_namespace", "match", b"match", "match_labels", b"match_labels", "match_name", b"match_name", "namespace", b"namespace"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_namespace", b"_namespace", "api_version", b"api_version", "kind", b"kind", "match", b"match", "match_labels", b"match_labels", "match_name", b"match_name", "namespace", b"namespace"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__namespace: _TypeAlias = _typing.Literal["namespace"]  # noqa: Y015
+    _WhichOneofArgType__namespace: _TypeAlias = _typing.Literal["_namespace", b"_namespace"]  # noqa: Y015
+    _WhichOneofReturnType_match: _TypeAlias = _typing.Literal["match_name", "match_labels"]  # noqa: Y015
+    _WhichOneofArgType_match: _TypeAlias = _typing.Literal["match", b"match"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__namespace) -> _WhichOneofReturnType__namespace | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType_match) -> _WhichOneofReturnType_match | None: ...
+
+Global___ResourceSelector: _TypeAlias = ResourceSelector  # noqa: Y015
+
+@_typing.final
 class MatchLabels(_message.Message):
-    __slots__ = ("labels",)
+    """MatchLabels defines a set of labels to match resources against."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
     class LabelsEntry(_message.Message):
-        __slots__ = ("key", "value")
-        KEY_FIELD_NUMBER: _ClassVar[int]
-        VALUE_FIELD_NUMBER: _ClassVar[int]
-        key: str
-        value: str
-        def __init__(self, key: _Optional[str] = ..., value: _Optional[str] = ...) -> None: ...
-    LABELS_FIELD_NUMBER: _ClassVar[int]
-    labels: _containers.ScalarMap[str, str]
-    def __init__(self, labels: _Optional[_Mapping[str, str]] = ...) -> None: ...
+        DESCRIPTOR: _descriptor.Descriptor
 
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        value: _builtins.str
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: _builtins.str = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    LABELS_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def labels(self) -> _containers.ScalarMap[_builtins.str, _builtins.str]: ...
+    def __init__(
+        self,
+        *,
+        labels: _abc.Mapping[_builtins.str, _builtins.str] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["labels", b"labels"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___MatchLabels: _TypeAlias = MatchLabels  # noqa: Y015
+
+@_typing.final
 class ResponseMeta(_message.Message):
-    __slots__ = ("tag", "ttl")
-    TAG_FIELD_NUMBER: _ClassVar[int]
-    TTL_FIELD_NUMBER: _ClassVar[int]
-    tag: str
-    ttl: _duration_pb2.Duration
-    def __init__(self, tag: _Optional[str] = ..., ttl: _Optional[_Union[datetime.timedelta, _duration_pb2.Duration, _Mapping]] = ...) -> None: ...
+    """ResponseMeta contains metadata pertaining to a RunFunctionResponse."""
+
+    DESCRIPTOR: _descriptor.Descriptor
 
+    TAG_FIELD_NUMBER: _builtins.int
+    TTL_FIELD_NUMBER: _builtins.int
+    tag: _builtins.str
+    """An opaque string identifying the content of the request. Must match the
+    meta.tag of the corresponding RunFunctionRequest.
+    """
+    @_builtins.property
+    def ttl(self) -> _duration_pb2.Duration:
+        """Time-to-live of this response. Crossplane will call the function again when
+        the TTL expires. Crossplane may cache the response to avoid calling the
+        function again until the TTL expires.
+        """
+
+    def __init__(
+        self,
+        *,
+        tag: _builtins.str = ...,
+        ttl: _duration_pb2.Duration | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_ttl", b"_ttl", "ttl", b"ttl"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_ttl", b"_ttl", "tag", b"tag", "ttl", b"ttl"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__ttl: _TypeAlias = _typing.Literal["ttl"]  # noqa: Y015
+    _WhichOneofArgType__ttl: _TypeAlias = _typing.Literal["_ttl", b"_ttl"]  # noqa: Y015
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__ttl) -> _WhichOneofReturnType__ttl | None: ...
+
+Global___ResponseMeta: _TypeAlias = ResponseMeta  # noqa: Y015
+
+@_typing.final
 class State(_message.Message):
-    __slots__ = ("composite", "resources")
+    """State of the XR (XR) and any resources."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
     class ResourcesEntry(_message.Message):
-        __slots__ = ("key", "value")
-        KEY_FIELD_NUMBER: _ClassVar[int]
-        VALUE_FIELD_NUMBER: _ClassVar[int]
-        key: str
-        value: Resource
-        def __init__(self, key: _Optional[str] = ..., value: _Optional[_Union[Resource, _Mapping]] = ...) -> None: ...
-    COMPOSITE_FIELD_NUMBER: _ClassVar[int]
-    RESOURCES_FIELD_NUMBER: _ClassVar[int]
-    composite: Resource
-    resources: _containers.MessageMap[str, Resource]
-    def __init__(self, composite: _Optional[_Union[Resource, _Mapping]] = ..., resources: _Optional[_Mapping[str, Resource]] = ...) -> None: ...
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        @_builtins.property
+        def value(self) -> Global___Resource: ...
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: Global___Resource | None = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _typing.Literal["value", b"value"]  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    COMPOSITE_FIELD_NUMBER: _builtins.int
+    RESOURCES_FIELD_NUMBER: _builtins.int
+    @_builtins.property
+    def composite(self) -> Global___Resource:
+        """The state of the XR (XR)."""
+
+    @_builtins.property
+    def resources(self) -> _containers.MessageMap[_builtins.str, Global___Resource]:
+        """The state of any other resources. In composition functions these are the
+        composed resources. In operation functions they're arbitrary resources that
+        the operation wants to create or update.
+        """
+
+    def __init__(
+        self,
+        *,
+        composite: Global___Resource | None = ...,
+        resources: _abc.Mapping[_builtins.str, Global___Resource] | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["composite", b"composite"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["composite", b"composite", "resources", b"resources"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
 
+Global___State: _TypeAlias = State  # noqa: Y015
+
+@_typing.final
 class Resource(_message.Message):
-    __slots__ = ("resource", "connection_details", "ready")
+    """A Resource represents the state of a Kubernetes resource."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    @_typing.final
     class ConnectionDetailsEntry(_message.Message):
-        __slots__ = ("key", "value")
-        KEY_FIELD_NUMBER: _ClassVar[int]
-        VALUE_FIELD_NUMBER: _ClassVar[int]
-        key: str
-        value: bytes
-        def __init__(self, key: _Optional[str] = ..., value: _Optional[bytes] = ...) -> None: ...
-    RESOURCE_FIELD_NUMBER: _ClassVar[int]
-    CONNECTION_DETAILS_FIELD_NUMBER: _ClassVar[int]
-    READY_FIELD_NUMBER: _ClassVar[int]
-    resource: _struct_pb2.Struct
-    connection_details: _containers.ScalarMap[str, bytes]
-    ready: Ready
-    def __init__(self, resource: _Optional[_Union[_struct_pb2.Struct, _Mapping]] = ..., connection_details: _Optional[_Mapping[str, bytes]] = ..., ready: _Optional[_Union[Ready, str]] = ...) -> None: ...
+        DESCRIPTOR: _descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: _builtins.int
+        VALUE_FIELD_NUMBER: _builtins.int
+        key: _builtins.str
+        value: _builtins.bytes
+        def __init__(
+            self,
+            *,
+            key: _builtins.str = ...,
+            value: _builtins.bytes = ...,
+        ) -> None: ...
+        _HasFieldArgType: _TypeAlias = _Never  # noqa: Y015
+        def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+        _ClearFieldArgType: _TypeAlias = _typing.Literal["key", b"key", "value", b"value"]  # noqa: Y015
+        def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+        def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+    RESOURCE_FIELD_NUMBER: _builtins.int
+    CONNECTION_DETAILS_FIELD_NUMBER: _builtins.int
+    READY_FIELD_NUMBER: _builtins.int
+    ready: Global___Ready.ValueType
+    """Ready indicates whether the resource should be considered ready.
+
+    * Crossplane will never set this field in a RunFunctionRequest.
+
+    * A function should set this field to READY_TRUE in a RunFunctionResponse
+    to indicate that a desired resource is ready.
+
+    * A function should set this field to READY_TRUE in a RunFunctionResponse
+    to indicate that a desired XR is ready. This overwrites the standard
+    readiness detection that determines the ready state of the composite by the
+    ready state of the composed resources.
+
+    Ready is only used for composition. It's ignored by Operations.
+    """
+    @_builtins.property
+    def resource(self) -> _struct_pb2.Struct:
+        """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 the resource.
+
+        * A function may only specify the desired status of a XR - not its metadata
+        or spec. A function should not return desired metadata or spec for a XR.
+        This will be ignored.
+
+        * A function may not specify the desired status of any other resource -
+        e.g. composed resources. It may only specify their metadata and spec.
+        Status will be ignored.
+        """
+
+    @_builtins.property
+    def connection_details(self) -> _containers.ScalarMap[_builtins.str, _builtins.bytes]:
+        """The resource's connection details.
+
+        * Crossplane will set this field in a RunFunctionRequest to communicate the
+        the observed connection details of a composite or composed resource.
+
+        * A function should set this field in a RunFunctionResponse to indicate the
+        desired connection details of legacy XRs. For modern XRs, this will be ignored.
+
+        * A function should not set this field in a RunFunctionResponse to indicate
+        the desired connection details of a composed resource. This will be
+        ignored.
+
+        Connection details are only used for composition. They're ignored by
+        Operations.
+        """
+
+    def __init__(
+        self,
+        *,
+        resource: _struct_pb2.Struct | None = ...,
+        connection_details: _abc.Mapping[_builtins.str, _builtins.bytes] | None = ...,
+        ready: Global___Ready.ValueType = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["resource", b"resource"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["connection_details", b"connection_details", "ready", b"ready", "resource", b"resource"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    def WhichOneof(self, oneof_group: _Never) -> None: ...
+
+Global___Resource: _TypeAlias = Resource  # noqa: Y015
+
+@_typing.final
 class Result(_message.Message):
-    __slots__ = ("severity", "message", "reason", "target")
-    SEVERITY_FIELD_NUMBER: _ClassVar[int]
-    MESSAGE_FIELD_NUMBER: _ClassVar[int]
-    REASON_FIELD_NUMBER: _ClassVar[int]
-    TARGET_FIELD_NUMBER: _ClassVar[int]
-    severity: Severity
-    message: str
-    reason: str
-    target: Target
-    def __init__(self, severity: _Optional[_Union[Severity, str]] = ..., message: _Optional[str] = ..., reason: _Optional[str] = ..., target: _Optional[_Union[Target, str]] = ...) -> None: ...
+    """A Result of running a function."""
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    SEVERITY_FIELD_NUMBER: _builtins.int
+    MESSAGE_FIELD_NUMBER: _builtins.int
+    REASON_FIELD_NUMBER: _builtins.int
+    TARGET_FIELD_NUMBER: _builtins.int
+    severity: Global___Severity.ValueType
+    """Severity of this result."""
+    message: _builtins.str
+    """Human-readable details about the result."""
+    reason: _builtins.str
+    """Optional PascalCase, machine-readable reason for this result. If omitted,
+    the value will be ComposeResources.
+    """
+    target: Global___Target.ValueType
+    """The resources this result targets."""
+    def __init__(
+        self,
+        *,
+        severity: Global___Severity.ValueType = ...,
+        message: _builtins.str = ...,
+        reason: _builtins.str | None = ...,
+        target: Global___Target.ValueType | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_reason", b"_reason", "_target", b"_target", "reason", b"reason", "target", b"target"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_reason", b"_reason", "_target", b"_target", "message", b"message", "reason", b"reason", "severity", b"severity", "target", b"target"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__reason: _TypeAlias = _typing.Literal["reason"]  # noqa: Y015
+    _WhichOneofArgType__reason: _TypeAlias = _typing.Literal["_reason", b"_reason"]  # noqa: Y015
+    _WhichOneofReturnType__target: _TypeAlias = _typing.Literal["target"]  # noqa: Y015
+    _WhichOneofArgType__target: _TypeAlias = _typing.Literal["_target", b"_target"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__reason) -> _WhichOneofReturnType__reason | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__target) -> _WhichOneofReturnType__target | None: ...
 
+Global___Result: _TypeAlias = Result  # noqa: Y015
+
+@_typing.final
 class Condition(_message.Message):
-    __slots__ = ("type", "status", "reason", "message", "target")
-    TYPE_FIELD_NUMBER: _ClassVar[int]
-    STATUS_FIELD_NUMBER: _ClassVar[int]
-    REASON_FIELD_NUMBER: _ClassVar[int]
-    MESSAGE_FIELD_NUMBER: _ClassVar[int]
-    TARGET_FIELD_NUMBER: _ClassVar[int]
-    type: str
-    status: Status
-    reason: str
-    message: str
-    target: Target
-    def __init__(self, type: _Optional[str] = ..., status: _Optional[_Union[Status, str]] = ..., reason: _Optional[str] = ..., message: _Optional[str] = ..., target: _Optional[_Union[Target, str]] = ...) -> None: ...
+    """Status condition to be applied to the XR. Condition may also optionally be
+    applied to the XR's associated claim. For detailed information on proper
+    usage of status conditions, please see
+    https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#typical-status-properties.
+    """
+
+    DESCRIPTOR: _descriptor.Descriptor
+
+    TYPE_FIELD_NUMBER: _builtins.int
+    STATUS_FIELD_NUMBER: _builtins.int
+    REASON_FIELD_NUMBER: _builtins.int
+    MESSAGE_FIELD_NUMBER: _builtins.int
+    TARGET_FIELD_NUMBER: _builtins.int
+    type: _builtins.str
+    """Type of condition in PascalCase."""
+    status: Global___Status.ValueType
+    """Status of the condition."""
+    reason: _builtins.str
+    """Reason contains a programmatic identifier indicating the reason for the
+    condition's last transition. Producers of specific condition types may
+    define expected values and meanings for this field, and whether the values
+    are considered a guaranteed API. The value should be a PascalCase string.
+    This field may not be empty.
+    """
+    message: _builtins.str
+    """Message is a human readable message indicating details about the
+    transition. This may be an empty string.
+    """
+    target: Global___Target.ValueType
+    """The resources this condition targets."""
+    def __init__(
+        self,
+        *,
+        type: _builtins.str = ...,
+        status: Global___Status.ValueType = ...,
+        reason: _builtins.str = ...,
+        message: _builtins.str | None = ...,
+        target: Global___Target.ValueType | None = ...,
+    ) -> None: ...
+    _HasFieldArgType: _TypeAlias = _typing.Literal["_message", b"_message", "_target", b"_target", "message", b"message", "target", b"target"]  # noqa: Y015
+    def HasField(self, field_name: _HasFieldArgType) -> _builtins.bool: ...
+    _ClearFieldArgType: _TypeAlias = _typing.Literal["_message", b"_message", "_target", b"_target", "message", b"message", "reason", b"reason", "status", b"status", "target", b"target", "type", b"type"]  # noqa: Y015
+    def ClearField(self, field_name: _ClearFieldArgType) -> None: ...
+    _WhichOneofReturnType__message: _TypeAlias = _typing.Literal["message"]  # noqa: Y015
+    _WhichOneofArgType__message: _TypeAlias = _typing.Literal["_message", b"_message"]  # noqa: Y015
+    _WhichOneofReturnType__target: _TypeAlias = _typing.Literal["target"]  # noqa: Y015
+    _WhichOneofArgType__target: _TypeAlias = _typing.Literal["_target", b"_target"]  # noqa: Y015
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__message) -> _WhichOneofReturnType__message | None: ...
+    @_typing.overload
+    def WhichOneof(self, oneof_group: _WhichOneofArgType__target) -> _WhichOneofReturnType__target | None: ...
+
+Global___Condition: _TypeAlias = Condition  # noqa: Y015