@opensoha/contracts 0.1.19 → 0.1.21

package/openapi/soha-api.json

@@ -1614,6 +1614,65 @@
         ],
         "type": "object"
       },
+      "AgentPrometheusQueryRequest": {
+        "additionalProperties": false,
+        "description": "Range queries require start, end and step. The runtime also enforces end greater than start, a maximum 24-hour range and at most 11000 intervals.",
+        "if": {
+          "properties": {
+            "kind": {
+              "const": "range"
+            }
+          },
+          "required": [
+            "kind"
+          ]
+        },
+        "properties": {
+          "end": {
+            "format": "int64",
+            "minimum": 1,
+            "type": "integer"
+          },
+          "endpoint": {
+            "maxLength": 2048,
+            "type": "string"
+          },
+          "kind": {
+            "enum": [
+              "instant",
+              "range"
+            ],
+            "type": "string"
+          },
+          "query": {
+            "maxLength": 16384,
+            "minLength": 1,
+            "type": "string"
+          },
+          "start": {
+            "format": "int64",
+            "minimum": 1,
+            "type": "integer"
+          },
+          "step": {
+            "minimum": 1,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "endpoint",
+          "query",
+          "kind"
+        ],
+        "then": {
+          "required": [
+            "start",
+            "end",
+            "step"
+          ]
+        },
+        "type": "object"
+      },
       "AgentProviderCatalog": {
         "additionalProperties": false,
         "properties": {
@@ -8587,6 +8646,97 @@
         ],
         "type": "string"
       },
+      "ClusterAgentUpgradeInput": {
+        "additionalProperties": false,
+        "properties": {
+          "version": {
+            "description": "Explicit stable official Agent version, such as v0.1.7. Registry and container identity cannot be overridden.",
+            "maxLength": 64,
+            "pattern": "^v?(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "version"
+        ],
+        "type": "object"
+      },
+      "ClusterAgentUpgradeResult": {
+        "additionalProperties": false,
+        "properties": {
+          "previousImage": {
+            "type": "string"
+          },
+          "targetImage": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "previousImage",
+          "targetImage"
+        ],
+        "type": "object"
+      },
+      "ClusterAgentUpgradeResultEnvelope": {
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/ClusterAgentUpgradeResult"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "ClusterAgentUpgradeStatus": {
+        "additionalProperties": false,
+        "properties": {
+          "canUpgrade": {
+            "type": "boolean"
+          },
+          "image": {
+            "description": "Desired image of the standard Agent Deployment.",
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          },
+          "recommendedVersion": {
+            "description": "Agent version bundled with this Core release.",
+            "type": "string"
+          },
+          "rolloutStatus": {
+            "type": "string"
+          },
+          "upgradeDisabledReason": {
+            "type": "string"
+          },
+          "version": {
+            "description": "Version reported by the currently connected Agent process.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "version",
+          "image",
+          "recommendedVersion",
+          "rolloutStatus",
+          "message",
+          "canUpgrade"
+        ],
+        "type": "object"
+      },
+      "ClusterAgentUpgradeStatusEnvelope": {
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/ClusterAgentUpgradeStatus"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
       "ClusterCapabilityMatrixEntry": {
         "additionalProperties": false,
         "properties": {
@@ -23647,6 +23797,70 @@
         },
         "type": "object"
       },
+      "KubernetesAgentCustomResourceRule": {
+        "additionalProperties": false,
+        "properties": {
+          "apiGroup": {
+            "maxLength": 253,
+            "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$",
+            "type": "string"
+          },
+          "namespaces": {
+            "description": "Explicit namespaces; omitted or empty grants cluster-wide access to the named resources only.",
+            "items": {
+              "maxLength": 63,
+              "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$",
+              "type": "string"
+            },
+            "maxItems": 50,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "resources": {
+            "items": {
+              "maxLength": 63,
+              "pattern": "^[a-z]([a-z0-9-]*[a-z0-9])?$",
+              "type": "string"
+            },
+            "maxItems": 50,
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "verbs": {
+            "items": {
+              "enum": [
+                "get",
+                "list",
+                "watch",
+                "create",
+                "update",
+                "patch",
+                "delete"
+              ],
+              "type": "string",
+              "x-enum-varnames": [
+                "KubernetesAgentCustomResourceRuleVerbsGet",
+                "KubernetesAgentCustomResourceRuleVerbsList",
+                "KubernetesAgentCustomResourceRuleVerbsWatch",
+                "KubernetesAgentCustomResourceRuleVerbsCreate",
+                "KubernetesAgentCustomResourceRuleVerbsUpdate",
+                "KubernetesAgentCustomResourceRuleVerbsPatch",
+                "KubernetesAgentCustomResourceRuleVerbsDelete"
+              ]
+            },
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+          }
+        },
+        "required": [
+          "apiGroup",
+          "resources",
+          "verbs"
+        ],
+        "type": "object"
+      },
       "KubernetesBackendTLSPolicy": {
         "additionalProperties": false,
         "properties": {
@@ -23814,6 +24028,13 @@
           "credentialType": {
             "type": "string"
           },
+          "customResourceRules": {
+            "items": {
+              "$ref": "#/components/schemas/KubernetesAgentCustomResourceRule"
+            },
+            "maxItems": 50,
+            "type": "array"
+          },
           "endpoint": {
             "type": "string"
           },
@@ -24027,6 +24248,69 @@
         ],
         "type": "object"
       },
+      "KubernetesClusterRegistrationRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "agentCustomResourceRules": {
+            "items": {
+              "$ref": "#/components/schemas/KubernetesAgentCustomResourceRule"
+            },
+            "maxItems": 50,
+            "type": "array"
+          },
+          "agentEndpoint": {
+            "type": "string"
+          },
+          "agentToken": {
+            "type": "string",
+            "writeOnly": true
+          },
+          "connectionMode": {
+            "$ref": "#/components/schemas/KubernetesConnectionMode"
+          },
+          "context": {
+            "type": "string"
+          },
+          "environment": {
+            "type": "string"
+          },
+          "grafanaBaseUrl": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "kubeconfig": {
+            "type": "string"
+          },
+          "labels": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          },
+          "prometheusBaseUrl": {
+            "type": "string"
+          },
+          "prometheusBearerToken": {
+            "type": "string",
+            "writeOnly": true
+          },
+          "prometheusClusterLabel": {
+            "type": "string"
+          },
+          "prometheusTransport": {
+            "$ref": "#/components/schemas/KubernetesPrometheusTransport"
+          },
+          "region": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
       "KubernetesClusterRole": {
         "additionalProperties": false,
         "properties": {
@@ -24303,6 +24587,18 @@
         ],
         "type": "object"
       },
+      "KubernetesConfigMapDataInput": {
+        "additionalProperties": false,
+        "properties": {
+          "binaryData": {
+            "$ref": "#/components/schemas/KubernetesStringMap"
+          },
+          "data": {
+            "$ref": "#/components/schemas/KubernetesStringMap"
+          }
+        },
+        "type": "object"
+      },
       "KubernetesConfigMapDetail": {
         "additionalProperties": false,
         "properties": {
@@ -24555,6 +24851,18 @@
         ],
         "type": "object"
       },
+      "KubernetesCronJobSuspendInput": {
+        "additionalProperties": false,
+        "properties": {
+          "suspend": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "suspend"
+        ],
+        "type": "object"
+      },
       "KubernetesCustomResource": {
         "additionalProperties": false,
         "properties": {
@@ -24613,6 +24921,47 @@
         ],
         "type": "object"
       },
+      "KubernetesCustomResourceAccess": {
+        "additionalProperties": false,
+        "properties": {
+          "allowedActions": {
+            "items": {
+              "enum": [
+                "list",
+                "view",
+                "create",
+                "update",
+                "delete"
+              ],
+              "type": "string",
+              "x-enum-varnames": [
+                "CustomResourceAccessList",
+                "CustomResourceAccessView",
+                "CustomResourceAccessCreate",
+                "CustomResourceAccessUpdate",
+                "CustomResourceAccessDelete"
+              ]
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "allowedActions"
+        ],
+        "type": "object"
+      },
+      "KubernetesCustomResourceAccessEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/KubernetesCustomResourceAccess"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
       "KubernetesCustomResourceDefinition": {
         "additionalProperties": false,
         "properties": {
@@ -24630,6 +24979,10 @@
           "createdAt": {
             "type": "string"
           },
+          "deletingAt": {
+            "format": "date-time",
+            "type": "string"
+          },
           "group": {
             "type": "string"
           },
@@ -24645,6 +24998,11 @@
           "scope": {
             "type": "string"
           },
+          "uid": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
           "version": {
             "type": "string"
           },
@@ -27879,6 +28237,53 @@
         ],
         "type": "object"
       },
+      "KubernetesNamespaceCreateInput": {
+        "additionalProperties": false,
+        "properties": {
+          "annotations": {
+            "$ref": "#/components/schemas/KubernetesStringMap"
+          },
+          "labels": {
+            "$ref": "#/components/schemas/KubernetesStringMap"
+          },
+          "name": {
+            "minLength": 1,
+            "pattern": "\\S",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name"
+        ],
+        "type": "object"
+      },
+      "KubernetesNamespaceEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/KubernetesNamespace"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "KubernetesNamespaceInput": {
+        "additionalProperties": false,
+        "properties": {
+          "annotations": {
+            "$ref": "#/components/schemas/KubernetesStringMap"
+          },
+          "labels": {
+            "$ref": "#/components/schemas/KubernetesStringMap"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
       "KubernetesNamespaceListEnvelope": {
         "additionalProperties": false,
         "properties": {
@@ -28466,6 +28871,24 @@
         ],
         "type": "object"
       },
+      "KubernetesNodeDrainInput": {
+        "additionalProperties": false,
+        "properties": {
+          "deleteEmptyDirData": {
+            "type": "boolean"
+          },
+          "force": {
+            "type": "boolean"
+          },
+          "timeoutSeconds": {
+            "default": 300,
+            "maximum": 1800,
+            "minimum": 30,
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
       "KubernetesNodeListEnvelope": {
         "additionalProperties": false,
         "properties": {
@@ -28565,6 +28988,18 @@
         },
         "type": "object"
       },
+      "KubernetesNodeSchedulabilityInput": {
+        "additionalProperties": false,
+        "properties": {
+          "unschedulable": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "unschedulable"
+        ],
+        "type": "object"
+      },
       "KubernetesNodeTaint": {
         "additionalProperties": false,
         "properties": {
@@ -28584,6 +29019,21 @@
         ],
         "type": "object"
       },
+      "KubernetesNodeUpdateInput": {
+        "additionalProperties": false,
+        "properties": {
+          "labels": {
+            "$ref": "#/components/schemas/KubernetesStringMap"
+          },
+          "taints": {
+            "items": {
+              "$ref": "#/components/schemas/KubernetesNodeTaint"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
       "KubernetesPersistentVolume": {
         "additionalProperties": false,
         "properties": {
@@ -29445,6 +29895,9 @@
           },
           "hasBearerToken": {
             "type": "boolean"
+          },
+          "transport": {
+            "$ref": "#/components/schemas/KubernetesPrometheusTransport"
           }
         },
         "required": [
@@ -29452,6 +29905,14 @@
         ],
         "type": "object"
       },
+      "KubernetesPrometheusTransport": {
+        "default": "direct",
+        "enum": [
+          "direct",
+          "agent"
+        ],
+        "type": "string"
+      },
       "KubernetesReferenceGrant": {
         "additionalProperties": false,
         "properties": {
@@ -30378,7 +30839,10 @@
             "enum": [
               "create"
             ],
-            "type": "string"
+            "type": "string",
+            "x-enum-varnames": [
+              "Create"
+            ]
           },
           "apiVersion": {
             "minLength": 1,
@@ -31362,6 +31826,19 @@
         ],
         "type": "object"
       },
+      "KubernetesResourceYamlInput": {
+        "additionalProperties": false,
+        "properties": {
+          "content": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "content"
+        ],
+        "type": "object"
+      },
       "KubernetesRole": {
         "additionalProperties": false,
         "properties": {
@@ -31614,6 +32091,71 @@
         ],
         "type": "object"
       },
+      "KubernetesSecretDataInput": {
+        "additionalProperties": false,
+        "description": "Data values are plain text. The response detail returns Kubernetes Base64-encoded values.",
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/KubernetesStringMap"
+          }
+        },
+        "type": "object"
+      },
+      "KubernetesSecretDetail": {
+        "additionalProperties": false,
+        "properties": {
+          "ageSeconds": {
+            "format": "int64",
+            "minimum": 0,
+            "type": "integer"
+          },
+          "annotations": {
+            "$ref": "#/components/schemas/KubernetesStringMap"
+          },
+          "createdAt": {
+            "type": "string"
+          },
+          "data": {
+            "$ref": "#/components/schemas/KubernetesStringMap",
+            "description": "Secret data values encoded with standard Base64. Requires secret-data.view."
+          },
+          "immutable": {
+            "type": "boolean"
+          },
+          "labels": {
+            "$ref": "#/components/schemas/KubernetesStringMap"
+          },
+          "name": {
+            "type": "string"
+          },
+          "namespace": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "namespace",
+          "immutable",
+          "ageSeconds",
+          "type"
+        ],
+        "type": "object"
+      },
+      "KubernetesSecretDetailEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/KubernetesSecretDetail"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
       "KubernetesSecretMetadata": {
         "additionalProperties": false,
         "properties": {
@@ -41181,6 +41723,173 @@
         ],
         "type": "object"
       },
+      "NetworkProxyCapability": {
+        "enum": [
+          "traffic",
+          "connections",
+          "close_connection"
+        ],
+        "type": "string",
+        "x-enum-varnames": [
+          "NetworkProxyCapabilityTraffic",
+          "NetworkProxyCapabilityConnections",
+          "NetworkProxyCapabilityCloseConnection"
+        ]
+      },
+      "NetworkProxyCloseCommandEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "commandId": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "expiresAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "status": {
+            "enum": [
+              "pending",
+              "closed",
+              "not-found",
+              "failed",
+              "expired"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "commandId",
+          "status",
+          "expiresAt"
+        ],
+        "type": "object"
+      },
+      "NetworkProxyConfigurationInput": {
+        "additionalProperties": false,
+        "properties": {
+          "content": {
+            "format": "password",
+            "maxLength": 1048576,
+            "minLength": 1,
+            "type": "string",
+            "writeOnly": true
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "expectedRevision": {
+            "format": "int64",
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "expectedRevision",
+          "enabled",
+          "content"
+        ],
+        "type": "object"
+      },
+      "NetworkProxyConnection": {
+        "additionalProperties": false,
+        "properties": {
+          "destination": {
+            "maxLength": 253,
+            "minLength": 1,
+            "type": "string"
+          },
+          "downloadBytes": {
+            "format": "int64",
+            "minimum": 0,
+            "type": "integer"
+          },
+          "id": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "network": {
+            "enum": [
+              "tcp",
+              "udp",
+              "other"
+            ],
+            "type": "string",
+            "x-enum-varnames": [
+              "NetworkProxyConnectionNetworkTCP",
+              "NetworkProxyConnectionNetworkUDP",
+              "NetworkProxyConnectionNetworkOther"
+            ]
+          },
+          "startedAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "uploadBytes": {
+            "format": "int64",
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "id",
+          "destination",
+          "network",
+          "uploadBytes",
+          "downloadBytes"
+        ],
+        "type": "object"
+      },
+      "NetworkProxyConnectionsEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "connections": {
+            "items": {
+              "$ref": "#/components/schemas/NetworkProxyConnection"
+            },
+            "maxItems": 200,
+            "type": "array"
+          },
+          "instanceId": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "observedAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "state": {
+            "enum": [
+              "available",
+              "unsupported",
+              "unavailable"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "instanceId",
+          "state",
+          "connections"
+        ],
+        "type": "object"
+      },
+      "NetworkProxyEngine": {
+        "enum": [
+          "mihomo",
+          "sing-box",
+          "v2ray"
+        ],
+        "type": "string",
+        "x-enum-varnames": [
+          "NetworkProxyEngineMihomo",
+          "NetworkProxyEngineSingBox",
+          "NetworkProxyEngineV2Ray"
+        ]
+      },
       "NetworkProxyFlowSummary": {
         "additionalProperties": false,
         "properties": {
@@ -41244,6 +41953,228 @@
         ],
         "type": "object"
       },
+      "NetworkProxyInstance": {
+        "additionalProperties": false,
+        "properties": {
+          "capabilities": {
+            "items": {
+              "$ref": "#/components/schemas/NetworkProxyCapability"
+            },
+            "maxItems": 3,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "createdAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "desiredRevision": {
+            "format": "int64",
+            "minimum": 0,
+            "type": "integer"
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "engine": {
+            "$ref": "#/components/schemas/NetworkProxyEngine"
+          },
+          "engineVersion": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "host": {
+            "maxLength": 128,
+            "type": "string"
+          },
+          "id": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "lastSampleAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "lastSeenAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "name": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "observedRevision": {
+            "format": "int64",
+            "minimum": 0,
+            "type": "integer"
+          },
+          "reasonCode": {
+            "maxLength": 128,
+            "type": "string"
+          },
+          "status": {
+            "$ref": "#/components/schemas/NetworkProxyInstanceStatus"
+          },
+          "updatedAt": {
+            "format": "date-time",
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "engine",
+          "enabled",
+          "status",
+          "capabilities",
+          "desiredRevision",
+          "observedRevision",
+          "createdAt",
+          "updatedAt"
+        ],
+        "type": "object"
+      },
+      "NetworkProxyInstanceEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/NetworkProxyInstance"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "NetworkProxyInstanceInput": {
+        "additionalProperties": false,
+        "properties": {
+          "engine": {
+            "$ref": "#/components/schemas/NetworkProxyEngine"
+          },
+          "host": {
+            "maxLength": 128,
+            "type": "string"
+          },
+          "id": {
+            "maxLength": 128,
+            "minLength": 1,
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
+            "type": "string"
+          },
+          "name": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "engine"
+        ],
+        "type": "object"
+      },
+      "NetworkProxyInstanceListEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "items": {
+              "$ref": "#/components/schemas/NetworkProxyInstance"
+            },
+            "maxItems": 200,
+            "type": "array"
+          }
+        },
+        "required": [
+          "items"
+        ],
+        "type": "object"
+      },
+      "NetworkProxyInstanceStatus": {
+        "enum": [
+          "unregistered",
+          "online",
+          "degraded",
+          "offline",
+          "disabled"
+        ],
+        "type": "string",
+        "x-enum-varnames": [
+          "NetworkProxyInstanceStatusUnregistered",
+          "NetworkProxyInstanceStatusOnline",
+          "NetworkProxyInstanceStatusDegraded",
+          "NetworkProxyInstanceStatusOffline",
+          "NetworkProxyInstanceStatusDisabled"
+        ]
+      },
+      "NetworkProxyTrafficEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "instanceId": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "samples": {
+            "items": {
+              "$ref": "#/components/schemas/NetworkProxyTrafficSample"
+            },
+            "maxItems": 1440,
+            "type": "array"
+          },
+          "supported": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "instanceId",
+          "supported",
+          "samples"
+        ],
+        "type": "object"
+      },
+      "NetworkProxyTrafficSample": {
+        "additionalProperties": false,
+        "properties": {
+          "activeConnections": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "downloadBytesPerSecond": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "downloadTotal": {
+            "format": "int64",
+            "minimum": 0,
+            "type": "integer"
+          },
+          "observedAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "uploadBytesPerSecond": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "uploadTotal": {
+            "format": "int64",
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "observedAt",
+          "uploadTotal",
+          "downloadTotal",
+          "uploadBytesPerSecond",
+          "downloadBytesPerSecond"
+        ],
+        "type": "object"
+      },
       "NetworkResource": {
         "additionalProperties": false,
         "properties": {
@@ -41504,6 +42435,7 @@
       },
       "NetworkRuntimeEnrollmentInput": {
         "additionalProperties": false,
+        "description": "For proxy runtimes, runtimeId identifies an existing proxy instance and deviceId and subjectId must equal runtimeId.",
         "properties": {
           "deviceId": {
             "maxLength": 128,
@@ -41603,13 +42535,15 @@
         "enum": [
           "endpoint",
           "gateway",
-          "nas"
+          "nas",
+          "proxy"
         ],
         "type": "string",
         "x-enum-varnames": [
           "NetworkRuntimeKindEndpoint",
           "NetworkRuntimeKindGateway",
-          "NetworkRuntimeKindNAS"
+          "NetworkRuntimeKindNAS",
+          "NetworkRuntimeKindProxy"
         ]
       },
       "NetworkSession": {
@@ -60796,7 +61730,7 @@
   "info": {
     "description": "Public OpenSoha core API contract. This first contract focuses on stable cross-repository boundaries: auth, health, runner-facing control-plane callbacks, AI Gateway, and MCP capability discovery.\n",
     "title": "Soha API",
-    "version": "0.1.19"
+    "version": "0.1.21"
   },
   "openapi": "3.1.0",
   "paths": {