[ apiv2 ] KVM and SOL enablement

apiv2/VERSION

@@ -1 +1 @@
-2.10.2-dev
+2.10.2

apiv2/api/openapi/openapi.yaml

@@ -16278,11 +16278,46 @@ components:
           title: amt_dns_suffix
           maxLength: 1024
           description: (OPTIONAL) textual message that describes dns_suffix for ACM mode.
-        desiredConsentCode:
+        kvmStatus:
+          title: kvm_status
+          description: KVM session activation status. Set by kvm-manager only.
+          readOnly: true
+          $ref: '#/components/schemas/KvmStatus'
+        desiredKvmState:
+          title: desired_kvm_state
+          description: '(OPTIONAL) Desired KVM session state. Written by operator. Valid values: KVM_STATE_START, KVM_STATE_STOP, KVM_CONSENT_RECEIVED, KVM_REDIRECTION_RECEIVED.'
+          $ref: '#/components/schemas/KvmState'
+        currentKvmState:
+          title: current_kvm_state
+          description: Current KVM session state. Set by kvm-manager only.
+          readOnly: true
+          $ref: '#/components/schemas/KvmState'
+        kvmSessionStatus:
           type: string
-          title: desired_consent_code
-          pattern: ^[0-9]{6}$
-          description: '(OPTIONAL) '
+          title: kvm_session_status
+          maxLength: 1024
+          description: Human-readable KVM session status message. Set by kvm-manager only.
+          readOnly: true
+        solStatus:
+          title: sol_status
+          description: SOL session activation status. Set by sol-manager only.
+          readOnly: true
+          $ref: '#/components/schemas/SolStatus'
+        desiredSolState:
+          title: desired_sol_state
+          description: '(OPTIONAL) Desired SOL session state. Written by operator. Valid values: SOL_STATE_START, SOL_STATE_STOP, SOL_STATE_CONSENT_RECEIVED, SOL_STATE_REDIRECTION_RECEIVED.'
+          $ref: '#/components/schemas/SolState'
+        currentSolState:
+          title: current_sol_state
+          description: Current SOL session state. Set by sol-manager only.
+          readOnly: true
+          $ref: '#/components/schemas/SolState'
+        solSessionStatus:
+          type: string
+          title: sol_session_status
+          maxLength: 1024
+          description: Human-readable SOL session status message. Set by sol-manager only.
+          readOnly: true
         siteId:
           type: string
           title: site_id
@@ -16749,6 +16784,26 @@ components:
         - INSTANCE_STATE_DELETED
         - INSTANCE_STATE_UNTRUSTED
       description: The Instance States.
+    KvmState:
+      type: string
+      title: KvmState
+      enum:
+        - KVM_STATE_UNSPECIFIED
+        - KVM_STATE_START
+        - KVM_STATE_STOP
+        - KVM_STATE_AWAITING_CONSENT
+        - KVM_STATE_ERROR
+        - KVM_CONSENT_RECEIVED
+        - KVM_REDIRECTION_RECEIVED
+      description: KVM session lifecycle state; KVM_CONSENT_RECEIVED and KVM_REDIRECTION_RECEIVED are desired-only values.
+    KvmStatus:
+      type: string
+      title: KvmStatus
+      enum:
+        - KVM_STATUS_UNSPECIFIED
+        - KVM_STATUS_ACTIVATED
+        - KVM_STATUS_DEACTIVATED
+      description: KvmStatus reflects whether a KVM remote session is currently active on the host.
     LinkState:
       type: string
       title: LinkState
@@ -16957,6 +17012,26 @@ components:
         - POWER_STATE_POWER_CYCLE
         - POWER_STATE_RESET_REPEAT
       description: The host power state.
+    SolState:
+      type: string
+      title: SolState
+      enum:
+        - SOL_STATE_UNSPECIFIED
+        - SOL_STATE_START
+        - SOL_STATE_STOP
+        - SOL_STATE_AWAITING_CONSENT
+        - SOL_STATE_ERROR
+        - SOL_STATE_CONSENT_RECEIVED
+        - SOL_STATE_REDIRECTION_RECEIVED
+      description: SOL session lifecycle state; SOL_STATE_CONSENT_RECEIVED and SOL_STATE_REDIRECTION_RECEIVED are desired-only values.
+    SolStatus:
+      type: string
+      title: SolStatus
+      enum:
+        - SOL_STATUS_UNSPECIFIED
+        - SOL_STATUS_ACTIVATED
+        - SOL_STATUS_DEACTIVATED
+      description: SolStatus reflects whether a SOL remote session is currently active on the host.
     UpdatePolicy:
       type: string
       title: UpdatePolicy

apiv2/api/proto/buf.yaml

@@ -10,6 +10,9 @@ deps:
 breaking:
   use:
     - FILE
+  ignore_only:
+    FIELD_NO_DELETE:
+      - resources/compute/v1/compute.proto
 lint:
   use:
     - STANDARD

apiv2/api/proto/resources/compute/v1/compute.proto

@@ -77,6 +77,42 @@ enum AmtControlMode {
   AMT_CONTROL_MODE_CCM = 2;
 }
 
+// KvmStatus reflects whether a KVM remote session is currently active on the host.
+enum KvmStatus {
+  KVM_STATUS_UNSPECIFIED = 0;
+  KVM_STATUS_ACTIVATED = 1;
+  KVM_STATUS_DEACTIVATED = 2;
+}
+
+// KVM session lifecycle state; KVM_CONSENT_RECEIVED and KVM_REDIRECTION_RECEIVED are desired-only values.
+enum KvmState {
+  KVM_STATE_UNSPECIFIED = 0;
+  KVM_STATE_START = 1;
+  KVM_STATE_STOP = 2;
+  KVM_STATE_AWAITING_CONSENT = 3;
+  KVM_STATE_ERROR = 4;
+  KVM_CONSENT_RECEIVED = 5;
+  KVM_REDIRECTION_RECEIVED = 6;
+}
+
+// SolStatus reflects whether a SOL remote session is currently active on the host.
+enum SolStatus {
+  SOL_STATUS_UNSPECIFIED = 0;
+  SOL_STATUS_ACTIVATED = 1;
+  SOL_STATUS_DEACTIVATED = 2;
+}
+
+// SOL session lifecycle state; SOL_STATE_CONSENT_RECEIVED and SOL_STATE_REDIRECTION_RECEIVED are desired-only values.
+enum SolState {
+  SOL_STATE_UNSPECIFIED = 0;
+  SOL_STATE_START = 1;
+  SOL_STATE_STOP = 2;
+  SOL_STATE_AWAITING_CONSENT = 3;
+  SOL_STATE_ERROR = 4;
+  SOL_STATE_CONSENT_RECEIVED = 5;
+  SOL_STATE_REDIRECTION_RECEIVED = 6;
+}
+
 // A Host resource.
 message HostResource {
   // Resource ID, generated on Create.
@@ -234,12 +270,31 @@ message HostResource {
     (buf.validate.field).string = {max_len: 1024}
   ]; // textual message that describes dns_suffix for ACM mode.
 
-  string desired_consent_code = 106 [
-    (google.api.field_behavior) = OPTIONAL,
-    (buf.validate.field).string = {pattern: "^[0-9]{6}$"},
-    (buf.validate.field).ignore = IGNORE_IF_UNPOPULATED
+  // KVM session activation status. Set by kvm-manager only.
+  KvmStatus kvm_status = 88 [(google.api.field_behavior) = OUTPUT_ONLY];
+  // Desired KVM session state. Written by operator. Valid values: KVM_STATE_START, KVM_STATE_STOP, KVM_CONSENT_RECEIVED, KVM_REDIRECTION_RECEIVED.
+  KvmState desired_kvm_state = 101 [(google.api.field_behavior) = OPTIONAL];
+  // Current KVM session state. Set by kvm-manager only.
+  KvmState current_kvm_state = 102 [(google.api.field_behavior) = OUTPUT_ONLY];
+  // Human-readable KVM session status message. Set by kvm-manager only.
+  string kvm_session_status = 104 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (buf.validate.field).string = {max_len: 1024}
   ];
 
+  reserved 106; reserved "desired_consent_code";
+
+  // SOL session activation status. Set by sol-manager only.
+  SolStatus sol_status = 108 [(google.api.field_behavior) = OUTPUT_ONLY];
+  // Desired SOL session state. Written by operator. Valid values: SOL_STATE_START, SOL_STATE_STOP, SOL_STATE_CONSENT_RECEIVED, SOL_STATE_REDIRECTION_RECEIVED.
+  SolState desired_sol_state = 109 [(google.api.field_behavior) = OPTIONAL];
+  // Current SOL session state. Set by sol-manager only.
+  SolState current_sol_state = 110 [(google.api.field_behavior) = OUTPUT_ONLY];
+  // Human-readable SOL session status message. Set by sol-manager only.
+  string sol_session_status = 112 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (buf.validate.field).string = {max_len: 1024}
+  ];
 
   // The site where the host is located.
   string site_id = 5001 [

apiv2/docs/proto.md

@@ -61,9 +61,13 @@
     - [HostState](#resources-compute-v1-HostState)
     - [InstanceKind](#resources-compute-v1-InstanceKind)
     - [InstanceState](#resources-compute-v1-InstanceState)
+    - [KvmState](#resources-compute-v1-KvmState)
+    - [KvmStatus](#resources-compute-v1-KvmStatus)
     - [LinkState](#resources-compute-v1-LinkState)
     - [PowerCommandPolicy](#resources-compute-v1-PowerCommandPolicy)
     - [PowerState](#resources-compute-v1-PowerState)
+    - [SolState](#resources-compute-v1-SolState)
+    - [SolStatus](#resources-compute-v1-SolStatus)
     - [UpdatePolicy](#resources-compute-v1-UpdatePolicy)
     - [WorkloadKind](#resources-compute-v1-WorkloadKind)
     - [WorkloadMemberKind](#resources-compute-v1-WorkloadMemberKind)
@@ -811,7 +815,14 @@ A Host resource.
 | user_lvm_size | [uint32](#uint32) |  | LVM size in GB. |
 | amt_control_mode | [AmtControlMode](#resources-compute-v1-AmtControlMode) |  | coming from user selection |
 | amt_dns_suffix | [string](#string) |  | textual message that describes dns_suffix for ACM mode. |
-| desired_consent_code | [string](#string) |  |  |
+| kvm_status | [KvmStatus](#resources-compute-v1-KvmStatus) |  | KVM session activation status. Set by kvm-manager only. |
+| desired_kvm_state | [KvmState](#resources-compute-v1-KvmState) |  | Desired KVM session state. Written by operator. Valid values: KVM_STATE_START, KVM_STATE_STOP, KVM_CONSENT_RECEIVED, KVM_REDIRECTION_RECEIVED. |
+| current_kvm_state | [KvmState](#resources-compute-v1-KvmState) |  | Current KVM session state. Set by kvm-manager only. |
+| kvm_session_status | [string](#string) |  | Human-readable KVM session status message. Set by kvm-manager only. |
+| sol_status | [SolStatus](#resources-compute-v1-SolStatus) |  | SOL session activation status. Set by sol-manager only. |
+| desired_sol_state | [SolState](#resources-compute-v1-SolState) |  | Desired SOL session state. Written by operator. Valid values: SOL_STATE_START, SOL_STATE_STOP, SOL_STATE_CONSENT_RECEIVED, SOL_STATE_REDIRECTION_RECEIVED. |
+| current_sol_state | [SolState](#resources-compute-v1-SolState) |  | Current SOL session state. Set by sol-manager only. |
+| sol_session_status | [string](#string) |  | Human-readable SOL session status message. Set by sol-manager only. |
 | site_id | [string](#string) |  | The site where the host is located. |
 | metadata | [resources.common.v1.MetadataItem](#resources-common-v1-MetadataItem) | repeated | The metadata associated with the host, represented by a list of key:value pairs. |
 | inherited_metadata | [resources.common.v1.MetadataItem](#resources-common-v1-MetadataItem) | repeated | The metadata inherited by the host, represented by a list of key:value pairs, rendered by location and logical structures. |
@@ -1186,6 +1197,36 @@ The Instance States.
 
 
 
+<a name="resources-compute-v1-KvmState"></a>
+
+### KvmState
+KVM session lifecycle state; KVM_CONSENT_RECEIVED and KVM_REDIRECTION_RECEIVED are desired-only values.
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+| KVM_STATE_UNSPECIFIED | 0 |  |
+| KVM_STATE_START | 1 |  |
+| KVM_STATE_STOP | 2 |  |
+| KVM_STATE_AWAITING_CONSENT | 3 |  |
+| KVM_STATE_ERROR | 4 |  |
+| KVM_CONSENT_RECEIVED | 5 |  |
+| KVM_REDIRECTION_RECEIVED | 6 |  |
+
+
+
+<a name="resources-compute-v1-KvmStatus"></a>
+
+### KvmStatus
+KvmStatus reflects whether a KVM remote session is currently active on the host.
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+| KVM_STATUS_UNSPECIFIED | 0 |  |
+| KVM_STATUS_ACTIVATED | 1 |  |
+| KVM_STATUS_DEACTIVATED | 2 |  |
+
+
+
 <a name="resources-compute-v1-LinkState"></a>
 
 ### LinkState
@@ -1230,6 +1271,36 @@ The host power state.
 
 
 
+<a name="resources-compute-v1-SolState"></a>
+
+### SolState
+SOL session lifecycle state; SOL_STATE_CONSENT_RECEIVED and SOL_STATE_REDIRECTION_RECEIVED are desired-only values.
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+| SOL_STATE_UNSPECIFIED | 0 |  |
+| SOL_STATE_START | 1 |  |
+| SOL_STATE_STOP | 2 |  |
+| SOL_STATE_AWAITING_CONSENT | 3 |  |
+| SOL_STATE_ERROR | 4 |  |
+| SOL_STATE_CONSENT_RECEIVED | 5 |  |
+| SOL_STATE_REDIRECTION_RECEIVED | 6 |  |
+
+
+
+<a name="resources-compute-v1-SolStatus"></a>
+
+### SolStatus
+SolStatus reflects whether a SOL remote session is currently active on the host.
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+| SOL_STATUS_UNSPECIFIED | 0 |  |
+| SOL_STATUS_ACTIVATED | 1 |  |
+| SOL_STATUS_DEACTIVATED | 2 |  |
+
+
+
 <a name="resources-compute-v1-UpdatePolicy"></a>
 
 ### UpdatePolicy

apiv2/go.mod

@@ -16,7 +16,7 @@ require (
 	github.com/labstack/echo-contrib v0.50.1
 	github.com/labstack/echo/v4 v4.15.1
 	github.com/oapi-codegen/runtime v1.1.1
-	github.com/open-edge-platform/infra-core/inventory/v2 v2.35.0
+	github.com/open-edge-platform/infra-core/inventory/v2 v2.35.1
 	github.com/open-edge-platform/orch-library/go v0.6.4-0.20260211092341-cfad67ad247d
 	github.com/prometheus/client_golang v1.23.2
 	github.com/stretchr/testify v1.11.1

apiv2/go.sum

@@ -1056,8 +1056,8 @@ github.com/oasdiff/yaml v0.0.0-20250309154309-f31be36b4037 h1:G7ERwszslrBzRxj//J
 github.com/oasdiff/yaml v0.0.0-20250309154309-f31be36b4037/go.mod h1:2bpvgLBZEtENV5scfDFEtB/5+1M4hkQhDQrccEJ/qGw=
 github.com/oasdiff/yaml3 v0.0.0-20250309153720-d2182401db90 h1:bQx3WeLcUWy+RletIKwUIt4x3t8n2SxavmoclizMb8c=
 github.com/oasdiff/yaml3 v0.0.0-20250309153720-d2182401db90/go.mod h1:y5+oSEHCPT/DGrS++Wc/479ERge0zTFxaF8PbGKcg2o=
-github.com/open-edge-platform/infra-core/inventory/v2 v2.35.0 h1:NlKK7Kh3x9JUB+dLwtSYfbyvG2nE+zy1FhNP/2Frh1c=
-github.com/open-edge-platform/infra-core/inventory/v2 v2.35.0/go.mod h1:WNM18zJ5iCFR9LgESM4RT/jgo+oicNrfdwtaOh19EHA=
+github.com/open-edge-platform/infra-core/inventory/v2 v2.35.1 h1:jBLsuc9+7FVW212d10cnaR+2p4XrTlgK3uWeJUMkwjY=
+github.com/open-edge-platform/infra-core/inventory/v2 v2.35.1/go.mod h1:wiWvyzTr13rOplddY7Mikmd46z5JR6sKDFdl2woEm1c=
 github.com/open-edge-platform/orch-library/go v0.6.4-0.20260211092341-cfad67ad247d h1:xRow90Mk5U2h+R60TTL8lPXIFbdQWSnHyg09vh8NEPo=
 github.com/open-edge-platform/orch-library/go v0.6.4-0.20260211092341-cfad67ad247d/go.mod h1:mYhs/KbcXPQWM+2cHZXyzeIIzM7xKvnNgsnHlFkXH0g=
 github.com/open-edge-platform/orch-library/go/dazl v0.5.4 h1:Rx/bSAZiLjEEBjUiJEzBvT0fQv5huT5FQ2Ke3IMUhiE=