@mcpg-dev/pulumi-crds 0.1.0-beta.8

package/types/output.ts

@@ -0,0 +1,3622 @@
+// *** WARNING: this file was generated by crd2pulumi. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import * as pulumi from "@pulumi/pulumi";
+import * as inputs from "../types/input";
+import * as outputs from "../types/output";
+
+export namespace mcpg {
+    export namespace v1alpha1 {
+        /**
+         * Auto-generated derived type for MCPGClusterSpec via `CustomResource`
+         */
+        export interface MCPGCluster {
+            /**
+             * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+             */
+            apiVersion: "mcpg.dev/v1alpha1";
+            /**
+             * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+             */
+            kind: "MCPGCluster";
+            /**
+             * Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+             */
+            metadata: outputs.meta.v1.ObjectMeta;
+            spec: outputs.mcpg.v1alpha1.MCPGClusterSpec;
+            status: outputs.mcpg.v1alpha1.MCPGClusterStatus;
+        }
+
+        /**
+         * Cluster-coordination backend binding.
+         * Cluster-scoped coordination-backend binding. Gateways reference
+         * it via `spec.clusterRef`; the operator injects the rendered
+         * `cluster:` config block (and the matching cluster cdylib entry)
+         * into each bound gateway's config.
+         */
+        export interface MCPGClusterSpec {
+            /**
+             * Which coordination backend this cluster provides.
+             */
+            backend: string;
+            /**
+             * Per-backend configuration, rendered verbatim into the
+             * gateway's `cluster:` block alongside `kind:` (the gateway
+             * flattens these — e.g. `url`, `key_prefix` for redis;
+             * `servers`, `bucket` for nats). Schema-blind: the gateway's
+             * own validator is the source of truth. Ignored for
+             * `single_node`.
+             */
+            config: {[key: string]: any};
+            /**
+             * Optional secret references whose keys are surfaced to the
+             * gateway as `${cluster.<key>}` config-substitution values —
+             * e.g. a Redis password or NATS credentials file. The operator
+             * projects these into the gateway pod the same way plugin
+             * Secrets are projected; the gateway resolves the `cred://`
+             * reference at config-load time. Keeps backend credentials out
+             * of the (world-readable) `MCPGCluster` spec.
+             */
+            credentialRefs: outputs.mcpg.v1alpha1.MCPGClusterSpecCredentialRefs[];
+            pluginRef: outputs.mcpg.v1alpha1.MCPGClusterSpecPluginRef;
+        }
+
+        /**
+         * A backend credential projected into bound gateway pods. The
+         * `secretName` lives in the operator's namespace (same trust
+         * boundary as plugin signing keys); `key` selects the entry.
+         */
+        export interface MCPGClusterSpecCredentialRefs {
+            /**
+             * Key within the Secret. Defaults to `name`.
+             */
+            key: string;
+            /**
+             * Logical name the gateway config references (e.g. `password`).
+             * Surfaced as `cred://cluster/<name>` to the gateway.
+             */
+            name: string;
+            /**
+             * Secret name in the operator namespace.
+             */
+            secretName: string;
+        }
+
+        /**
+         * A backend credential projected into bound gateway pods. The
+         * `secretName` lives in the operator's namespace (same trust
+         * boundary as plugin signing keys); `key` selects the entry.
+         */
+        export interface MCPGClusterSpecCredentialRefsPatch {
+            /**
+             * Key within the Secret. Defaults to `name`.
+             */
+            key: string;
+            /**
+             * Logical name the gateway config references (e.g. `password`).
+             * Surfaced as `cred://cluster/<name>` to the gateway.
+             */
+            name: string;
+            /**
+             * Secret name in the operator namespace.
+             */
+            secretName: string;
+        }
+
+        /**
+         * Cluster-coordination backend binding.
+         * Cluster-scoped coordination-backend binding. Gateways reference
+         * it via `spec.clusterRef`; the operator injects the rendered
+         * `cluster:` config block (and the matching cluster cdylib entry)
+         * into each bound gateway's config.
+         */
+        export interface MCPGClusterSpecPatch {
+            /**
+             * Which coordination backend this cluster provides.
+             */
+            backend: string;
+            /**
+             * Per-backend configuration, rendered verbatim into the
+             * gateway's `cluster:` block alongside `kind:` (the gateway
+             * flattens these — e.g. `url`, `key_prefix` for redis;
+             * `servers`, `bucket` for nats). Schema-blind: the gateway's
+             * own validator is the source of truth. Ignored for
+             * `single_node`.
+             */
+            config: {[key: string]: any};
+            /**
+             * Optional secret references whose keys are surfaced to the
+             * gateway as `${cluster.<key>}` config-substitution values —
+             * e.g. a Redis password or NATS credentials file. The operator
+             * projects these into the gateway pod the same way plugin
+             * Secrets are projected; the gateway resolves the `cred://`
+             * reference at config-load time. Keeps backend credentials out
+             * of the (world-readable) `MCPGCluster` spec.
+             */
+            credentialRefs: outputs.mcpg.v1alpha1.MCPGClusterSpecCredentialRefsPatch[];
+            pluginRef: outputs.mcpg.v1alpha1.MCPGClusterSpecPluginRefPatch;
+        }
+
+        /**
+         * Optional reference to the cluster cdylib's OCI source via a
+         * cluster-scoped `MCPGPlugin`. When set, the operator requires
+         * the named plugin to be `Ready` (verified + not revoked)
+         * before binding — so a coordinator can't come up against an
+         * unverified cluster plugin. When unset, the operator assumes
+         * the gateway's `pluginSetRef` already supplies the
+         * `dev.mcpg.cluster.<backend>` cdylib and only renders the
+         * `cluster:` config block.
+         */
+        export interface MCPGClusterSpecPluginRef {
+            name: string;
+        }
+
+        /**
+         * Optional reference to the cluster cdylib's OCI source via a
+         * cluster-scoped `MCPGPlugin`. When set, the operator requires
+         * the named plugin to be `Ready` (verified + not revoked)
+         * before binding — so a coordinator can't come up against an
+         * unverified cluster plugin. When unset, the operator assumes
+         * the gateway's `pluginSetRef` already supplies the
+         * `dev.mcpg.cluster.<backend>` cdylib and only renders the
+         * `cluster:` config block.
+         */
+        export interface MCPGClusterSpecPluginRefPatch {
+            name: string;
+        }
+
+        /**
+         * Observed state for `MCPGCluster`.
+         */
+        export interface MCPGClusterStatus {
+            /**
+             * Count of `MCPGGateway`s currently bound to this cluster via
+             * `spec.clusterRef`. Lets ops see blast radius before editing.
+             */
+            boundGateways: number;
+            /**
+             * Standard `metav1.Condition[]`. The operator sets `Ready=True`
+             * when the backend is bindable (plugin verified when
+             * `pluginRef` is set; always for `single_node`).
+             */
+            conditions: outputs.mcpg.v1alpha1.MCPGClusterStatusConditions[];
+            /**
+             * SHA-256 of the rendered `cluster:` config block. Bound
+             * gateways fold this into their pod-roll hash, so a cluster
+             * config edit rolls every bound gateway.
+             */
+            configHash: string;
+            lastReconcileTime: string;
+            observedGeneration: number;
+            /**
+             * The resolved cluster cdylib plugin id (`None`/absent for
+             * `single_node`). Surfaced so ops can confirm the backend
+             * mapping without reading the spec enum.
+             */
+            pluginId: string;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGClusterStatusConditions {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGClusterStatusConditionsPatch {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * Observed state for `MCPGCluster`.
+         */
+        export interface MCPGClusterStatusPatch {
+            /**
+             * Count of `MCPGGateway`s currently bound to this cluster via
+             * `spec.clusterRef`. Lets ops see blast radius before editing.
+             */
+            boundGateways: number;
+            /**
+             * Standard `metav1.Condition[]`. The operator sets `Ready=True`
+             * when the backend is bindable (plugin verified when
+             * `pluginRef` is set; always for `single_node`).
+             */
+            conditions: outputs.mcpg.v1alpha1.MCPGClusterStatusConditionsPatch[];
+            /**
+             * SHA-256 of the rendered `cluster:` config block. Bound
+             * gateways fold this into their pod-roll hash, so a cluster
+             * config edit rolls every bound gateway.
+             */
+            configHash: string;
+            lastReconcileTime: string;
+            observedGeneration: number;
+            /**
+             * The resolved cluster cdylib plugin id (`None`/absent for
+             * `single_node`). Surfaced so ops can confirm the backend
+             * mapping without reading the spec enum.
+             */
+            pluginId: string;
+        }
+
+        /**
+         * Auto-generated derived type for MCPGGatewaySpec via `CustomResource`
+         */
+        export interface MCPGGateway {
+            /**
+             * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+             */
+            apiVersion: "mcpg.dev/v1alpha1";
+            /**
+             * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+             */
+            kind: "MCPGGateway";
+            /**
+             * Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+             */
+            metadata: outputs.meta.v1.ObjectMeta;
+            spec: outputs.mcpg.v1alpha1.MCPGGatewaySpec;
+            status: outputs.mcpg.v1alpha1.MCPGGatewayStatus;
+        }
+
+        /**
+         * Desired state for a tenant's `MCPGGateway`.
+         *
+         * The operator's gateway controller renders this into a
+         * Deployment + Service + ConfigMap (+ optional Ingress,
+         * NetworkPolicy, PDB, ServiceMonitor) and reconciles them into
+         * the gateway's namespace. Every field maps either directly to
+         * a Kubernetes shape or to a gateway-config key that lands in
+         * the rendered ConfigMap.
+         *
+         * Cross-cutting fields (`pluginSetRef`, `revocationListRef`)
+         * pull in resources from the cluster-level plugin lifecycle —
+         * see [`crate::v1alpha1::MCPGPluginSet`] and
+         * [`crate::v1alpha1::MCPGRevocationList`].
+         */
+        export interface MCPGGatewaySpec {
+            /**
+             * Soft-tenancy allow-list: namespaces permitted to attach an
+             * `MCPGRoute` to this gateway. A route in a namespace NOT listed
+             * here is rejected at admission (and ignored by the route
+             * controller). Empty/unset ⇒ this gateway accepts no external
+             * routes (routes in the gateway's own namespace are always
+             * allowed). This is the platform team's explicit opt-in to which
+             * tenant namespaces may share the gateway.
+             */
+            acceptedRouteNamespaces: string[];
+            autoscaling: outputs.mcpg.v1alpha1.MCPGGatewaySpecAutoscaling;
+            cloud: outputs.mcpg.v1alpha1.MCPGGatewaySpecCloud;
+            clusterRef: outputs.mcpg.v1alpha1.MCPGGatewaySpecClusterRef;
+            config: {[key: string]: any};
+            image: outputs.mcpg.v1alpha1.MCPGGatewaySpecImage;
+            imagePullSecrets: outputs.mcpg.v1alpha1.MCPGGatewaySpecImagePullSecrets[];
+            ingress: outputs.mcpg.v1alpha1.MCPGGatewaySpecIngress;
+            monitoring: outputs.mcpg.v1alpha1.MCPGGatewaySpecMonitoring;
+            networkPolicy: outputs.mcpg.v1alpha1.MCPGGatewaySpecNetworkPolicy;
+            pluginSetRef: outputs.mcpg.v1alpha1.MCPGGatewaySpecPluginSetRef;
+            podAnnotations: {[key: string]: string};
+            podDisruptionBudget: outputs.mcpg.v1alpha1.MCPGGatewaySpecPodDisruptionBudget;
+            podLabels: {[key: string]: string};
+            probes: outputs.mcpg.v1alpha1.MCPGGatewaySpecProbes;
+            replicas: number;
+            resources: outputs.mcpg.v1alpha1.MCPGGatewaySpecResources;
+            revocationListRef: outputs.mcpg.v1alpha1.MCPGGatewaySpecRevocationListRef;
+            scheduling: outputs.mcpg.v1alpha1.MCPGGatewaySpecScheduling;
+            service: outputs.mcpg.v1alpha1.MCPGGatewaySpecService;
+            workloadIdentity: outputs.mcpg.v1alpha1.MCPGGatewaySpecWorkloadIdentity;
+        }
+
+        /**
+         * Optional HPA shape. When `enabled = true` the operator renders
+         * an `autoscaling/v2.HorizontalPodAutoscaler` targeting the
+         * gateway Deployment. Disabled by default — `replicas` is the
+         * canonical knob for most users.
+         */
+        export interface MCPGGatewaySpecAutoscaling {
+            enabled: boolean;
+            maxReplicas: number;
+            metrics: outputs.mcpg.v1alpha1.MCPGGatewaySpecAutoscalingMetrics[];
+            minReplicas: number;
+        }
+
+        export interface MCPGGatewaySpecAutoscalingMetrics {
+            external: {[key: string]: any};
+            object: {[key: string]: any};
+            pods: {[key: string]: any};
+            resource: {[key: string]: any};
+            type: string;
+        }
+
+        export interface MCPGGatewaySpecAutoscalingMetricsPatch {
+            external: {[key: string]: any};
+            object: {[key: string]: any};
+            pods: {[key: string]: any};
+            resource: {[key: string]: any};
+            type: string;
+        }
+
+        /**
+         * Optional HPA shape. When `enabled = true` the operator renders
+         * an `autoscaling/v2.HorizontalPodAutoscaler` targeting the
+         * gateway Deployment. Disabled by default — `replicas` is the
+         * canonical knob for most users.
+         */
+        export interface MCPGGatewaySpecAutoscalingPatch {
+            enabled: boolean;
+            maxReplicas: number;
+            metrics: outputs.mcpg.v1alpha1.MCPGGatewaySpecAutoscalingMetricsPatch[];
+            minReplicas: number;
+        }
+
+        /**
+         * Managed-fleet (mcpg.cloud) routing + identity. Present only on
+         * Cloud-provisioned gateways; absent for self-host, where a CR renders
+         * byte-identical to before. Consumed by the deploy-spine HTTPRoute
+         * renderer + the resource-metadata injector.
+         */
+        export interface MCPGGatewaySpecCloud {
+            /**
+             * Additional customer-owned hostnames (CNAME -> the instance edge); each
+             * gets its own HTTPRoute host match + TLS certificate.
+             */
+            customDomains: string[];
+            /**
+             * Canonical external URL (`https://{instanceSlug}.mcpg.cloud/mcp`). The
+             * operator injects this into `governance.access.resource_metadata.resource`
+             * so OAuth resource-indicator validation works; never trusted from a
+             * published config.
+             */
+            externalUrl: string;
+            /**
+             * Globally-unique instance slug — the public DNS label addressing the
+             * gateway at `{instanceSlug}.mcpg.cloud/mcp`. Drives the HTTPRoute host
+             * match + per-instance resource naming.
+             */
+            instanceSlug: string;
+            /**
+             * Tenant/org slug — billing + console grouping.
+             */
+            orgSlug: string;
+        }
+
+        /**
+         * Managed-fleet (mcpg.cloud) routing + identity. Present only on
+         * Cloud-provisioned gateways; absent for self-host, where a CR renders
+         * byte-identical to before. Consumed by the deploy-spine HTTPRoute
+         * renderer + the resource-metadata injector.
+         */
+        export interface MCPGGatewaySpecCloudPatch {
+            /**
+             * Additional customer-owned hostnames (CNAME -> the instance edge); each
+             * gets its own HTTPRoute host match + TLS certificate.
+             */
+            customDomains: string[];
+            /**
+             * Canonical external URL (`https://{instanceSlug}.mcpg.cloud/mcp`). The
+             * operator injects this into `governance.access.resource_metadata.resource`
+             * so OAuth resource-indicator validation works; never trusted from a
+             * published config.
+             */
+            externalUrl: string;
+            /**
+             * Globally-unique instance slug — the public DNS label addressing the
+             * gateway at `{instanceSlug}.mcpg.cloud/mcp`. Drives the HTTPRoute host
+             * match + per-instance resource naming.
+             */
+            instanceSlug: string;
+            /**
+             * Tenant/org slug — billing + console grouping.
+             */
+            orgSlug: string;
+        }
+
+        /**
+         * Reference to a cluster-scoped `MCPGCluster`. When set, the
+         * operator renders that backend's `cluster:` config block into
+         * this gateway's config (and folds the cluster's config-hash
+         * into the pod-roll trigger), so every replica binds the same
+         * coordinator. When unset the gateway runs `single_node`
+         * (in-process) — correct only for a single replica.
+         */
+        export interface MCPGGatewaySpecClusterRef {
+            /**
+             * Cluster-scoped `MCPGCluster` resource name.
+             */
+            name: string;
+        }
+
+        /**
+         * Reference to a cluster-scoped `MCPGCluster`. When set, the
+         * operator renders that backend's `cluster:` config block into
+         * this gateway's config (and folds the cluster's config-hash
+         * into the pod-roll trigger), so every replica binds the same
+         * coordinator. When unset the gateway runs `single_node`
+         * (in-process) — correct only for a single replica.
+         */
+        export interface MCPGGatewaySpecClusterRefPatch {
+            /**
+             * Cluster-scoped `MCPGCluster` resource name.
+             */
+            name: string;
+        }
+
+        /**
+         * Container image coordinates for the rendered gateway pod.
+         * All three fields default at reconcile time — `repository`
+         * from operator config, `tag` from the chart's appVersion,
+         * `pullPolicy` to `IfNotPresent`.
+         */
+        export interface MCPGGatewaySpecImage {
+            pullPolicy: string;
+            repository: string;
+            tag: string;
+        }
+
+        /**
+         * Container image coordinates for the rendered gateway pod.
+         * All three fields default at reconcile time — `repository`
+         * from operator config, `tag` from the chart's appVersion,
+         * `pullPolicy` to `IfNotPresent`.
+         */
+        export interface MCPGGatewaySpecImagePatch {
+            pullPolicy: string;
+            repository: string;
+            tag: string;
+        }
+
+        /**
+         * Same shape as `core/v1.LocalObjectReference`. Used wherever
+         * the spec needs to point at another in-namespace resource —
+         * imagePullSecrets, plugin refs, etc.
+         */
+        export interface MCPGGatewaySpecImagePullSecrets {
+            name: string;
+        }
+
+        /**
+         * Same shape as `core/v1.LocalObjectReference`. Used wherever
+         * the spec needs to point at another in-namespace resource —
+         * imagePullSecrets, plugin refs, etc.
+         */
+        export interface MCPGGatewaySpecImagePullSecretsPatch {
+            name: string;
+        }
+
+        export interface MCPGGatewaySpecIngress {
+            annotations: {[key: string]: string};
+            hosts: outputs.mcpg.v1alpha1.MCPGGatewaySpecIngressHosts[];
+            ingressClassName: string;
+            tls: outputs.mcpg.v1alpha1.MCPGGatewaySpecIngressTls[];
+        }
+
+        export interface MCPGGatewaySpecIngressHosts {
+            host: string;
+            paths: outputs.mcpg.v1alpha1.MCPGGatewaySpecIngressHostsPaths[];
+        }
+
+        export interface MCPGGatewaySpecIngressHostsPatch {
+            host: string;
+            paths: outputs.mcpg.v1alpha1.MCPGGatewaySpecIngressHostsPathsPatch[];
+        }
+
+        export interface MCPGGatewaySpecIngressHostsPaths {
+            path: string;
+            pathType: string;
+        }
+
+        export interface MCPGGatewaySpecIngressHostsPathsPatch {
+            path: string;
+            pathType: string;
+        }
+
+        export interface MCPGGatewaySpecIngressPatch {
+            annotations: {[key: string]: string};
+            hosts: outputs.mcpg.v1alpha1.MCPGGatewaySpecIngressHostsPatch[];
+            ingressClassName: string;
+            tls: outputs.mcpg.v1alpha1.MCPGGatewaySpecIngressTlsPatch[];
+        }
+
+        export interface MCPGGatewaySpecIngressTls {
+            hosts: string[];
+            secretName: string;
+        }
+
+        export interface MCPGGatewaySpecIngressTlsPatch {
+            hosts: string[];
+            secretName: string;
+        }
+
+        /**
+         * Toggles ServiceMonitor + PrometheusRule rendering. Both
+         * require the cluster to have the Prometheus Operator CRDs
+         * installed; the operator will skip rendering if the API
+         * group is absent (and surface a degraded status).
+         */
+        export interface MCPGGatewaySpecMonitoring {
+            prometheusRule: outputs.mcpg.v1alpha1.MCPGGatewaySpecMonitoringPrometheusRule;
+            serviceMonitor: outputs.mcpg.v1alpha1.MCPGGatewaySpecMonitoringServiceMonitor;
+        }
+
+        /**
+         * Toggles ServiceMonitor + PrometheusRule rendering. Both
+         * require the cluster to have the Prometheus Operator CRDs
+         * installed; the operator will skip rendering if the API
+         * group is absent (and surface a degraded status).
+         */
+        export interface MCPGGatewaySpecMonitoringPatch {
+            prometheusRule: outputs.mcpg.v1alpha1.MCPGGatewaySpecMonitoringPrometheusRulePatch;
+            serviceMonitor: outputs.mcpg.v1alpha1.MCPGGatewaySpecMonitoringServiceMonitorPatch;
+        }
+
+        /**
+         * Knobs for the rendered PrometheusRule. `severity` is
+         * stamped on every alert in the rendered group; defaults to
+         * `warning`.
+         */
+        export interface MCPGGatewaySpecMonitoringPrometheusRule {
+            enabled: boolean;
+            severity: string;
+        }
+
+        /**
+         * Knobs for the rendered PrometheusRule. `severity` is
+         * stamped on every alert in the rendered group; defaults to
+         * `warning`.
+         */
+        export interface MCPGGatewaySpecMonitoringPrometheusRulePatch {
+            enabled: boolean;
+            severity: string;
+        }
+
+        /**
+         * Knobs for the rendered ServiceMonitor. `interval` /
+         * `scrapeTimeout` follow Prometheus duration syntax (`30s`,
+         * `1m`).
+         */
+        export interface MCPGGatewaySpecMonitoringServiceMonitor {
+            enabled: boolean;
+            interval: string;
+            labels: {[key: string]: string};
+            scrapeTimeout: string;
+        }
+
+        /**
+         * Knobs for the rendered ServiceMonitor. `interval` /
+         * `scrapeTimeout` follow Prometheus duration syntax (`30s`,
+         * `1m`).
+         */
+        export interface MCPGGatewaySpecMonitoringServiceMonitorPatch {
+            enabled: boolean;
+            interval: string;
+            labels: {[key: string]: string};
+            scrapeTimeout: string;
+        }
+
+        /**
+         * Toggles whether the operator renders a NetworkPolicy alongside
+         * the gateway Deployment. The default policy denies all
+         * ingress/egress except the gateway listen port +
+         * management traffic; `extraIngressFrom` / `extraEgressTo`
+         * supply caller-specific exceptions (e.g. database egress).
+         */
+        export interface MCPGGatewaySpecNetworkPolicy {
+            enabled: boolean;
+            extraEgressTo: {[key: string]: any}[];
+            extraIngressFrom: {[key: string]: any}[];
+        }
+
+        /**
+         * Toggles whether the operator renders a NetworkPolicy alongside
+         * the gateway Deployment. The default policy denies all
+         * ingress/egress except the gateway listen port +
+         * management traffic; `extraIngressFrom` / `extraEgressTo`
+         * supply caller-specific exceptions (e.g. database egress).
+         */
+        export interface MCPGGatewaySpecNetworkPolicyPatch {
+            enabled: boolean;
+            extraEgressTo: {[key: string]: any}[];
+            extraIngressFrom: {[key: string]: any}[];
+        }
+
+        /**
+         * Desired state for a tenant's `MCPGGateway`.
+         *
+         * The operator's gateway controller renders this into a
+         * Deployment + Service + ConfigMap (+ optional Ingress,
+         * NetworkPolicy, PDB, ServiceMonitor) and reconciles them into
+         * the gateway's namespace. Every field maps either directly to
+         * a Kubernetes shape or to a gateway-config key that lands in
+         * the rendered ConfigMap.
+         *
+         * Cross-cutting fields (`pluginSetRef`, `revocationListRef`)
+         * pull in resources from the cluster-level plugin lifecycle —
+         * see [`crate::v1alpha1::MCPGPluginSet`] and
+         * [`crate::v1alpha1::MCPGRevocationList`].
+         */
+        export interface MCPGGatewaySpecPatch {
+            /**
+             * Soft-tenancy allow-list: namespaces permitted to attach an
+             * `MCPGRoute` to this gateway. A route in a namespace NOT listed
+             * here is rejected at admission (and ignored by the route
+             * controller). Empty/unset ⇒ this gateway accepts no external
+             * routes (routes in the gateway's own namespace are always
+             * allowed). This is the platform team's explicit opt-in to which
+             * tenant namespaces may share the gateway.
+             */
+            acceptedRouteNamespaces: string[];
+            autoscaling: outputs.mcpg.v1alpha1.MCPGGatewaySpecAutoscalingPatch;
+            cloud: outputs.mcpg.v1alpha1.MCPGGatewaySpecCloudPatch;
+            clusterRef: outputs.mcpg.v1alpha1.MCPGGatewaySpecClusterRefPatch;
+            config: {[key: string]: any};
+            image: outputs.mcpg.v1alpha1.MCPGGatewaySpecImagePatch;
+            imagePullSecrets: outputs.mcpg.v1alpha1.MCPGGatewaySpecImagePullSecretsPatch[];
+            ingress: outputs.mcpg.v1alpha1.MCPGGatewaySpecIngressPatch;
+            monitoring: outputs.mcpg.v1alpha1.MCPGGatewaySpecMonitoringPatch;
+            networkPolicy: outputs.mcpg.v1alpha1.MCPGGatewaySpecNetworkPolicyPatch;
+            pluginSetRef: outputs.mcpg.v1alpha1.MCPGGatewaySpecPluginSetRefPatch;
+            podAnnotations: {[key: string]: string};
+            podDisruptionBudget: outputs.mcpg.v1alpha1.MCPGGatewaySpecPodDisruptionBudgetPatch;
+            podLabels: {[key: string]: string};
+            probes: outputs.mcpg.v1alpha1.MCPGGatewaySpecProbesPatch;
+            replicas: number;
+            resources: outputs.mcpg.v1alpha1.MCPGGatewaySpecResourcesPatch;
+            revocationListRef: outputs.mcpg.v1alpha1.MCPGGatewaySpecRevocationListRefPatch;
+            scheduling: outputs.mcpg.v1alpha1.MCPGGatewaySpecSchedulingPatch;
+            service: outputs.mcpg.v1alpha1.MCPGGatewaySpecServicePatch;
+            workloadIdentity: outputs.mcpg.v1alpha1.MCPGGatewaySpecWorkloadIdentityPatch;
+        }
+
+        /**
+         * Reference to a `MCPGPluginSet` in the same namespace.
+         * When set, the gateway pod's projected volume includes the
+         * resolved per-plugin Secrets, and `plugins[]` in the
+         * rendered config is sourced from the set. Optional —
+         * gateways without a plugin set boot with whatever lives in
+         * `spec.config.plugins[]`.
+         */
+        export interface MCPGGatewaySpecPluginSetRef {
+            /**
+             * `MCPGPluginSet` resource name, in the same namespace as
+             * the gateway.
+             */
+            name: string;
+        }
+
+        /**
+         * Reference to a `MCPGPluginSet` in the same namespace.
+         * When set, the gateway pod's projected volume includes the
+         * resolved per-plugin Secrets, and `plugins[]` in the
+         * rendered config is sourced from the set. Optional —
+         * gateways without a plugin set boot with whatever lives in
+         * `spec.config.plugins[]`.
+         */
+        export interface MCPGGatewaySpecPluginSetRefPatch {
+            /**
+             * `MCPGPluginSet` resource name, in the same namespace as
+             * the gateway.
+             */
+            name: string;
+        }
+
+        /**
+         * Wraps `policy/v1.PodDisruptionBudgetSpec`. Both threshold
+         * fields are int-or-string to mirror the upstream API; pass
+         * either `"50%"` or `2`.
+         */
+        export interface MCPGGatewaySpecPodDisruptionBudget {
+            enabled: boolean;
+            maxUnavailable: number | string;
+            minAvailable: number | string;
+        }
+
+        /**
+         * Wraps `policy/v1.PodDisruptionBudgetSpec`. Both threshold
+         * fields are int-or-string to mirror the upstream API; pass
+         * either `"50%"` or `2`.
+         */
+        export interface MCPGGatewaySpecPodDisruptionBudgetPatch {
+            enabled: boolean;
+            maxUnavailable: number | string;
+            minAvailable: number | string;
+        }
+
+        /**
+         * Optional per-probe overrides. When `None`, the operator's
+         * rendered Deployment uses the chart defaults (which target
+         * `/healthz` + `/readyz` on the management port).
+         */
+        export interface MCPGGatewaySpecProbes {
+            liveness: outputs.mcpg.v1alpha1.MCPGGatewaySpecProbesLiveness;
+            readiness: outputs.mcpg.v1alpha1.MCPGGatewaySpecProbesReadiness;
+            startup: outputs.mcpg.v1alpha1.MCPGGatewaySpecProbesStartup;
+        }
+
+        /**
+         * Per-probe knobs. Maps directly to `core/v1.Probe` minus the
+         * handler — handler is always HTTP GET on the management port
+         * for the gateway (see the rendered Deployment template).
+         */
+        export interface MCPGGatewaySpecProbesLiveness {
+            failureThreshold: number;
+            initialDelaySeconds: number;
+            path: string;
+            periodSeconds: number;
+            successThreshold: number;
+            timeoutSeconds: number;
+        }
+
+        /**
+         * Per-probe knobs. Maps directly to `core/v1.Probe` minus the
+         * handler — handler is always HTTP GET on the management port
+         * for the gateway (see the rendered Deployment template).
+         */
+        export interface MCPGGatewaySpecProbesLivenessPatch {
+            failureThreshold: number;
+            initialDelaySeconds: number;
+            path: string;
+            periodSeconds: number;
+            successThreshold: number;
+            timeoutSeconds: number;
+        }
+
+        /**
+         * Optional per-probe overrides. When `None`, the operator's
+         * rendered Deployment uses the chart defaults (which target
+         * `/healthz` + `/readyz` on the management port).
+         */
+        export interface MCPGGatewaySpecProbesPatch {
+            liveness: outputs.mcpg.v1alpha1.MCPGGatewaySpecProbesLivenessPatch;
+            readiness: outputs.mcpg.v1alpha1.MCPGGatewaySpecProbesReadinessPatch;
+            startup: outputs.mcpg.v1alpha1.MCPGGatewaySpecProbesStartupPatch;
+        }
+
+        /**
+         * Per-probe knobs. Maps directly to `core/v1.Probe` minus the
+         * handler — handler is always HTTP GET on the management port
+         * for the gateway (see the rendered Deployment template).
+         */
+        export interface MCPGGatewaySpecProbesReadiness {
+            failureThreshold: number;
+            initialDelaySeconds: number;
+            path: string;
+            periodSeconds: number;
+            successThreshold: number;
+            timeoutSeconds: number;
+        }
+
+        /**
+         * Per-probe knobs. Maps directly to `core/v1.Probe` minus the
+         * handler — handler is always HTTP GET on the management port
+         * for the gateway (see the rendered Deployment template).
+         */
+        export interface MCPGGatewaySpecProbesReadinessPatch {
+            failureThreshold: number;
+            initialDelaySeconds: number;
+            path: string;
+            periodSeconds: number;
+            successThreshold: number;
+            timeoutSeconds: number;
+        }
+
+        /**
+         * Per-probe knobs. Maps directly to `core/v1.Probe` minus the
+         * handler — handler is always HTTP GET on the management port
+         * for the gateway (see the rendered Deployment template).
+         */
+        export interface MCPGGatewaySpecProbesStartup {
+            failureThreshold: number;
+            initialDelaySeconds: number;
+            path: string;
+            periodSeconds: number;
+            successThreshold: number;
+            timeoutSeconds: number;
+        }
+
+        /**
+         * Per-probe knobs. Maps directly to `core/v1.Probe` minus the
+         * handler — handler is always HTTP GET on the management port
+         * for the gateway (see the rendered Deployment template).
+         */
+        export interface MCPGGatewaySpecProbesStartupPatch {
+            failureThreshold: number;
+            initialDelaySeconds: number;
+            path: string;
+            periodSeconds: number;
+            successThreshold: number;
+            timeoutSeconds: number;
+        }
+
+        /**
+         * Maps directly to `core/v1.ResourceRequirements`. We carry our
+         * own type rather than depending on `k8s-openapi` here because
+         * `operator-api` is `k8s-openapi`-version-agnostic — see the
+         * crate-level docs.
+         */
+        export interface MCPGGatewaySpecResources {
+            limits: {[key: string]: string};
+            requests: {[key: string]: string};
+        }
+
+        /**
+         * Maps directly to `core/v1.ResourceRequirements`. We carry our
+         * own type rather than depending on `k8s-openapi` here because
+         * `operator-api` is `k8s-openapi`-version-agnostic — see the
+         * crate-level docs.
+         */
+        export interface MCPGGatewaySpecResourcesPatch {
+            limits: {[key: string]: string};
+            requests: {[key: string]: string};
+        }
+
+        /**
+         * Reference to a cluster-scoped `MCPGRevocationList`. Defaults
+         * to the operator's `cluster-default` resource when unset.
+         * The operator materialises the revocation list into the
+         * gateway's namespace and mounts it; gateway pods enforce
+         * at plugin-load time.
+         */
+        export interface MCPGGatewaySpecRevocationListRef {
+            /**
+             * Cluster-scoped `MCPGRevocationList` resource name.
+             */
+            name: string;
+        }
+
+        /**
+         * Reference to a cluster-scoped `MCPGRevocationList`. Defaults
+         * to the operator's `cluster-default` resource when unset.
+         * The operator materialises the revocation list into the
+         * gateway's namespace and mounts it; gateway pods enforce
+         * at plugin-load time.
+         */
+        export interface MCPGGatewaySpecRevocationListRefPatch {
+            /**
+             * Cluster-scoped `MCPGRevocationList` resource name.
+             */
+            name: string;
+        }
+
+        /**
+         * Pod-scheduling pass-through fields. Each maps directly to
+         * the matching `PodSpec` field; the operator does not interpret
+         * them. `tolerations` and `affinity` are
+         * `x-kubernetes-preserve-unknown-fields` so we don't have to
+         * version-shift the operator's `k8s-openapi` dependency every
+         * time upstream adds a knob.
+         */
+        export interface MCPGGatewaySpecScheduling {
+            affinity: {[key: string]: any};
+            nodeSelector: {[key: string]: string};
+            priorityClassName: string;
+            terminationGracePeriodSeconds: number;
+            tolerations: {[key: string]: any}[];
+            topologySpreadConstraints: outputs.mcpg.v1alpha1.MCPGGatewaySpecSchedulingTopologySpreadConstraints[];
+        }
+
+        /**
+         * Pod-scheduling pass-through fields. Each maps directly to
+         * the matching `PodSpec` field; the operator does not interpret
+         * them. `tolerations` and `affinity` are
+         * `x-kubernetes-preserve-unknown-fields` so we don't have to
+         * version-shift the operator's `k8s-openapi` dependency every
+         * time upstream adds a knob.
+         */
+        export interface MCPGGatewaySpecSchedulingPatch {
+            affinity: {[key: string]: any};
+            nodeSelector: {[key: string]: string};
+            priorityClassName: string;
+            terminationGracePeriodSeconds: number;
+            tolerations: {[key: string]: any}[];
+            topologySpreadConstraints: outputs.mcpg.v1alpha1.MCPGGatewaySpecSchedulingTopologySpreadConstraintsPatch[];
+        }
+
+        export interface MCPGGatewaySpecSchedulingTopologySpreadConstraints {
+            labelSelectorMatchLabels: {[key: string]: string};
+            maxSkew: number;
+            topologyKey: string;
+            whenUnsatisfiable: string;
+        }
+
+        export interface MCPGGatewaySpecSchedulingTopologySpreadConstraintsPatch {
+            labelSelectorMatchLabels: {[key: string]: string};
+            maxSkew: number;
+            topologyKey: string;
+            whenUnsatisfiable: string;
+        }
+
+        export interface MCPGGatewaySpecService {
+            annotations: {[key: string]: string};
+            port: number;
+            type: string;
+        }
+
+        export interface MCPGGatewaySpecServicePatch {
+            annotations: {[key: string]: string};
+            port: number;
+            type: string;
+        }
+
+        /**
+         * One-of: pick exactly one cloud provider. The operator
+         * translates the chosen variant into the right ServiceAccount
+         * annotations / projected-volume mounts at render time.
+         * Multiple variants set simultaneously is an admission error.
+         */
+        export interface MCPGGatewaySpecWorkloadIdentity {
+            aws: outputs.mcpg.v1alpha1.MCPGGatewaySpecWorkloadIdentityAws;
+            azure: outputs.mcpg.v1alpha1.MCPGGatewaySpecWorkloadIdentityAzure;
+            gcp: outputs.mcpg.v1alpha1.MCPGGatewaySpecWorkloadIdentityGcp;
+            spiffe: outputs.mcpg.v1alpha1.MCPGGatewaySpecWorkloadIdentitySpiffe;
+        }
+
+        export interface MCPGGatewaySpecWorkloadIdentityAws {
+            iamRoleArn: string;
+        }
+
+        export interface MCPGGatewaySpecWorkloadIdentityAwsPatch {
+            iamRoleArn: string;
+        }
+
+        export interface MCPGGatewaySpecWorkloadIdentityAzure {
+            clientId: string;
+        }
+
+        export interface MCPGGatewaySpecWorkloadIdentityAzurePatch {
+            clientId: string;
+        }
+
+        export interface MCPGGatewaySpecWorkloadIdentityGcp {
+            googleServiceAccount: string;
+        }
+
+        export interface MCPGGatewaySpecWorkloadIdentityGcpPatch {
+            googleServiceAccount: string;
+        }
+
+        /**
+         * One-of: pick exactly one cloud provider. The operator
+         * translates the chosen variant into the right ServiceAccount
+         * annotations / projected-volume mounts at render time.
+         * Multiple variants set simultaneously is an admission error.
+         */
+        export interface MCPGGatewaySpecWorkloadIdentityPatch {
+            aws: outputs.mcpg.v1alpha1.MCPGGatewaySpecWorkloadIdentityAwsPatch;
+            azure: outputs.mcpg.v1alpha1.MCPGGatewaySpecWorkloadIdentityAzurePatch;
+            gcp: outputs.mcpg.v1alpha1.MCPGGatewaySpecWorkloadIdentityGcpPatch;
+            spiffe: outputs.mcpg.v1alpha1.MCPGGatewaySpecWorkloadIdentitySpiffePatch;
+        }
+
+        export interface MCPGGatewaySpecWorkloadIdentitySpiffe {
+            svid: string;
+            trustDomain: string;
+        }
+
+        export interface MCPGGatewaySpecWorkloadIdentitySpiffePatch {
+            svid: string;
+            trustDomain: string;
+        }
+
+        /**
+         * Observed state for `MCPGGateway`. `conditions` is the
+         * authoritative readiness signal; the hash fields let
+         * operators verify "the right plugin set / revocation list
+         * has actually been folded in".
+         */
+        export interface MCPGGatewayStatus {
+            availableReplicas: number;
+            conditions: outputs.mcpg.v1alpha1.MCPGGatewayStatusConditions[];
+            /**
+             * SHA-256 of the rendered config — flips on any spec change
+             * that propagates to the pod template. Operators watch this
+             * to confirm "operator has applied my edit".
+             */
+            configHash: string;
+            lastReconcileTime: string;
+            observedGeneration: number;
+            /**
+             * Resolved hash of the active `MCPGPluginSet` — non-null when
+             * `spec.pluginSetRef` is set + the set is `Ready`.
+             */
+            pluginSetHash: string;
+            readyReplicas: number;
+            replicas: number;
+            /**
+             * Hash of the active `MCPGRevocationList`'s materialised
+             * content. Lets operators verify "every gateway is on the
+             * same revocation rev" cluster-wide.
+             */
+            revocationListHash: string;
+            updatedReplicas: number;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGGatewayStatusConditions {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGGatewayStatusConditionsPatch {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * Observed state for `MCPGGateway`. `conditions` is the
+         * authoritative readiness signal; the hash fields let
+         * operators verify "the right plugin set / revocation list
+         * has actually been folded in".
+         */
+        export interface MCPGGatewayStatusPatch {
+            availableReplicas: number;
+            conditions: outputs.mcpg.v1alpha1.MCPGGatewayStatusConditionsPatch[];
+            /**
+             * SHA-256 of the rendered config — flips on any spec change
+             * that propagates to the pod template. Operators watch this
+             * to confirm "operator has applied my edit".
+             */
+            configHash: string;
+            lastReconcileTime: string;
+            observedGeneration: number;
+            /**
+             * Resolved hash of the active `MCPGPluginSet` — non-null when
+             * `spec.pluginSetRef` is set + the set is `Ready`.
+             */
+            pluginSetHash: string;
+            readyReplicas: number;
+            replicas: number;
+            /**
+             * Hash of the active `MCPGRevocationList`'s materialised
+             * content. Lets operators verify "every gateway is on the
+             * same revocation rev" cluster-wide.
+             */
+            revocationListHash: string;
+            updatedReplicas: number;
+        }
+
+        /**
+         * Auto-generated derived type for MCPGPluginSpec via `CustomResource`
+         */
+        export interface MCPGPlugin {
+            /**
+             * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+             */
+            apiVersion: "mcpg.dev/v1alpha1";
+            /**
+             * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+             */
+            kind: "MCPGPlugin";
+            /**
+             * Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+             */
+            metadata: outputs.meta.v1.ObjectMeta;
+            spec: outputs.mcpg.v1alpha1.MCPGPluginSpec;
+            status: outputs.mcpg.v1alpha1.MCPGPluginStatus;
+        }
+
+        /**
+         * Auto-generated derived type for MCPGPluginMirrorSpec via `CustomResource`
+         */
+        export interface MCPGPluginMirror {
+            /**
+             * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+             */
+            apiVersion: "mcpg.dev/v1alpha1";
+            /**
+             * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+             */
+            kind: "MCPGPluginMirror";
+            /**
+             * Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+             */
+            metadata: outputs.meta.v1.ObjectMeta;
+            spec: outputs.mcpg.v1alpha1.MCPGPluginMirrorSpec;
+            status: outputs.mcpg.v1alpha1.MCPGPluginMirrorStatus;
+        }
+
+        /**
+         * In-cluster OCI mirror for air-gapped plugin pulls.
+         * Cluster-scoped OCI mirror. `MCPGPlugin.spec.oci.mirrorRef` points
+         * here; the operator rewrites the upstream ref onto this mirror's
+         * endpoint before pulling.
+         */
+        export interface MCPGPluginMirrorSpec {
+            auth: outputs.mcpg.v1alpha1.MCPGPluginMirrorSpecAuth;
+            endpoint: outputs.mcpg.v1alpha1.MCPGPluginMirrorSpecEndpoint;
+            /**
+             * Optional reachability re-check cadence (informational; e.g.
+             * `1h`). The operator re-reconciles the mirror on its normal
+             * resync regardless — this is a hint for future scheduled probes.
+             */
+            resyncInterval: string;
+            upstream: outputs.mcpg.v1alpha1.MCPGPluginMirrorSpecUpstream;
+        }
+
+        /**
+         * Optional pull credentials for the mirror (a
+         * `kubernetes.io/dockerconfigjson` Secret in the operator
+         * namespace). When set, the operator pulls from the mirror with
+         * these instead of the plugin's own `oci.pullSecretRef`.
+         */
+        export interface MCPGPluginMirrorSpecAuth {
+            secretRef: outputs.mcpg.v1alpha1.MCPGPluginMirrorSpecAuthSecretRef;
+        }
+
+        /**
+         * Optional pull credentials for the mirror (a
+         * `kubernetes.io/dockerconfigjson` Secret in the operator
+         * namespace). When set, the operator pulls from the mirror with
+         * these instead of the plugin's own `oci.pullSecretRef`.
+         */
+        export interface MCPGPluginMirrorSpecAuthPatch {
+            secretRef: outputs.mcpg.v1alpha1.MCPGPluginMirrorSpecAuthSecretRefPatch;
+        }
+
+        /**
+         * Reference to a `dockerconfigjson` Secret in the operator namespace.
+         */
+        export interface MCPGPluginMirrorSpecAuthSecretRef {
+            /**
+             * Key within the Secret. Defaults to `.dockerconfigjson` when
+             * unset (the standard key for `kubernetes.io/dockerconfigjson`).
+             */
+            key: string;
+            secretName: string;
+        }
+
+        /**
+         * Reference to a `dockerconfigjson` Secret in the operator namespace.
+         */
+        export interface MCPGPluginMirrorSpecAuthSecretRefPatch {
+            /**
+             * Key within the Secret. Defaults to `.dockerconfigjson` when
+             * unset (the standard key for `kubernetes.io/dockerconfigjson`).
+             */
+            key: string;
+            secretName: string;
+        }
+
+        /**
+         * Where the mirror registry lives in-cluster.
+         */
+        export interface MCPGPluginMirrorSpecEndpoint {
+            /**
+             * When true, the operator treats the mirror as plain-HTTP /
+             * self-signed (added to the OCI client's insecure-registry list).
+             * In-cluster mirrors on `:80` are the common case.
+             */
+            insecure: boolean;
+            service: outputs.mcpg.v1alpha1.MCPGPluginMirrorSpecEndpointService;
+        }
+
+        /**
+         * Where the mirror registry lives in-cluster.
+         */
+        export interface MCPGPluginMirrorSpecEndpointPatch {
+            /**
+             * When true, the operator treats the mirror as plain-HTTP /
+             * self-signed (added to the OCI client's insecure-registry list).
+             * In-cluster mirrors on `:80` are the common case.
+             */
+            insecure: boolean;
+            service: outputs.mcpg.v1alpha1.MCPGPluginMirrorSpecEndpointServicePatch;
+        }
+
+        /**
+         * Service coordinates for the mirror registry.
+         */
+        export interface MCPGPluginMirrorSpecEndpointService {
+            name: string;
+            namespace: string;
+            /**
+             * Optional path prefix the mirror serves repositories under
+             * (e.g. `/v2/mirror`). Joined between the registry host and the
+             * upstream repository path. Leading/trailing slashes are
+             * normalised.
+             */
+            pathPrefix: string;
+            /**
+             * Service port the registry listens on (e.g. `80`).
+             */
+            port: number;
+        }
+
+        /**
+         * Service coordinates for the mirror registry.
+         */
+        export interface MCPGPluginMirrorSpecEndpointServicePatch {
+            name: string;
+            namespace: string;
+            /**
+             * Optional path prefix the mirror serves repositories under
+             * (e.g. `/v2/mirror`). Joined between the registry host and the
+             * upstream repository path. Leading/trailing slashes are
+             * normalised.
+             */
+            pathPrefix: string;
+            /**
+             * Service port the registry listens on (e.g. `80`).
+             */
+            port: number;
+        }
+
+        /**
+         * In-cluster OCI mirror for air-gapped plugin pulls.
+         * Cluster-scoped OCI mirror. `MCPGPlugin.spec.oci.mirrorRef` points
+         * here; the operator rewrites the upstream ref onto this mirror's
+         * endpoint before pulling.
+         */
+        export interface MCPGPluginMirrorSpecPatch {
+            auth: outputs.mcpg.v1alpha1.MCPGPluginMirrorSpecAuthPatch;
+            endpoint: outputs.mcpg.v1alpha1.MCPGPluginMirrorSpecEndpointPatch;
+            /**
+             * Optional reachability re-check cadence (informational; e.g.
+             * `1h`). The operator re-reconciles the mirror on its normal
+             * resync regardless — this is a hint for future scheduled probes.
+             */
+            resyncInterval: string;
+            upstream: outputs.mcpg.v1alpha1.MCPGPluginMirrorSpecUpstreamPatch;
+        }
+
+        /**
+         * The public registry + namespace this mirror stands in for. Only
+         * plugin refs whose `image` starts with `<registry>/<namespace>`
+         * are rewritten; a ref pointing elsewhere is left untouched (and
+         * the air-gap admission gate, when enforced, rejects it).
+         */
+        export interface MCPGPluginMirrorSpecUpstream {
+            /**
+             * Namespace/org path under the registry, e.g.
+             * `mcpg-dev/source-code`. The repository segment after this
+             * prefix is preserved verbatim on the mirror.
+             */
+            namespace: string;
+            /**
+             * Registry hostname, e.g. `ghcr.io`.
+             */
+            registry: string;
+        }
+
+        /**
+         * The public registry + namespace this mirror stands in for. Only
+         * plugin refs whose `image` starts with `<registry>/<namespace>`
+         * are rewritten; a ref pointing elsewhere is left untouched (and
+         * the air-gap admission gate, when enforced, rejects it).
+         */
+        export interface MCPGPluginMirrorSpecUpstreamPatch {
+            /**
+             * Namespace/org path under the registry, e.g.
+             * `mcpg-dev/source-code`. The repository segment after this
+             * prefix is preserved verbatim on the mirror.
+             */
+            namespace: string;
+            /**
+             * Registry hostname, e.g. `ghcr.io`.
+             */
+            registry: string;
+        }
+
+        /**
+         * Observed state for `MCPGPluginMirror`.
+         */
+        export interface MCPGPluginMirrorStatus {
+            conditions: outputs.mcpg.v1alpha1.MCPGPluginMirrorStatusConditions[];
+            /**
+             * The resolved in-cluster registry host
+             * (`<name>.<namespace>.svc.cluster.local:<port>`), surfaced so ops
+             * can confirm the rewrite target without parsing the spec.
+             */
+            endpointHost: string;
+            lastReconcileTime: string;
+            observedGeneration: number;
+            /**
+             * Count of `MCPGPlugin`s currently referencing this mirror via
+             * `oci.mirrorRef`. Blast-radius signal for ops.
+             */
+            proxiedReferences: number;
+            /**
+             * Whether the operator could reach the mirror's `/v2/` endpoint at
+             * last reconcile. `false` (with a `Ready=False` condition) means
+             * plugin pulls through this mirror will fail.
+             */
+            reachable: boolean;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGPluginMirrorStatusConditions {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGPluginMirrorStatusConditionsPatch {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * Observed state for `MCPGPluginMirror`.
+         */
+        export interface MCPGPluginMirrorStatusPatch {
+            conditions: outputs.mcpg.v1alpha1.MCPGPluginMirrorStatusConditionsPatch[];
+            /**
+             * The resolved in-cluster registry host
+             * (`<name>.<namespace>.svc.cluster.local:<port>`), surfaced so ops
+             * can confirm the rewrite target without parsing the spec.
+             */
+            endpointHost: string;
+            lastReconcileTime: string;
+            observedGeneration: number;
+            /**
+             * Count of `MCPGPlugin`s currently referencing this mirror via
+             * `oci.mirrorRef`. Blast-radius signal for ops.
+             */
+            proxiedReferences: number;
+            /**
+             * Whether the operator could reach the mirror's `/v2/` endpoint at
+             * last reconcile. `false` (with a `Ready=False` condition) means
+             * plugin pulls through this mirror will fail.
+             */
+            reachable: boolean;
+        }
+
+        /**
+         * Auto-generated derived type for MCPGPluginSetSpec via `CustomResource`
+         */
+        export interface MCPGPluginSet {
+            /**
+             * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+             */
+            apiVersion: "mcpg.dev/v1alpha1";
+            /**
+             * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+             */
+            kind: "MCPGPluginSet";
+            /**
+             * Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+             */
+            metadata: outputs.meta.v1.ObjectMeta;
+            spec: outputs.mcpg.v1alpha1.MCPGPluginSetSpec;
+            status: outputs.mcpg.v1alpha1.MCPGPluginSetStatus;
+        }
+
+        export interface MCPGPluginSetSpec {
+            /**
+             * Per-plugin capability grants. Keyed by plugin id; values
+             * are subsets of the plugin descriptor's
+             * `required_capabilities`. The operator's admission
+             * webhook validates the subset relationship.
+             */
+            capabilityGrants: {[key: string]: string[]};
+            /**
+             * One entry per plugin the set installs. Order is
+             * preserved in the rendered gateway config (some plugin
+             * chains are order-sensitive — e.g. identity → policy).
+             */
+            entries: outputs.mcpg.v1alpha1.MCPGPluginSetSpecEntries[];
+        }
+
+        /**
+         * One plugin in a `MCPGPluginSet`. Order in the spec is the
+         * order the gateway sees in its boot config — order-sensitive
+         * chains (identity → policy → audit) must rely on this.
+         */
+        export interface MCPGPluginSetSpecEntries {
+            /**
+             * Inline plugin runtime config — passes through verbatim
+             * to the gateway's `plugins[].config`. Schema
+             * varies per plugin; the operator does not validate it
+             * (the gateway's own boot-time validators do). The
+             * `preserve_object` schema annotation marks this field
+             * `x-kubernetes-preserve-unknown-fields` so the API server
+             * keeps the arbitrary nested config intact.
+             */
+            config: {[key: string]: any};
+            /**
+             * Whether this entry is active. Disabled entries pass
+             * through to status (so operators see what's configured)
+             * but the operator skips them when rendering the gateway
+             * config + materialising plugin Secrets.
+             */
+            enabled: boolean;
+            /**
+             * Whether the plugin is enforced (default) or runs in
+             * shadow mode. Shadow plugins evaluate, log, and emit
+             * metrics, but their Deny/Challenge decisions are mapped
+             * to Allow before reaching the request flow. Operators
+             * use this to roll out a new policy plugin in observation
+             * mode before promoting to enforce.
+             *
+             * Maps to `PluginEntryConfig.enforce` in the gateway boot
+             * config. Defaults to `true` — pre-1.0 we bias toward
+             * fail-closed: operators must explicitly opt in to shadow
+             * mode.
+             */
+            enforce: boolean;
+            /**
+             * Plugin id — e.g. `dev.mcpg.identity.workload`. Must
+             * match the referenced `MCPGPlugin.spec.pluginId`; the
+             * admission webhook flags mismatches.
+             */
+            id: string;
+            pluginRef: outputs.mcpg.v1alpha1.MCPGPluginSetSpecEntriesPluginRef;
+        }
+
+        /**
+         * One plugin in a `MCPGPluginSet`. Order in the spec is the
+         * order the gateway sees in its boot config — order-sensitive
+         * chains (identity → policy → audit) must rely on this.
+         */
+        export interface MCPGPluginSetSpecEntriesPatch {
+            /**
+             * Inline plugin runtime config — passes through verbatim
+             * to the gateway's `plugins[].config`. Schema
+             * varies per plugin; the operator does not validate it
+             * (the gateway's own boot-time validators do). The
+             * `preserve_object` schema annotation marks this field
+             * `x-kubernetes-preserve-unknown-fields` so the API server
+             * keeps the arbitrary nested config intact.
+             */
+            config: {[key: string]: any};
+            /**
+             * Whether this entry is active. Disabled entries pass
+             * through to status (so operators see what's configured)
+             * but the operator skips them when rendering the gateway
+             * config + materialising plugin Secrets.
+             */
+            enabled: boolean;
+            /**
+             * Whether the plugin is enforced (default) or runs in
+             * shadow mode. Shadow plugins evaluate, log, and emit
+             * metrics, but their Deny/Challenge decisions are mapped
+             * to Allow before reaching the request flow. Operators
+             * use this to roll out a new policy plugin in observation
+             * mode before promoting to enforce.
+             *
+             * Maps to `PluginEntryConfig.enforce` in the gateway boot
+             * config. Defaults to `true` — pre-1.0 we bias toward
+             * fail-closed: operators must explicitly opt in to shadow
+             * mode.
+             */
+            enforce: boolean;
+            /**
+             * Plugin id — e.g. `dev.mcpg.identity.workload`. Must
+             * match the referenced `MCPGPlugin.spec.pluginId`; the
+             * admission webhook flags mismatches.
+             */
+            id: string;
+            pluginRef: outputs.mcpg.v1alpha1.MCPGPluginSetSpecEntriesPluginRefPatch;
+        }
+
+        /**
+         * Reference to a cluster-scoped `MCPGPlugin`. Operator
+         * validates the plugin exists + is in `Ready` status before
+         * allowing the set to converge.
+         */
+        export interface MCPGPluginSetSpecEntriesPluginRef {
+            name: string;
+        }
+
+        /**
+         * Reference to a cluster-scoped `MCPGPlugin`. Operator
+         * validates the plugin exists + is in `Ready` status before
+         * allowing the set to converge.
+         */
+        export interface MCPGPluginSetSpecEntriesPluginRefPatch {
+            name: string;
+        }
+
+        export interface MCPGPluginSetSpecPatch {
+            /**
+             * Per-plugin capability grants. Keyed by plugin id; values
+             * are subsets of the plugin descriptor's
+             * `required_capabilities`. The operator's admission
+             * webhook validates the subset relationship.
+             */
+            capabilityGrants: {[key: string]: string[]};
+            /**
+             * One entry per plugin the set installs. Order is
+             * preserved in the rendered gateway config (some plugin
+             * chains are order-sensitive — e.g. identity → policy).
+             */
+            entries: outputs.mcpg.v1alpha1.MCPGPluginSetSpecEntriesPatch[];
+        }
+
+        /**
+         * Observed state for `MCPGPluginSet`. `resolved_entries` ==
+         * `total_entries` is the canonical Ready signal; partial
+         * failures land in `failed_entries` so operators can read
+         * the per-entry reason without grepping logs.
+         */
+        export interface MCPGPluginSetStatus {
+            conditions: outputs.mcpg.v1alpha1.MCPGPluginSetStatusConditions[];
+            /**
+             * Per-entry resolution errors (referenced plugin missing,
+             * revoked, capability grant out of bounds, etc.). Empty
+             * when the set is `Ready`.
+             */
+            failedEntries: outputs.mcpg.v1alpha1.MCPGPluginSetStatusFailedEntries[];
+            lastReconcileTime: string;
+            observedGeneration: number;
+            /**
+             * Number of entries the operator successfully resolved
+             * (referenced `MCPGPlugin` exists + Ready + not revoked).
+             */
+            resolvedEntries: number;
+            /**
+             * SHA-256 of the rendered config (entries + per-entry
+             * configs + grants). Lets dependent gateways detect
+             * "plugin set changed → roll pods" without diffing the
+             * full spec.
+             */
+            resolvedHash: string;
+            /**
+             * Total entries in spec — `resolved_entries` should equal
+             * this when the set is `Ready`.
+             */
+            totalEntries: number;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGPluginSetStatusConditions {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGPluginSetStatusConditionsPatch {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * One per-entry resolution failure surfaced into status.
+         * `reason` is a stable enum so consumers can branch on it;
+         * `message` is free-text human detail.
+         */
+        export interface MCPGPluginSetStatusFailedEntries {
+            /**
+             * Plugin id the failure pertains to.
+             */
+            id: string;
+            /**
+             * Free-text human-readable detail.
+             */
+            message: string;
+            /**
+             * Camel-case enum reason: `PluginNotFound`,
+             * `PluginNotReady`, `PluginRevoked`, `PluginIdMismatch`,
+             * `ArtefactSecretMissing`. (Capability-grant violations are
+             * rejected at admission, not surfaced here.)
+             */
+            reason: string;
+        }
+
+        /**
+         * One per-entry resolution failure surfaced into status.
+         * `reason` is a stable enum so consumers can branch on it;
+         * `message` is free-text human detail.
+         */
+        export interface MCPGPluginSetStatusFailedEntriesPatch {
+            /**
+             * Plugin id the failure pertains to.
+             */
+            id: string;
+            /**
+             * Free-text human-readable detail.
+             */
+            message: string;
+            /**
+             * Camel-case enum reason: `PluginNotFound`,
+             * `PluginNotReady`, `PluginRevoked`, `PluginIdMismatch`,
+             * `ArtefactSecretMissing`. (Capability-grant violations are
+             * rejected at admission, not surfaced here.)
+             */
+            reason: string;
+        }
+
+        /**
+         * Observed state for `MCPGPluginSet`. `resolved_entries` ==
+         * `total_entries` is the canonical Ready signal; partial
+         * failures land in `failed_entries` so operators can read
+         * the per-entry reason without grepping logs.
+         */
+        export interface MCPGPluginSetStatusPatch {
+            conditions: outputs.mcpg.v1alpha1.MCPGPluginSetStatusConditionsPatch[];
+            /**
+             * Per-entry resolution errors (referenced plugin missing,
+             * revoked, capability grant out of bounds, etc.). Empty
+             * when the set is `Ready`.
+             */
+            failedEntries: outputs.mcpg.v1alpha1.MCPGPluginSetStatusFailedEntriesPatch[];
+            lastReconcileTime: string;
+            observedGeneration: number;
+            /**
+             * Number of entries the operator successfully resolved
+             * (referenced `MCPGPlugin` exists + Ready + not revoked).
+             */
+            resolvedEntries: number;
+            /**
+             * SHA-256 of the rendered config (entries + per-entry
+             * configs + grants). Lets dependent gateways detect
+             * "plugin set changed → roll pods" without diffing the
+             * full spec.
+             */
+            resolvedHash: string;
+            /**
+             * Total entries in spec — `resolved_entries` should equal
+             * this when the set is `Ready`.
+             */
+            totalEntries: number;
+        }
+
+        /**
+         * Single OCI-published, signed plugin artefact + the trust
+         * policy under which the operator verifies it.
+         */
+        export interface MCPGPluginSpec {
+            oci: outputs.mcpg.v1alpha1.MCPGPluginSpecOci;
+            /**
+             * Plugin class — advisory routing hint. The operator
+             * re-checks this against the descriptor.
+             * Values follow `mcpg_plugin_protocol::PluginClass`.
+             * Examples: `identity_provider`, `policy_engine`,
+             * `credential_issuer`, `audit_sink`, `cluster_backend`,
+             * `binding`, `transport`.
+             */
+            pluginClass: string;
+            /**
+             * Plugin id matching the descriptor's id (e.g.
+             * `dev.mcpg.identity.workload`). Must equal the descriptor
+             * embedded in the OCI artefact; the operator verifies on
+             * pull.
+             */
+            pluginId: string;
+            trust: outputs.mcpg.v1alpha1.MCPGPluginSpecTrust;
+            /**
+             * Plugin version. Should match the OCI tag's semver
+             * component when the operator can extract it; admission
+             * rejects mismatches.
+             */
+            version: string;
+        }
+
+        /**
+         * OCI artefact reference + optional in-cluster mirror.
+         */
+        export interface MCPGPluginSpecOci {
+            /**
+             * Full OCI ref, e.g.
+             * `ghcr.io/mcpg-dev/source-code/plugins/identity-workload:1.2.3-linux-amd64`
+             * (tag) or `...@sha256:abcd...` (digest pin — recommended
+             * for production).
+             */
+            image: string;
+            mirrorRef: outputs.mcpg.v1alpha1.MCPGPluginSpecOciMirrorRef;
+            pullSecretRef: outputs.mcpg.v1alpha1.MCPGPluginSpecOciPullSecretRef;
+        }
+
+        /**
+         * Pull through an in-cluster mirror (a future
+         * `MCPGPluginMirror` resource). When set, the operator
+         * translates the upstream `image` URL through the mirror's
+         * pathPrefix.
+         */
+        export interface MCPGPluginSpecOciMirrorRef {
+            name: string;
+        }
+
+        /**
+         * Pull through an in-cluster mirror (a future
+         * `MCPGPluginMirror` resource). When set, the operator
+         * translates the upstream `image` URL through the mirror's
+         * pathPrefix.
+         */
+        export interface MCPGPluginSpecOciMirrorRefPatch {
+            name: string;
+        }
+
+        /**
+         * OCI artefact reference + optional in-cluster mirror.
+         */
+        export interface MCPGPluginSpecOciPatch {
+            /**
+             * Full OCI ref, e.g.
+             * `ghcr.io/mcpg-dev/source-code/plugins/identity-workload:1.2.3-linux-amd64`
+             * (tag) or `...@sha256:abcd...` (digest pin — recommended
+             * for production).
+             */
+            image: string;
+            mirrorRef: outputs.mcpg.v1alpha1.MCPGPluginSpecOciMirrorRefPatch;
+            pullSecretRef: outputs.mcpg.v1alpha1.MCPGPluginSpecOciPullSecretRefPatch;
+        }
+
+        /**
+         * Optional pull-secret reference (in the operator's
+         * namespace).
+         */
+        export interface MCPGPluginSpecOciPullSecretRef {
+            name: string;
+        }
+
+        /**
+         * Optional pull-secret reference (in the operator's
+         * namespace).
+         */
+        export interface MCPGPluginSpecOciPullSecretRefPatch {
+            name: string;
+        }
+
+        /**
+         * Single OCI-published, signed plugin artefact + the trust
+         * policy under which the operator verifies it.
+         */
+        export interface MCPGPluginSpecPatch {
+            oci: outputs.mcpg.v1alpha1.MCPGPluginSpecOciPatch;
+            /**
+             * Plugin class — advisory routing hint. The operator
+             * re-checks this against the descriptor.
+             * Values follow `mcpg_plugin_protocol::PluginClass`.
+             * Examples: `identity_provider`, `policy_engine`,
+             * `credential_issuer`, `audit_sink`, `cluster_backend`,
+             * `binding`, `transport`.
+             */
+            pluginClass: string;
+            /**
+             * Plugin id matching the descriptor's id (e.g.
+             * `dev.mcpg.identity.workload`). Must equal the descriptor
+             * embedded in the OCI artefact; the operator verifies on
+             * pull.
+             */
+            pluginId: string;
+            trust: outputs.mcpg.v1alpha1.MCPGPluginSpecTrustPatch;
+            /**
+             * Plugin version. Should match the OCI tag's semver
+             * component when the operator can extract it; admission
+             * rejects mismatches.
+             */
+            version: string;
+        }
+
+        /**
+         * Trust policy: signing key, cosign identity, SLSA
+         * provenance source. The operator must be able to verify
+         * every layer before mounting the plugin into a gateway pod.
+         */
+        export interface MCPGPluginSpecTrust {
+            cosignIdentity: outputs.mcpg.v1alpha1.MCPGPluginSpecTrustCosignIdentity;
+            signingKeyRef: outputs.mcpg.v1alpha1.MCPGPluginSpecTrustSigningKeyRef;
+            slsaProvenance: outputs.mcpg.v1alpha1.MCPGPluginSpecTrustSlsaProvenance;
+        }
+
+        /**
+         * Cosign keyless identity. Operator verifies the OCI
+         * manifest's sigstore signature against this identity.
+         * Optional in v1alpha1 — operators with cosign trust
+         * configured here run an extra verification layer.
+         */
+        export interface MCPGPluginSpecTrustCosignIdentity {
+            /**
+             * Regex matching the OIDC subject baked into the cosign
+             * certificate. Example:
+             * `^https://github\.com/mcpg-dev/source-code/`.
+             */
+            certificateIdentityRegexp: string;
+            /**
+             * OIDC issuer the cosign cert chains back to.
+             * Example: `https://token.actions.githubusercontent.com`.
+             */
+            oidcIssuer: string;
+        }
+
+        /**
+         * Cosign keyless identity. Operator verifies the OCI
+         * manifest's sigstore signature against this identity.
+         * Optional in v1alpha1 — operators with cosign trust
+         * configured here run an extra verification layer.
+         */
+        export interface MCPGPluginSpecTrustCosignIdentityPatch {
+            /**
+             * Regex matching the OIDC subject baked into the cosign
+             * certificate. Example:
+             * `^https://github\.com/mcpg-dev/source-code/`.
+             */
+            certificateIdentityRegexp: string;
+            /**
+             * OIDC issuer the cosign cert chains back to.
+             * Example: `https://token.actions.githubusercontent.com`.
+             */
+            oidcIssuer: string;
+        }
+
+        /**
+         * Trust policy: signing key, cosign identity, SLSA
+         * provenance source. The operator must be able to verify
+         * every layer before mounting the plugin into a gateway pod.
+         */
+        export interface MCPGPluginSpecTrustPatch {
+            cosignIdentity: outputs.mcpg.v1alpha1.MCPGPluginSpecTrustCosignIdentityPatch;
+            signingKeyRef: outputs.mcpg.v1alpha1.MCPGPluginSpecTrustSigningKeyRefPatch;
+            slsaProvenance: outputs.mcpg.v1alpha1.MCPGPluginSpecTrustSlsaProvenancePatch;
+        }
+
+        /**
+         * Ed25519 public key the operator verifies the cdylib's
+         * `mcpg-plugin sign` signature against. Mandatory in v1alpha1;
+         * signature verification is the baseline trust gate that
+         * every plugin must pass.
+         */
+        export interface MCPGPluginSpecTrustSigningKeyRef {
+            /**
+             * Secret key holding the Ed25519 public key bytes (raw
+             * 32 bytes, base64-decoded by the operator at load time).
+             * Default: `release.pub`.
+             */
+            key: string;
+            /**
+             * Secret name in the operator's namespace.
+             */
+            secretName: string;
+        }
+
+        /**
+         * Ed25519 public key the operator verifies the cdylib's
+         * `mcpg-plugin sign` signature against. Mandatory in v1alpha1;
+         * signature verification is the baseline trust gate that
+         * every plugin must pass.
+         */
+        export interface MCPGPluginSpecTrustSigningKeyRefPatch {
+            /**
+             * Secret key holding the Ed25519 public key bytes (raw
+             * 32 bytes, base64-decoded by the operator at load time).
+             * Default: `release.pub`.
+             */
+            key: string;
+            /**
+             * Secret name in the operator's namespace.
+             */
+            secretName: string;
+        }
+
+        /**
+         * SLSA L3 provenance verification. Optional in v1alpha1 —
+         * operators with SLSA-enforced supply chains gate on it.
+         */
+        export interface MCPGPluginSpecTrustSlsaProvenance {
+            /**
+             * Name of a ConfigMap (in the operator's namespace) holding
+             * the `*.intoto.jsonl` provenance file under
+             * `data.provenance.intoto.jsonl`.
+             */
+            configMapName: string;
+            /**
+             * Source tag the provenance must record. Example: `v1.2.3`.
+             */
+            sourceTag: string;
+            /**
+             * Source URI the provenance must be pinned to. Example:
+             * `github.com/mcpg-dev/source-code`.
+             */
+            sourceUri: string;
+        }
+
+        /**
+         * SLSA L3 provenance verification. Optional in v1alpha1 —
+         * operators with SLSA-enforced supply chains gate on it.
+         */
+        export interface MCPGPluginSpecTrustSlsaProvenancePatch {
+            /**
+             * Name of a ConfigMap (in the operator's namespace) holding
+             * the `*.intoto.jsonl` provenance file under
+             * `data.provenance.intoto.jsonl`.
+             */
+            configMapName: string;
+            /**
+             * Source tag the provenance must record. Example: `v1.2.3`.
+             */
+            sourceTag: string;
+            /**
+             * Source URI the provenance must be pinned to. Example:
+             * `github.com/mcpg-dev/source-code`.
+             */
+            sourceUri: string;
+        }
+
+        /**
+         * Observed state for a `MCPGPlugin`. Boolean fields are
+         * reported as `Option<bool>` so absent ⇒ "not yet evaluated"
+         * vs. `Some(false)` ⇒ "evaluated, refused". Operators reading
+         * status should treat absence as "not Ready" rather than
+         * defaulting to `false`.
+         */
+        export interface MCPGPluginStatus {
+            /**
+             * Name of the operator-managed Secret holding the verified
+             * bytes (in the operator's namespace).
+             */
+            artefactSecretName: string;
+            conditions: outputs.mcpg.v1alpha1.MCPGPluginStatusConditions[];
+            cosignVerified: boolean;
+            lastReconcileTime: string;
+            observedGeneration: number;
+            pulledAt: string;
+            /**
+             * SHA-256 of the verified cdylib bytes (lower-case hex).
+             * Operators check this against the cluster
+             * `MCPGRevocationList`; revoked entries flip
+             * `revoked_by_sha = true`.
+             */
+            resolvedDigest: string;
+            /**
+             * True when [`Self::resolved_digest`] matches an entry in
+             * the cluster `MCPGRevocationList`. The operator refuses
+             * to materialise the plugin into any
+             * `MCPGPluginSet` while this is true.
+             */
+            revokedBySha: boolean;
+            signatureValid: boolean;
+            slsaVerified: boolean;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGPluginStatusConditions {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGPluginStatusConditionsPatch {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * Observed state for a `MCPGPlugin`. Boolean fields are
+         * reported as `Option<bool>` so absent ⇒ "not yet evaluated"
+         * vs. `Some(false)` ⇒ "evaluated, refused". Operators reading
+         * status should treat absence as "not Ready" rather than
+         * defaulting to `false`.
+         */
+        export interface MCPGPluginStatusPatch {
+            /**
+             * Name of the operator-managed Secret holding the verified
+             * bytes (in the operator's namespace).
+             */
+            artefactSecretName: string;
+            conditions: outputs.mcpg.v1alpha1.MCPGPluginStatusConditionsPatch[];
+            cosignVerified: boolean;
+            lastReconcileTime: string;
+            observedGeneration: number;
+            pulledAt: string;
+            /**
+             * SHA-256 of the verified cdylib bytes (lower-case hex).
+             * Operators check this against the cluster
+             * `MCPGRevocationList`; revoked entries flip
+             * `revoked_by_sha = true`.
+             */
+            resolvedDigest: string;
+            /**
+             * True when [`Self::resolved_digest`] matches an entry in
+             * the cluster `MCPGRevocationList`. The operator refuses
+             * to materialise the plugin into any
+             * `MCPGPluginSet` while this is true.
+             */
+            revokedBySha: boolean;
+            signatureValid: boolean;
+            slsaVerified: boolean;
+        }
+
+        /**
+         * Auto-generated derived type for MCPGRevocationListSpec via `CustomResource`
+         */
+        export interface MCPGRevocationList {
+            /**
+             * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+             */
+            apiVersion: "mcpg.dev/v1alpha1";
+            /**
+             * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+             */
+            kind: "MCPGRevocationList";
+            /**
+             * Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+             */
+            metadata: outputs.meta.v1.ObjectMeta;
+            spec: outputs.mcpg.v1alpha1.MCPGRevocationListSpec;
+            status: outputs.mcpg.v1alpha1.MCPGRevocationListStatus;
+        }
+
+        /**
+         * Cluster-wide list of revoked plugin SHA-256 hashes. Materialised
+         * into per-namespace `mcpg-revocation-list` ConfigMaps that
+         * gateway pods mount under the path declared in
+         * `plugins.trust.revocation_list_path`.
+         * Cluster-scoped revocation list. The operator fans this out
+         * into every namespace running a gateway as a per-namespace
+         * `<gateway>-revocations` ConfigMap, mounted read-only into
+         * the gateway pod at `/etc/mcpg/revocations/`. Gateway pods
+         * enforce at plugin-load time — a list update plus a pod roll
+         * is the full revocation cycle.
+         */
+        export interface MCPGRevocationListSpec {
+            /**
+             * RFC3339 audit-only timestamp. The operator does not gate
+             * freshness on this — it's surfaced in operator logs +
+             * status for incident-response correlation.
+             */
+            issuedAt: string;
+            /**
+             * One entry per revoked plugin artefact. Operators consolidate
+             * into a single entry per SHA-256 hash; duplicates are
+             * rejected at admission.
+             */
+            revocations: outputs.mcpg.v1alpha1.MCPGRevocationListSpecRevocations[];
+            /**
+             * Format version. Currently `1`. Unknown versions cause the
+             * admission webhook to reject the resource.
+             */
+            version: number;
+        }
+
+        /**
+         * Cluster-wide list of revoked plugin SHA-256 hashes. Materialised
+         * into per-namespace `mcpg-revocation-list` ConfigMaps that
+         * gateway pods mount under the path declared in
+         * `plugins.trust.revocation_list_path`.
+         * Cluster-scoped revocation list. The operator fans this out
+         * into every namespace running a gateway as a per-namespace
+         * `<gateway>-revocations` ConfigMap, mounted read-only into
+         * the gateway pod at `/etc/mcpg/revocations/`. Gateway pods
+         * enforce at plugin-load time — a list update plus a pod roll
+         * is the full revocation cycle.
+         */
+        export interface MCPGRevocationListSpecPatch {
+            /**
+             * RFC3339 audit-only timestamp. The operator does not gate
+             * freshness on this — it's surfaced in operator logs +
+             * status for incident-response correlation.
+             */
+            issuedAt: string;
+            /**
+             * One entry per revoked plugin artefact. Operators consolidate
+             * into a single entry per SHA-256 hash; duplicates are
+             * rejected at admission.
+             */
+            revocations: outputs.mcpg.v1alpha1.MCPGRevocationListSpecRevocationsPatch[];
+            /**
+             * Format version. Currently `1`. Unknown versions cause the
+             * admission webhook to reject the resource.
+             */
+            version: number;
+        }
+
+        /**
+         * One revoked artefact. The hash MUST be the SHA-256 of the
+         * verified cdylib bytes (post-cosign-extract), not the OCI
+         * manifest digest — operators want to revoke a specific
+         * compiled artefact, even if it's been published under multiple
+         * tags or registries.
+         */
+        export interface MCPGRevocationListSpecRevocations {
+            /**
+             * Lower-case hex, exactly 64 chars. Operators SHOULD ship
+             * lowercase to match `mcpg-plugin hash` output. The
+             * admission webhook normalises uppercase to lowercase.
+             */
+            artifactSha256: string;
+            /**
+             * Free-form reason. Surfaced in the gateway's load-time
+             * error message + audit event. Empty / whitespace-only
+             * reasons are rejected at admission.
+             */
+            reason: string;
+            /**
+             * RFC3339 timestamp the entry was issued. Audit-only.
+             */
+            revokedAt: string;
+        }
+
+        /**
+         * One revoked artefact. The hash MUST be the SHA-256 of the
+         * verified cdylib bytes (post-cosign-extract), not the OCI
+         * manifest digest — operators want to revoke a specific
+         * compiled artefact, even if it's been published under multiple
+         * tags or registries.
+         */
+        export interface MCPGRevocationListSpecRevocationsPatch {
+            /**
+             * Lower-case hex, exactly 64 chars. Operators SHOULD ship
+             * lowercase to match `mcpg-plugin hash` output. The
+             * admission webhook normalises uppercase to lowercase.
+             */
+            artifactSha256: string;
+            /**
+             * Free-form reason. Surfaced in the gateway's load-time
+             * error message + audit event. Empty / whitespace-only
+             * reasons are rejected at admission.
+             */
+            reason: string;
+            /**
+             * RFC3339 timestamp the entry was issued. Audit-only.
+             */
+            revokedAt: string;
+        }
+
+        /**
+         * Observed state for `MCPGRevocationList`. `materialised_namespaces`
+         * counts the per-namespace ConfigMaps the operator has fanned
+         * the list out into; `content_hash` lets ops detect rollout drift
+         * across consumer namespaces.
+         */
+        export interface MCPGRevocationListStatus {
+            /**
+             * Standard `metav1.Condition[]`.
+             */
+            conditions: outputs.mcpg.v1alpha1.MCPGRevocationListStatusConditions[];
+            /**
+             * SHA-256 fingerprint of the rendered ConfigMap content
+             * (`revocations.json` key). Lets ops verify rollout status
+             * without reading every namespace.
+             */
+            contentHash: string;
+            lastReconcileTime: string;
+            /**
+             * Count of namespaces that have a materialised
+             * `mcpg-revocation-list` ConfigMap mirroring this resource.
+             */
+            materialisedNamespaces: number;
+            observedGeneration: number;
+            /**
+             * Number of entries the operator last observed in spec.
+             */
+            observedRevocations: number;
+            /**
+             * Plugin names (cluster-scoped `MCPGPlugin` resources) the
+             * operator has flagged as `revokedBySha = true` due to
+             * matches against this list.
+             */
+            pluginsBlocked: string[];
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGRevocationListStatusConditions {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGRevocationListStatusConditionsPatch {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * Observed state for `MCPGRevocationList`. `materialised_namespaces`
+         * counts the per-namespace ConfigMaps the operator has fanned
+         * the list out into; `content_hash` lets ops detect rollout drift
+         * across consumer namespaces.
+         */
+        export interface MCPGRevocationListStatusPatch {
+            /**
+             * Standard `metav1.Condition[]`.
+             */
+            conditions: outputs.mcpg.v1alpha1.MCPGRevocationListStatusConditionsPatch[];
+            /**
+             * SHA-256 fingerprint of the rendered ConfigMap content
+             * (`revocations.json` key). Lets ops verify rollout status
+             * without reading every namespace.
+             */
+            contentHash: string;
+            lastReconcileTime: string;
+            /**
+             * Count of namespaces that have a materialised
+             * `mcpg-revocation-list` ConfigMap mirroring this resource.
+             */
+            materialisedNamespaces: number;
+            observedGeneration: number;
+            /**
+             * Number of entries the operator last observed in spec.
+             */
+            observedRevocations: number;
+            /**
+             * Plugin names (cluster-scoped `MCPGPlugin` resources) the
+             * operator has flagged as `revokedBySha = true` due to
+             * matches against this list.
+             */
+            pluginsBlocked: string[];
+        }
+
+        /**
+         * Auto-generated derived type for MCPGRouteSpec via `CustomResource`
+         */
+        export interface MCPGRoute {
+            /**
+             * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+             */
+            apiVersion: "mcpg.dev/v1alpha1";
+            /**
+             * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+             */
+            kind: "MCPGRoute";
+            /**
+             * Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+             */
+            metadata: outputs.meta.v1.ObjectMeta;
+            spec: outputs.mcpg.v1alpha1.MCPGRouteSpec;
+            status: outputs.mcpg.v1alpha1.MCPGRouteStatus;
+        }
+
+        /**
+         * Per-tenant route into a shared gateway.
+         * Namespace-scoped route binding a tenant's tools to a shared
+         * gateway, with the identity / policy / audit chains and per-tenant
+         * attributes that govern them.
+         */
+        export interface MCPGRouteSpec {
+            /**
+             * Per-tenant metadata. `attributes.tenant` is special: it's the
+             * identity attribute the rendered tool-access CEL rules key on
+             * (`$identity.attributes.tenant == "<value>"`), so the shared
+             * gateway only exposes this route's tools to that tenant's
+             * callers. All attributes are also available to audit sinks for
+             * per-tenant labelling.
+             */
+            attributes: {[key: string]: string};
+            /**
+             * Ordered audit-sink plugin ids for this route. Same validation +
+             * enforcement caveat as `identityChain`. (The shared gateway's
+             * audit sink may template `attributes` into its output — e.g. a
+             * per-tenant Kafka topic — which IS enforceable today.)
+             */
+            auditChain: string[];
+            gatewayRef: outputs.mcpg.v1alpha1.MCPGRouteSpecGatewayRef;
+            /**
+             * Ordered identity-plugin ids that should authenticate requests on
+             * this route. **Validated** against the gateway's plugin set;
+             * per-route dispatch is not yet enforced by the gateway runtime
+             * (see the module docs + the `ChainsEnforced` status condition).
+             */
+            identityChain: string[];
+            match: outputs.mcpg.v1alpha1.MCPGRouteSpecMatch;
+            /**
+             * Ordered policy-engine plugin ids for this route. Same
+             * validation + enforcement caveat as `identityChain`.
+             */
+            policyChain: string[];
+        }
+
+        /**
+         * The gateway this route attaches to. For soft tenancy this is a
+         * cross-namespace reference to the platform team's shared gateway;
+         * the gateway must list this route's namespace in
+         * `spec.acceptedRouteNamespaces`.
+         */
+        export interface MCPGRouteSpecGatewayRef {
+            /**
+             * `MCPGGateway` resource name.
+             */
+            name: string;
+            /**
+             * Gateway namespace. Defaults to the route's own namespace when
+             * unset; soft tenancy sets this to the shared-gateway namespace.
+             */
+            namespace: string;
+        }
+
+        /**
+         * The gateway this route attaches to. For soft tenancy this is a
+         * cross-namespace reference to the platform team's shared gateway;
+         * the gateway must list this route's namespace in
+         * `spec.acceptedRouteNamespaces`.
+         */
+        export interface MCPGRouteSpecGatewayRefPatch {
+            /**
+             * `MCPGGateway` resource name.
+             */
+            name: string;
+            /**
+             * Gateway namespace. Defaults to the route's own namespace when
+             * unset; soft tenancy sets this to the shared-gateway namespace.
+             */
+            namespace: string;
+        }
+
+        /**
+         * Which tools this route exposes through the gateway. Each matched
+         * tool gets a tenant-scoped access rule rendered into the
+         * gateway's `governance.policy.tool_access.rules[]`.
+         */
+        export interface MCPGRouteSpecMatch {
+            /**
+             * Tools this route exposes. Each must correspond to a binding the
+             * gateway actually serves (validated at admission).
+             */
+            tools: outputs.mcpg.v1alpha1.MCPGRouteSpecMatchTools[];
+        }
+
+        /**
+         * Which tools this route exposes through the gateway. Each matched
+         * tool gets a tenant-scoped access rule rendered into the
+         * gateway's `governance.policy.tool_access.rules[]`.
+         */
+        export interface MCPGRouteSpecMatchPatch {
+            /**
+             * Tools this route exposes. Each must correspond to a binding the
+             * gateway actually serves (validated at admission).
+             */
+            tools: outputs.mcpg.v1alpha1.MCPGRouteSpecMatchToolsPatch[];
+        }
+
+        /**
+         * A single tool a route exposes.
+         */
+        export interface MCPGRouteSpecMatchTools {
+            /**
+             * Tool capability id (e.g. `orders.list`).
+             */
+            id: string;
+        }
+
+        /**
+         * A single tool a route exposes.
+         */
+        export interface MCPGRouteSpecMatchToolsPatch {
+            /**
+             * Tool capability id (e.g. `orders.list`).
+             */
+            id: string;
+        }
+
+        /**
+         * Per-tenant route into a shared gateway.
+         * Namespace-scoped route binding a tenant's tools to a shared
+         * gateway, with the identity / policy / audit chains and per-tenant
+         * attributes that govern them.
+         */
+        export interface MCPGRouteSpecPatch {
+            /**
+             * Per-tenant metadata. `attributes.tenant` is special: it's the
+             * identity attribute the rendered tool-access CEL rules key on
+             * (`$identity.attributes.tenant == "<value>"`), so the shared
+             * gateway only exposes this route's tools to that tenant's
+             * callers. All attributes are also available to audit sinks for
+             * per-tenant labelling.
+             */
+            attributes: {[key: string]: string};
+            /**
+             * Ordered audit-sink plugin ids for this route. Same validation +
+             * enforcement caveat as `identityChain`. (The shared gateway's
+             * audit sink may template `attributes` into its output — e.g. a
+             * per-tenant Kafka topic — which IS enforceable today.)
+             */
+            auditChain: string[];
+            gatewayRef: outputs.mcpg.v1alpha1.MCPGRouteSpecGatewayRefPatch;
+            /**
+             * Ordered identity-plugin ids that should authenticate requests on
+             * this route. **Validated** against the gateway's plugin set;
+             * per-route dispatch is not yet enforced by the gateway runtime
+             * (see the module docs + the `ChainsEnforced` status condition).
+             */
+            identityChain: string[];
+            match: outputs.mcpg.v1alpha1.MCPGRouteSpecMatchPatch;
+            /**
+             * Ordered policy-engine plugin ids for this route. Same
+             * validation + enforcement caveat as `identityChain`.
+             */
+            policyChain: string[];
+        }
+
+        /**
+         * Observed state for `MCPGRoute`.
+         */
+        export interface MCPGRouteStatus {
+            /**
+             * The resolved `<namespace>/<name>` of the bound gateway. Lets ops
+             * see the cross-namespace binding without parsing the ref.
+             */
+            boundGateway: string;
+            /**
+             * Standard `metav1.Condition[]`. Notable types:
+             * - `Ready` — route accepted + tool-access rules rendered.
+             * - `GatewayBound` — the referenced gateway exists and accepts
+             *   this route's namespace.
+             * - `ChainsEnforced` — `True` only if the gateway runtime applies
+             *   the route's identity/policy/audit chains per-route. Today this
+             *   is `False` (reason `PerRouteDispatchUnsupported`): the chains
+             *   are validated but not dispatched per-route. The tool-access
+             *   scoping in `Ready` still applies.
+             */
+            conditions: outputs.mcpg.v1alpha1.MCPGRouteStatusConditions[];
+            lastReconcileTime: string;
+            /**
+             * Number of `match.tools` entries the operator rendered into the
+             * gateway's tool-access policy.
+             */
+            matchedTools: number;
+            observedGeneration: number;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGRouteStatusConditions {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGRouteStatusConditionsPatch {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * Observed state for `MCPGRoute`.
+         */
+        export interface MCPGRouteStatusPatch {
+            /**
+             * The resolved `<namespace>/<name>` of the bound gateway. Lets ops
+             * see the cross-namespace binding without parsing the ref.
+             */
+            boundGateway: string;
+            /**
+             * Standard `metav1.Condition[]`. Notable types:
+             * - `Ready` — route accepted + tool-access rules rendered.
+             * - `GatewayBound` — the referenced gateway exists and accepts
+             *   this route's namespace.
+             * - `ChainsEnforced` — `True` only if the gateway runtime applies
+             *   the route's identity/policy/audit chains per-route. Today this
+             *   is `False` (reason `PerRouteDispatchUnsupported`): the chains
+             *   are validated but not dispatched per-route. The tool-access
+             *   scoping in `Ready` still applies.
+             */
+            conditions: outputs.mcpg.v1alpha1.MCPGRouteStatusConditionsPatch[];
+            lastReconcileTime: string;
+            /**
+             * Number of `match.tools` entries the operator rendered into the
+             * gateway's tool-access policy.
+             */
+            matchedTools: number;
+            observedGeneration: number;
+        }
+
+        /**
+         * Auto-generated derived type for MCPGTenantSpec via `CustomResource`
+         */
+        export interface MCPGTenant {
+            /**
+             * APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
+             */
+            apiVersion: "mcpg.dev/v1alpha1";
+            /**
+             * Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+             */
+            kind: "MCPGTenant";
+            /**
+             * Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+             */
+            metadata: outputs.meta.v1.ObjectMeta;
+            spec: outputs.mcpg.v1alpha1.MCPGTenantSpec;
+            status: outputs.mcpg.v1alpha1.MCPGTenantStatus;
+        }
+
+        /**
+         * Declarative, cluster-admin-owned tenant boundary.
+         * Cluster-scoped tenant boundary referencing existing namespaces.
+         */
+        export interface MCPGTenantSpec {
+            /**
+             * Plugin allowlist. `MCPGPluginSet`s in this tenant's namespaces
+             * may only reference cluster `MCPGPlugin`s matching one of these.
+             *
+             * - Empty list = **deny-all** (a tenant must explicitly opt in).
+             * - A single entry `{name: "*"}` = any cluster plugin.
+             *
+             * Each entry matches when EITHER its `name` equals the plugin's
+             * resource name / capability id, OR the plugin's OCI `image`
+             * starts with `registryPrefix`.
+             */
+            allowedPlugins: outputs.mcpg.v1alpha1.MCPGTenantSpecAllowedPlugins[];
+            identityAttribute: outputs.mcpg.v1alpha1.MCPGTenantSpecIdentityAttribute;
+            /**
+             * Namespaces this tenant owns. Per-namespace RBAC, the generated
+             * `ResourceQuota`, the plugin allowlist, and the replica cap apply
+             * to exactly these. Namespaces are EXCLUSIVELY owned — a namespace
+             * may belong to at most one `MCPGTenant` (admission rejects
+             * overlap). The operator does **not** create these namespaces; it
+             * references existing ones.
+             */
+            namespaces: string[];
+            quotas: outputs.mcpg.v1alpha1.MCPGTenantSpecQuotas;
+        }
+
+        /**
+         * One plugin-allowlist matcher. At least one of `name` /
+         * `registryPrefix` should be set; an entry with neither matches
+         * nothing (and is rejected at admission).
+         */
+        export interface MCPGTenantSpecAllowedPlugins {
+            /**
+             * Match by the `MCPGPlugin` resource name or the plugin
+             * capability id (e.g. `identity-workload` or
+             * `dev.mcpg.identity.workload`). The literal `*` matches any
+             * plugin.
+             */
+            name: string;
+            /**
+             * Match when the referenced plugin's OCI `image` starts with this
+             * prefix (e.g. `ghcr.io/mcpg-dev/source-code/plugins/`).
+             */
+            registryPrefix: string;
+        }
+
+        /**
+         * One plugin-allowlist matcher. At least one of `name` /
+         * `registryPrefix` should be set; an entry with neither matches
+         * nothing (and is rejected at admission).
+         */
+        export interface MCPGTenantSpecAllowedPluginsPatch {
+            /**
+             * Match by the `MCPGPlugin` resource name or the plugin
+             * capability id (e.g. `identity-workload` or
+             * `dev.mcpg.identity.workload`). The literal `*` matches any
+             * plugin.
+             */
+            name: string;
+            /**
+             * Match when the referenced plugin's OCI `image` starts with this
+             * prefix (e.g. `ghcr.io/mcpg-dev/source-code/plugins/`).
+             */
+            registryPrefix: string;
+        }
+
+        /**
+         * Optional. The identity attribute the operator stamps into the
+         * gateway's runtime `tool_access` policy so a tenant's gateways and
+         * routes share one identity boundary. When unset, `MCPGTenant`
+         * performs no gateway-config rendering at all (pure RBAC + admission
+         * object).
+         */
+        export interface MCPGTenantSpecIdentityAttribute {
+            /**
+             * Attribute key. Conventionally `tenant`.
+             */
+            key: string;
+            /**
+             * Attribute value identifying this tenant (e.g. the tenant name).
+             */
+            value: string;
+        }
+
+        /**
+         * Optional. The identity attribute the operator stamps into the
+         * gateway's runtime `tool_access` policy so a tenant's gateways and
+         * routes share one identity boundary. When unset, `MCPGTenant`
+         * performs no gateway-config rendering at all (pure RBAC + admission
+         * object).
+         */
+        export interface MCPGTenantSpecIdentityAttributePatch {
+            /**
+             * Attribute key. Conventionally `tenant`.
+             */
+            key: string;
+            /**
+             * Attribute value identifying this tenant (e.g. the tenant name).
+             */
+            value: string;
+        }
+
+        /**
+         * Declarative, cluster-admin-owned tenant boundary.
+         * Cluster-scoped tenant boundary referencing existing namespaces.
+         */
+        export interface MCPGTenantSpecPatch {
+            /**
+             * Plugin allowlist. `MCPGPluginSet`s in this tenant's namespaces
+             * may only reference cluster `MCPGPlugin`s matching one of these.
+             *
+             * - Empty list = **deny-all** (a tenant must explicitly opt in).
+             * - A single entry `{name: "*"}` = any cluster plugin.
+             *
+             * Each entry matches when EITHER its `name` equals the plugin's
+             * resource name / capability id, OR the plugin's OCI `image`
+             * starts with `registryPrefix`.
+             */
+            allowedPlugins: outputs.mcpg.v1alpha1.MCPGTenantSpecAllowedPluginsPatch[];
+            identityAttribute: outputs.mcpg.v1alpha1.MCPGTenantSpecIdentityAttributePatch;
+            /**
+             * Namespaces this tenant owns. Per-namespace RBAC, the generated
+             * `ResourceQuota`, the plugin allowlist, and the replica cap apply
+             * to exactly these. Namespaces are EXCLUSIVELY owned — a namespace
+             * may belong to at most one `MCPGTenant` (admission rejects
+             * overlap). The operator does **not** create these namespaces; it
+             * references existing ones.
+             */
+            namespaces: string[];
+            quotas: outputs.mcpg.v1alpha1.MCPGTenantSpecQuotasPatch;
+        }
+
+        /**
+         * Hard quotas, enforced synchronously (replica cap at admission;
+         * counts via a generated per-namespace `ResourceQuota`). Unset =
+         * no quota.
+         */
+        export interface MCPGTenantSpecQuotas {
+            /**
+             * Max `MCPGGateway`s per owned namespace (count quota →
+             * `ResourceQuota`).
+             */
+            maxGateways: number;
+            /**
+             * Max `MCPGPluginSet`s per owned namespace.
+             */
+            maxPluginSets: number;
+            /**
+             * Per-gateway replica ceiling. A *field* constraint (not a count),
+             * so it has no admission race and is webhook-only.
+             */
+            maxReplicasPerGateway: number;
+            /**
+             * Max `MCPGRoute`s per owned namespace.
+             */
+            maxRoutes: number;
+        }
+
+        /**
+         * Hard quotas, enforced synchronously (replica cap at admission;
+         * counts via a generated per-namespace `ResourceQuota`). Unset =
+         * no quota.
+         */
+        export interface MCPGTenantSpecQuotasPatch {
+            /**
+             * Max `MCPGGateway`s per owned namespace (count quota →
+             * `ResourceQuota`).
+             */
+            maxGateways: number;
+            /**
+             * Max `MCPGPluginSet`s per owned namespace.
+             */
+            maxPluginSets: number;
+            /**
+             * Per-gateway replica ceiling. A *field* constraint (not a count),
+             * so it has no admission race and is webhook-only.
+             */
+            maxReplicasPerGateway: number;
+            /**
+             * Max `MCPGRoute`s per owned namespace.
+             */
+            maxRoutes: number;
+        }
+
+        /**
+         * Observed state for `MCPGTenant`.
+         */
+        export interface MCPGTenantStatus {
+            /**
+             * Namespaces the operator successfully bound (exist + labelled +
+             * RBAC/quota applied). A subset of `spec.namespaces` when some are
+             * missing.
+             */
+            boundNamespaces: string[];
+            /**
+             * Standard `metav1.Condition[]`. Notable types:
+             * - `Ready` — RBAC + `ResourceQuota` materialised for all bound
+             *   namespaces.
+             * - `NamespacesBound` — every `spec.namespaces` exists and is
+             *   labelled `mcpg.dev/tenant=<name>`.
+             * - `QuotaWithinLimits` — `False` (soft signal, not a gate) when an
+             *   owned namespace already holds more resources than the quota
+             *   allows; the generated `ResourceQuota` still admits the existing
+             *   objects and blocks only new ones.
+             */
+            conditions: outputs.mcpg.v1alpha1.MCPGTenantStatusConditions[];
+            lastReconcileTime: string;
+            observed: outputs.mcpg.v1alpha1.MCPGTenantStatusObserved;
+            observedGeneration: number;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGTenantStatusConditions {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * One status condition. Serde shape matches K8s
+         * `metav1.Condition` exactly so generic tooling (kubectl,
+         * kustomize, Argo CD) interprets it correctly.
+         */
+        export interface MCPGTenantStatusConditionsPatch {
+            /**
+             * RFC3339 timestamp of the most recent transition.
+             */
+            lastTransitionTime: string;
+            /**
+             * Free-text human-readable detail. May be empty.
+             */
+            message: string;
+            /**
+             * `metadata.generation` the controller had observed when
+             * it set this condition. Lets clients detect stale status.
+             */
+            observedGeneration: number;
+            /**
+             * CamelCase enum the operator defines per controller.
+             * E.g. `AllReplicasAvailable`, `DependencyPending`,
+             * `SignatureMismatch`.
+             */
+            reason: string;
+            /**
+             * `"True"`, `"False"`, or `"Unknown"`. K8s convention is to
+             * keep this as a string (not a bool) so `Unknown` is
+             * representable.
+             */
+            status: string;
+            /**
+             * `Ready`, `Reconciling`, `Available`, `Degraded`,
+             * `Progressing`, `Failed`, plus per-CRD types.
+             */
+            type: string;
+        }
+
+        /**
+         * Observed counts across owned namespaces. Observability only —
+         * **never** the enforcement point for quota (that's the generated
+         * `ResourceQuota`).
+         */
+        export interface MCPGTenantStatusObserved {
+            gateways: number;
+            pluginSets: number;
+            routes: number;
+        }
+
+        /**
+         * Observed counts across owned namespaces. Observability only —
+         * **never** the enforcement point for quota (that's the generated
+         * `ResourceQuota`).
+         */
+        export interface MCPGTenantStatusObservedPatch {
+            gateways: number;
+            pluginSets: number;
+            routes: number;
+        }
+
+        /**
+         * Observed state for `MCPGTenant`.
+         */
+        export interface MCPGTenantStatusPatch {
+            /**
+             * Namespaces the operator successfully bound (exist + labelled +
+             * RBAC/quota applied). A subset of `spec.namespaces` when some are
+             * missing.
+             */
+            boundNamespaces: string[];
+            /**
+             * Standard `metav1.Condition[]`. Notable types:
+             * - `Ready` — RBAC + `ResourceQuota` materialised for all bound
+             *   namespaces.
+             * - `NamespacesBound` — every `spec.namespaces` exists and is
+             *   labelled `mcpg.dev/tenant=<name>`.
+             * - `QuotaWithinLimits` — `False` (soft signal, not a gate) when an
+             *   owned namespace already holds more resources than the quota
+             *   allows; the generated `ResourceQuota` still admits the existing
+             *   objects and blocks only new ones.
+             */
+            conditions: outputs.mcpg.v1alpha1.MCPGTenantStatusConditionsPatch[];
+            lastReconcileTime: string;
+            observed: outputs.mcpg.v1alpha1.MCPGTenantStatusObservedPatch;
+            observedGeneration: number;
+        }
+
+    }
+}
+
+export namespace meta {
+    export namespace v1 {
+        /**
+         * ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.
+         */
+        export interface ListMeta {
+            /**
+             * continue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the endpoint that served this list to retrieve the next set of available objects. Continuing a consistent list may not be possible if the server configuration has changed or more than a few minutes have passed. The resourceVersion field returned when using this continue value will be identical to the value in the first response, unless you have received this token from an error message.
+             */
+            continue: string;
+            /**
+             * remainingItemCount is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining items is unknown and the field will be left unset and omitted during serialization. If the list is complete (either because it is not chunking or because this is the last chunk), then there are no more remaining items and this field will be left unset and omitted during serialization. Servers older than v1.15 do not set this field. The intended use of the remainingItemCount is *estimating* the size of a collection. Clients should not rely on the remainingItemCount to be set or to be exact.
+             */
+            remainingItemCount: number;
+            /**
+             * String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+             */
+            resourceVersion: string;
+            /**
+             * Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.
+             */
+            selfLink: string;
+            /**
+             * shardInfo is set when the list is a filtered subset of the full collection, as selected by a shard selector on the request. It echoes back the selector so clients can verify which shard they received and merge sharded responses. Clients should not cache sharded list responses as a full representation of the collection.
+             *
+             * This is an alpha field and requires enabling the ShardedListAndWatch feature gate.
+             */
+            shardInfo: outputs.meta.v1.ShardInfo;
+        }
+
+        /**
+         * ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.
+         */
+        export interface ManagedFieldsEntry {
+            /**
+             * APIVersion defines the version of this resource that this field set applies to. The format is "group/version" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.
+             */
+            apiVersion: string;
+            /**
+             * FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: "FieldsV1"
+             */
+            fieldsType: string;
+            /**
+             * FieldsV1 holds the first JSON version format as described in the "FieldsV1" type.
+             */
+            fieldsV1: any;
+            /**
+             * Manager is an identifier of the workflow managing these fields.
+             */
+            manager: string;
+            /**
+             * Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.
+             */
+            operation: string;
+            /**
+             * Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.
+             */
+            subresource: string;
+            /**
+             * Time is the timestamp of when the ManagedFields entry was added. The timestamp will also be updated if a field is added, the manager changes any of the owned fields value or removes a field. The timestamp does not update when a field is removed from the entry because another manager took it over.
+             */
+            time: string;
+        }
+
+        /**
+         * ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.
+         */
+        export interface ManagedFieldsEntryPatch {
+            /**
+             * APIVersion defines the version of this resource that this field set applies to. The format is "group/version" just like the top-level APIVersion field. It is necessary to track the version of a field set because it cannot be automatically converted.
+             */
+            apiVersion: string;
+            /**
+             * FieldsType is the discriminator for the different fields format and version. There is currently only one possible value: "FieldsV1"
+             */
+            fieldsType: string;
+            /**
+             * FieldsV1 holds the first JSON version format as described in the "FieldsV1" type.
+             */
+            fieldsV1: any;
+            /**
+             * Manager is an identifier of the workflow managing these fields.
+             */
+            manager: string;
+            /**
+             * Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.
+             */
+            operation: string;
+            /**
+             * Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.
+             */
+            subresource: string;
+            /**
+             * Time is the timestamp of when the ManagedFields entry was added. The timestamp will also be updated if a field is added, the manager changes any of the owned fields value or removes a field. The timestamp does not update when a field is removed from the entry because another manager took it over.
+             */
+            time: string;
+        }
+
+        /**
+         * ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
+         */
+        export interface ObjectMeta {
+            /**
+             * Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations
+             */
+            annotations: {[key: string]: string};
+            /**
+             * CreationTimestamp is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC.
+             *
+             * Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+             */
+            creationTimestamp: string;
+            /**
+             * Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.
+             */
+            deletionGracePeriodSeconds: number;
+            /**
+             * DeletionTimestamp is RFC 3339 date and time at which this resource will be deleted. This field is set by the server when a graceful deletion is requested by the user, and is not directly settable by a client. The resource is expected to be deleted (no longer visible from resource lists, and not reachable by name) after the time in this field, once the finalizers list is empty. As long as the finalizers list contains items, deletion is blocked. Once the deletionTimestamp is set, this value may not be unset or be set further into the future, although it may be shortened or the resource may be deleted prior to this time. For example, a user may request that a pod is deleted in 30 seconds. The Kubelet will react by sending a graceful termination signal to the containers in the pod. After that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) to the container and after cleanup, remove the pod from the API. In the presence of network partitions, this object may still exist after this timestamp, until an administrator or automated process can determine the resource is fully terminated. If not set, graceful deletion of the object has not been requested.
+             *
+             * Populated by the system when a graceful deletion is requested. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+             */
+            deletionTimestamp: string;
+            /**
+             * Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order.  Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.
+             */
+            finalizers: string[];
+            /**
+             * GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.
+             *
+             * If this field is specified and the generated name exists, the server will return a 409.
+             *
+             * Applied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency
+             */
+            generateName: string;
+            /**
+             * A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.
+             */
+            generation: number;
+            /**
+             * Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels
+             */
+            labels: {[key: string]: string};
+            /**
+             * ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like "ci-cd". The set of fields is always in the version that the workflow used when modifying the object.
+             */
+            managedFields: outputs.meta.v1.ManagedFieldsEntry[];
+            /**
+             * Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names
+             */
+            name: string;
+            /**
+             * Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the "default" namespace, but "default" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.
+             *
+             * Must be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces
+             */
+            namespace: string;
+            /**
+             * List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.
+             */
+            ownerReferences: outputs.meta.v1.OwnerReference[];
+            /**
+             * An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.
+             *
+             * Populated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+             */
+            resourceVersion: string;
+            /**
+             * Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.
+             */
+            selfLink: string;
+            /**
+             * UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.
+             *
+             * Populated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids
+             */
+            uid: string;
+        }
+
+        /**
+         * ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
+         */
+        export interface ObjectMetaPatch {
+            /**
+             * Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations
+             */
+            annotations: {[key: string]: string};
+            /**
+             * CreationTimestamp is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value. It is represented in RFC3339 form and is in UTC.
+             *
+             * Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+             */
+            creationTimestamp: string;
+            /**
+             * Number of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.
+             */
+            deletionGracePeriodSeconds: number;
+            /**
+             * DeletionTimestamp is RFC 3339 date and time at which this resource will be deleted. This field is set by the server when a graceful deletion is requested by the user, and is not directly settable by a client. The resource is expected to be deleted (no longer visible from resource lists, and not reachable by name) after the time in this field, once the finalizers list is empty. As long as the finalizers list contains items, deletion is blocked. Once the deletionTimestamp is set, this value may not be unset or be set further into the future, although it may be shortened or the resource may be deleted prior to this time. For example, a user may request that a pod is deleted in 30 seconds. The Kubelet will react by sending a graceful termination signal to the containers in the pod. After that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL) to the container and after cleanup, remove the pod from the API. In the presence of network partitions, this object may still exist after this timestamp, until an administrator or automated process can determine the resource is fully terminated. If not set, graceful deletion of the object has not been requested.
+             *
+             * Populated by the system when a graceful deletion is requested. Read-only. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+             */
+            deletionTimestamp: string;
+            /**
+             * Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed. Finalizers may be processed and removed in any order.  Order is NOT enforced because it introduces significant risk of stuck finalizers. finalizers is a shared field, any actor with permission can reorder it. If the finalizer list is processed in order, then this can lead to a situation in which the component responsible for the first finalizer in the list is waiting for a signal (field value, external system, or other) produced by a component responsible for a finalizer later in the list, resulting in a deadlock. Without enforced ordering finalizers are free to order amongst themselves and are not vulnerable to ordering changes in the list.
+             */
+            finalizers: string[];
+            /**
+             * GenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be different than the name passed. This value will also be combined with a unique suffix. The provided value has the same validation rules as the Name field, and may be truncated by the length of the suffix required to make the value unique on the server.
+             *
+             * If this field is specified and the generated name exists, the server will return a 409.
+             *
+             * Applied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency
+             */
+            generateName: string;
+            /**
+             * A sequence number representing a specific generation of the desired state. Populated by the system. Read-only.
+             */
+            generation: number;
+            /**
+             * Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels
+             */
+            labels: {[key: string]: string};
+            /**
+             * ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand this field. A workflow can be the user's name, a controller's name, or the name of a specific apply path like "ci-cd". The set of fields is always in the version that the workflow used when modifying the object.
+             */
+            managedFields: outputs.meta.v1.ManagedFieldsEntryPatch[];
+            /**
+             * Name must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is primarily intended for creation idempotence and configuration definition. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names
+             */
+            name: string;
+            /**
+             * Namespace defines the space within which each name must be unique. An empty namespace is equivalent to the "default" namespace, but "default" is the canonical representation. Not all objects are required to be scoped to a namespace - the value of this field for those objects will be empty.
+             *
+             * Must be a DNS_LABEL. Cannot be updated. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces
+             */
+            namespace: string;
+            /**
+             * List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list will point to this controller, with the controller field set to true. There cannot be more than one managing controller.
+             */
+            ownerReferences: outputs.meta.v1.OwnerReferencePatch[];
+            /**
+             * An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. Clients must treat these values as opaque and passed unmodified back to the server. They may only be valid for a particular resource or set of resources.
+             *
+             * Populated by the system. Read-only. Value must be treated as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
+             */
+            resourceVersion: string;
+            /**
+             * Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.
+             */
+            selfLink: string;
+            /**
+             * UID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations.
+             *
+             * Populated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids
+             */
+            uid: string;
+        }
+
+        /**
+         * OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.
+         */
+        export interface OwnerReference {
+            /**
+             * API version of the referent.
+             */
+            apiVersion: string;
+            /**
+             * If true, AND if the owner has the "foregroundDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs "delete" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.
+             */
+            blockOwnerDeletion: boolean;
+            /**
+             * If true, this reference points to the managing controller.
+             */
+            controller: boolean;
+            /**
+             * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+             */
+            kind: string;
+            /**
+             * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names
+             */
+            name: string;
+            /**
+             * UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids
+             */
+            uid: string;
+        }
+
+        /**
+         * OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.
+         */
+        export interface OwnerReferencePatch {
+            /**
+             * API version of the referent.
+             */
+            apiVersion: string;
+            /**
+             * If true, AND if the owner has the "foregroundDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion for how the garbage collector interacts with this field and enforces the foreground deletion. Defaults to false. To set this field, a user needs "delete" permission of the owner, otherwise 422 (Unprocessable Entity) will be returned.
+             */
+            blockOwnerDeletion: boolean;
+            /**
+             * If true, this reference points to the managing controller.
+             */
+            controller: boolean;
+            /**
+             * Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+             */
+            kind: string;
+            /**
+             * Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names
+             */
+            name: string;
+            /**
+             * UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids
+             */
+            uid: string;
+        }
+
+        /**
+         * ShardInfo describes the shard selector that was applied to produce a list response. Its presence on a list response indicates the list is a filtered subset.
+         */
+        export interface ShardInfo {
+            /**
+             * selector is the shard selector string from the request, echoed back so clients can verify which shard they received and merge responses from multiple shards.
+             */
+            selector: string;
+        }
+
+    }
+}