@opensoha/contracts 0.1.6 → 0.1.8

package/openapi/soha-api.json

@@ -67,6 +67,16 @@
           "type": "string"
         }
       },
+      "AgentInstallTicket": {
+        "in": "path",
+        "name": "installTicket",
+        "required": true,
+        "schema": {
+          "maxLength": 1024,
+          "minLength": 16,
+          "type": "string"
+        }
+      },
       "AgentProviderRolloutAction": {
         "in": "path",
         "name": "rolloutAction",
@@ -177,6 +187,15 @@
           "type": "string"
         }
       },
+      "ClusterIDQuery": {
+        "in": "query",
+        "name": "clusterId",
+        "required": true,
+        "schema": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
       "ComputeActionID": {
         "in": "path",
         "name": "action",
@@ -273,6 +292,26 @@
           "type": "string"
         }
       },
+      "DashboardID": {
+        "in": "path",
+        "name": "dashboardID",
+        "required": true,
+        "schema": {
+          "maxLength": 128,
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "DashboardPanelID": {
+        "in": "path",
+        "name": "panelID",
+        "required": true,
+        "schema": {
+          "maxLength": 128,
+          "minLength": 1,
+          "type": "string"
+        }
+      },
       "DataSourceID": {
         "in": "path",
         "name": "dataSourceID",
@@ -598,6 +637,18 @@
           "type": "string"
         }
       },
+      "PluginAssetPath": {
+        "description": "Slash-separated relative path declared by the active companion pack.",
+        "in": "path",
+        "name": "assetPath",
+        "required": true,
+        "schema": {
+          "maxLength": 512,
+          "minLength": 1,
+          "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)[A-Za-z0-9._/-]+$",
+          "type": "string"
+        }
+      },
       "PluginID": {
         "in": "path",
         "name": "pluginID",
@@ -614,6 +665,15 @@
           "type": "string"
         }
       },
+      "RegistryConnectionID": {
+        "in": "path",
+        "name": "connectionID",
+        "required": true,
+        "schema": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
       "RelayState": {
         "in": "query",
         "name": "RelayState",
@@ -743,6 +803,16 @@
           "type": "string"
         }
       },
+      "SoftwarePackageID": {
+        "in": "path",
+        "name": "packageID",
+        "required": true,
+        "schema": {
+          "maxLength": 128,
+          "minLength": 1,
+          "type": "string"
+        }
+      },
       "SohaCacheModeHeader": {
         "description": "Optional relay cache behavior hint.",
         "in": "header",
@@ -1010,6 +1080,46 @@
         ],
         "type": "object"
       },
+      "AgentInstallation": {
+        "additionalProperties": false,
+        "properties": {
+          "clusterId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "command": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "expiresAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "manifestUrl": {
+            "format": "uri",
+            "type": "string"
+          }
+        },
+        "required": [
+          "clusterId",
+          "manifestUrl",
+          "command",
+          "expiresAt"
+        ],
+        "type": "object"
+      },
+      "AgentInstallationEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/AgentInstallation"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
       "AgentProviderCatalog": {
         "additionalProperties": false,
         "properties": {
@@ -3941,6 +4051,11 @@
           "targetId": {
             "type": "string"
           },
+          "valuesContent": {
+            "description": "Complete Helm values YAML used when the selected target is a managed Helm release.",
+            "maxLength": 1048576,
+            "type": "string"
+          },
           "variables": {
             "additionalProperties": true,
             "type": "object"
@@ -4329,8 +4444,6 @@
         "required": [
           "name",
           "key",
-          "group",
-          "language",
           "enabled"
         ],
         "type": "object"
@@ -6228,6 +6341,481 @@
         ],
         "type": "object"
       },
+      "CompanionActivationRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "version": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "CompanionAnimationBindings": {
+        "additionalProperties": false,
+        "properties": {
+          "dragging": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "error": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "hover": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "idle": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "listening": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "speaking": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "tap": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "thinking": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "CompanionAsset": {
+        "additionalProperties": false,
+        "properties": {
+          "contentType": {
+            "enum": [
+              "application/json",
+              "application/octet-stream",
+              "image/png",
+              "image/jpeg",
+              "image/webp",
+              "image/svg+xml",
+              "audio/mpeg",
+              "audio/ogg"
+            ],
+            "type": "string"
+          },
+          "kind": {
+            "enum": [
+              "entry",
+              "model",
+              "texture",
+              "motion",
+              "expression",
+              "physics",
+              "pose",
+              "thumbnail",
+              "audio"
+            ],
+            "type": "string"
+          },
+          "path": {
+            "maxLength": 512,
+            "minLength": 1,
+            "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)[A-Za-z0-9._/-]+$",
+            "type": "string"
+          },
+          "sha256": {
+            "pattern": "^sha256:[a-f0-9]{64}$",
+            "type": "string"
+          },
+          "sizeBytes": {
+            "format": "int64",
+            "maximum": 67108864,
+            "minimum": 1,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "path",
+          "kind",
+          "contentType",
+          "sizeBytes",
+          "sha256"
+        ],
+        "type": "object"
+      },
+      "CompanionInteractionDefinition": {
+        "additionalProperties": false,
+        "properties": {
+          "action": {
+            "enum": [
+              "tap",
+              "pet",
+              "feed",
+              "play",
+              "greet"
+            ],
+            "type": "string"
+          },
+          "animation": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "cooldownSeconds": {
+            "maximum": 86400,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "id": {
+            "pattern": "^[a-z][a-z0-9._-]*$",
+            "type": "string"
+          },
+          "label": {
+            "maxLength": 64,
+            "minLength": 1,
+            "type": "string"
+          },
+          "rewardAffinity": {
+            "maximum": 100,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "rewardXp": {
+            "maximum": 1000,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "id",
+          "action"
+        ],
+        "type": "object"
+      },
+      "CompanionInteractionReceipt": {
+        "additionalProperties": false,
+        "properties": {
+          "affinityAwarded": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "applied": {
+            "type": "boolean"
+          },
+          "idempotencyKey": {
+            "type": "string"
+          },
+          "profile": {
+            "$ref": "#/components/schemas/CompanionProfile"
+          },
+          "unlockedIds": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array",
+            "uniqueItems": true
+          },
+          "xpAwarded": {
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "idempotencyKey",
+          "applied",
+          "xpAwarded",
+          "affinityAwarded",
+          "unlockedIds",
+          "profile"
+        ],
+        "type": "object"
+      },
+      "CompanionInteractionReceiptEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/CompanionInteractionReceipt"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "CompanionInteractionRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "clientRevision": {
+            "format": "int64",
+            "minimum": 1,
+            "type": "integer"
+          },
+          "interactionId": {
+            "pattern": "^[a-z][a-z0-9._-]*$",
+            "type": "string"
+          },
+          "messageId": {
+            "type": "string"
+          },
+          "pluginId": {
+            "type": "string"
+          },
+          "sessionId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "pluginId",
+          "interactionId"
+        ],
+        "type": "object"
+      },
+      "CompanionPackLicense": {
+        "additionalProperties": false,
+        "properties": {
+          "attribution": {
+            "maxLength": 2048,
+            "type": "string"
+          },
+          "commercialUseAllowed": {
+            "type": "boolean"
+          },
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "redistributionAllowed": {
+            "enum": [
+              true
+            ],
+            "type": "boolean"
+          },
+          "sourceUrl": {
+            "format": "uri",
+            "type": "string"
+          },
+          "spdxId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "url": {
+            "format": "uri",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "url",
+          "redistributionAllowed",
+          "commercialUseAllowed"
+        ],
+        "type": "object"
+      },
+      "CompanionPackManifest": {
+        "additionalProperties": false,
+        "properties": {
+          "animations": {
+            "$ref": "#/components/schemas/CompanionAnimationBindings"
+          },
+          "assets": {
+            "items": {
+              "$ref": "#/components/schemas/CompanionAsset"
+            },
+            "maxItems": 512,
+            "minItems": 1,
+            "type": "array"
+          },
+          "entryAsset": {
+            "maxLength": 512,
+            "minLength": 1,
+            "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)[A-Za-z0-9._/-]+$",
+            "type": "string"
+          },
+          "interactions": {
+            "items": {
+              "$ref": "#/components/schemas/CompanionInteractionDefinition"
+            },
+            "maxItems": 64,
+            "type": "array"
+          },
+          "license": {
+            "$ref": "#/components/schemas/CompanionPackLicense"
+          },
+          "modelFormatVersion": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "renderer": {
+            "enum": [
+              "svg",
+              "sprite",
+              "live2d-cubism"
+            ],
+            "type": "string"
+          },
+          "thumbnailAsset": {
+            "maxLength": 512,
+            "minLength": 1,
+            "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)[A-Za-z0-9._/-]+$",
+            "type": "string"
+          },
+          "unlocks": {
+            "items": {
+              "$ref": "#/components/schemas/CompanionUnlockDefinition"
+            },
+            "maxItems": 128,
+            "type": "array"
+          }
+        },
+        "required": [
+          "renderer",
+          "entryAsset",
+          "assets",
+          "license"
+        ],
+        "type": "object"
+      },
+      "CompanionProfile": {
+        "additionalProperties": false,
+        "properties": {
+          "activePluginId": {
+            "type": "string"
+          },
+          "activeVersion": {
+            "type": "string"
+          },
+          "affinity": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "createdAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "lastInteractionAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "level": {
+            "maximum": 100,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "ownerId": {
+            "type": "string"
+          },
+          "revision": {
+            "format": "int64",
+            "minimum": 1,
+            "type": "integer"
+          },
+          "unlockedIds": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array",
+            "uniqueItems": true
+          },
+          "updatedAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "xp": {
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "id",
+          "ownerId",
+          "activePluginId",
+          "activeVersion",
+          "level",
+          "xp",
+          "affinity",
+          "unlockedIds",
+          "revision",
+          "createdAt",
+          "updatedAt"
+        ],
+        "type": "object"
+      },
+      "CompanionProfileEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/CompanionProfile"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "CompanionProfileResetRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "pluginId": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "CompanionRollbackRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "reason": {
+            "maxLength": 512,
+            "type": "string"
+          },
+          "version": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "version"
+        ],
+        "type": "object"
+      },
+      "CompanionUnlockDefinition": {
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "pattern": "^[a-z][a-z0-9._-]*$",
+            "type": "string"
+          },
+          "kind": {
+            "enum": [
+              "interaction",
+              "animation",
+              "expression",
+              "asset"
+            ],
+            "type": "string"
+          },
+          "level": {
+            "maximum": 100,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "ref": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "kind",
+          "level",
+          "ref"
+        ],
+        "type": "object"
+      },
       "ComputeAccessMode": {
         "enum": [
           "direct",
@@ -11502,6 +12090,181 @@
         ],
         "type": "object"
       },
+      "HelmImportedService": {
+        "additionalProperties": false,
+        "properties": {
+          "created": {
+            "type": "boolean"
+          },
+          "id": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "releaseName": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "key",
+          "name",
+          "releaseName",
+          "created"
+        ],
+        "type": "object"
+      },
+      "HelmImportedTarget": {
+        "additionalProperties": false,
+        "properties": {
+          "created": {
+            "type": "boolean"
+          },
+          "id": {
+            "type": "string"
+          },
+          "releaseName": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "releaseName",
+          "created"
+        ],
+        "type": "object"
+      },
+      "HelmReleaseImportInput": {
+        "additionalProperties": false,
+        "properties": {
+          "releaseName": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "releaseName"
+        ],
+        "type": "object"
+      },
+      "HelmReleaseImportRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "applicationKey": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "applicationName": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "clusterId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "environmentKey": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "environmentName": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "namespace": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "ownershipMode": {
+            "enum": [
+              "observe_only",
+              "managed"
+            ],
+            "type": "string"
+          },
+          "releases": {
+            "items": {
+              "$ref": "#/components/schemas/HelmReleaseImportInput"
+            },
+            "maxItems": 100,
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+          }
+        },
+        "required": [
+          "clusterId",
+          "namespace",
+          "applicationKey",
+          "applicationName",
+          "environmentKey",
+          "environmentName",
+          "ownershipMode",
+          "releases"
+        ],
+        "type": "object"
+      },
+      "HelmReleaseImportResult": {
+        "additionalProperties": false,
+        "properties": {
+          "application": {
+            "$ref": "#/components/schemas/KubernetesImportEntityRef"
+          },
+          "applicationEnvironmentCreated": {
+            "type": "boolean"
+          },
+          "applicationEnvironmentId": {
+            "type": "string"
+          },
+          "environment": {
+            "$ref": "#/components/schemas/KubernetesImportEntityRef"
+          },
+          "ownershipMode": {
+            "enum": [
+              "observe_only",
+              "managed"
+            ],
+            "type": "string"
+          },
+          "services": {
+            "items": {
+              "$ref": "#/components/schemas/HelmImportedService"
+            },
+            "type": "array"
+          },
+          "targets": {
+            "items": {
+              "$ref": "#/components/schemas/HelmImportedTarget"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "application",
+          "environment",
+          "applicationEnvironmentId",
+          "applicationEnvironmentCreated",
+          "ownershipMode",
+          "services",
+          "targets"
+        ],
+        "type": "object"
+      },
+      "HelmReleaseImportResultEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/HelmReleaseImportResult"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
       "IdentityApplication": {
         "additionalProperties": false,
         "properties": {
@@ -12527,6 +13290,15 @@
       "InstalledPlugin": {
         "additionalProperties": false,
         "properties": {
+          "activeVersion": {
+            "type": "string"
+          },
+          "artifacts": {
+            "items": {
+              "$ref": "#/components/schemas/PluginArtifactRecord"
+            },
+            "type": "array"
+          },
           "checksumStatus": {
             "type": "string"
           },
@@ -14072,6 +14844,199 @@
         ],
         "type": "object"
       },
+      "KubernetesImportCandidate": {
+        "additionalProperties": false,
+        "properties": {
+          "clusterId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "containers": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array",
+            "uniqueItems": true
+          },
+          "desiredReplicas": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "labels": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "namespace": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "readyReplicas": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "relatedResources": {
+            "items": {
+              "$ref": "#/components/schemas/KubernetesRelatedResource"
+            },
+            "type": "array"
+          },
+          "workloadKind": {
+            "enum": [
+              "Deployment",
+              "StatefulSet",
+              "DaemonSet"
+            ],
+            "type": "string"
+          },
+          "workloadName": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "clusterId",
+          "namespace",
+          "workloadKind",
+          "workloadName",
+          "desiredReplicas",
+          "readyReplicas",
+          "relatedResources"
+        ],
+        "type": "object"
+      },
+      "KubernetesImportCandidateListEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "items": {
+              "$ref": "#/components/schemas/KubernetesImportCandidate"
+            },
+            "type": "array"
+          },
+          "truncated": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "items",
+          "truncated"
+        ],
+        "type": "object"
+      },
+      "KubernetesImportedService": {
+        "additionalProperties": false,
+        "properties": {
+          "created": {
+            "type": "boolean"
+          },
+          "id": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "workloadKind": {
+            "enum": [
+              "Deployment",
+              "StatefulSet",
+              "DaemonSet"
+            ],
+            "type": "string"
+          },
+          "workloadName": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "key",
+          "name",
+          "workloadKind",
+          "workloadName",
+          "created"
+        ],
+        "type": "object"
+      },
+      "KubernetesImportedTarget": {
+        "additionalProperties": false,
+        "properties": {
+          "created": {
+            "type": "boolean"
+          },
+          "id": {
+            "type": "string"
+          },
+          "workloadKind": {
+            "enum": [
+              "Deployment",
+              "StatefulSet",
+              "DaemonSet"
+            ],
+            "type": "string"
+          },
+          "workloadName": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "workloadKind",
+          "workloadName",
+          "created"
+        ],
+        "type": "object"
+      },
+      "KubernetesImportEntityRef": {
+        "additionalProperties": false,
+        "properties": {
+          "created": {
+            "type": "boolean"
+          },
+          "id": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "key",
+          "name",
+          "created"
+        ],
+        "type": "object"
+      },
+      "KubernetesRelatedResource": {
+        "additionalProperties": false,
+        "properties": {
+          "kind": {
+            "enum": [
+              "Service",
+              "Ingress",
+              "HorizontalPodAutoscaler"
+            ],
+            "type": "string"
+          },
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "kind",
+          "name"
+        ],
+        "type": "object"
+      },
       "KubernetesResourceAction": {
         "enum": [
           "list",
@@ -14811,6 +15776,142 @@
         ],
         "type": "object"
       },
+      "KubernetesServiceImportRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "applicationKey": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "applicationName": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "clusterId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "environmentKey": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "environmentName": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "namespace": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "ownershipMode": {
+            "enum": [
+              "observe_only",
+              "managed"
+            ],
+            "type": "string"
+          },
+          "workloads": {
+            "items": {
+              "$ref": "#/components/schemas/KubernetesWorkloadImportInput"
+            },
+            "maxItems": 100,
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+          }
+        },
+        "required": [
+          "clusterId",
+          "namespace",
+          "applicationKey",
+          "applicationName",
+          "environmentKey",
+          "environmentName",
+          "ownershipMode",
+          "workloads"
+        ],
+        "type": "object"
+      },
+      "KubernetesServiceImportResult": {
+        "additionalProperties": false,
+        "properties": {
+          "application": {
+            "$ref": "#/components/schemas/KubernetesImportEntityRef"
+          },
+          "applicationEnvironmentCreated": {
+            "type": "boolean"
+          },
+          "applicationEnvironmentId": {
+            "type": "string"
+          },
+          "environment": {
+            "$ref": "#/components/schemas/KubernetesImportEntityRef"
+          },
+          "ownershipMode": {
+            "enum": [
+              "observe_only",
+              "managed"
+            ],
+            "type": "string"
+          },
+          "services": {
+            "items": {
+              "$ref": "#/components/schemas/KubernetesImportedService"
+            },
+            "type": "array"
+          },
+          "targets": {
+            "items": {
+              "$ref": "#/components/schemas/KubernetesImportedTarget"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "application",
+          "environment",
+          "applicationEnvironmentId",
+          "applicationEnvironmentCreated",
+          "ownershipMode",
+          "services",
+          "targets"
+        ],
+        "type": "object"
+      },
+      "KubernetesServiceImportResultEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/KubernetesServiceImportResult"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "KubernetesWorkloadImportInput": {
+        "additionalProperties": false,
+        "properties": {
+          "workloadKind": {
+            "enum": [
+              "Deployment",
+              "StatefulSet",
+              "DaemonSet"
+            ],
+            "type": "string"
+          },
+          "workloadName": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "workloadKind",
+          "workloadName"
+        ],
+        "type": "object"
+      },
       "LLMCallLog": {
         "additionalProperties": false,
         "properties": {
@@ -19022,6 +20123,9 @@
           "minSohaVersion": {
             "type": "string"
           },
+          "package": {
+            "$ref": "#/components/schemas/PluginPackageDescriptor"
+          },
           "packageUrl": {
             "type": "string"
           },
@@ -19770,6 +20874,312 @@
         "description": "Native provider-compatible JSON. Unknown fields are preserved and responses are not wrapped in an OpenSoha envelope.",
         "type": "object"
       },
+      "ObservabilityDashboard": {
+        "additionalProperties": false,
+        "properties": {
+          "createdAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "dataSourceId": {
+            "maxLength": 200,
+            "type": "string"
+          },
+          "id": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "name": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "panels": {
+            "items": {
+              "$ref": "#/components/schemas/ObservabilityDashboardPanel"
+            },
+            "maxItems": 200,
+            "type": "array"
+          },
+          "source": {
+            "$ref": "#/components/schemas/ObservabilityDashboardSource"
+          },
+          "sourceSchemaVersion": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "tags": {
+            "items": {
+              "maxLength": 100,
+              "minLength": 1,
+              "type": "string"
+            },
+            "maxItems": 50,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "updatedAt": {
+            "format": "date-time",
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "source",
+          "tags",
+          "panels",
+          "createdAt",
+          "updatedAt"
+        ],
+        "type": "object"
+      },
+      "ObservabilityDashboardEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/ObservabilityDashboard"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "ObservabilityDashboardImportResult": {
+        "additionalProperties": false,
+        "properties": {
+          "dashboard": {
+            "$ref": "#/components/schemas/ObservabilityDashboard"
+          },
+          "importedPanelCount": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "skippedPanelCount": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "warnings": {
+            "items": {
+              "$ref": "#/components/schemas/ObservabilityDashboardImportWarning"
+            },
+            "maxItems": 500,
+            "type": "array"
+          }
+        },
+        "required": [
+          "dashboard",
+          "warnings",
+          "importedPanelCount",
+          "skippedPanelCount"
+        ],
+        "type": "object"
+      },
+      "ObservabilityDashboardImportResultEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/ObservabilityDashboardImportResult"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "ObservabilityDashboardImportWarning": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "enum": [
+              "unsupported_panel_type",
+              "skipped_target",
+              "unsupported_variable",
+              "datasource_rebound",
+              "unsupported_feature"
+            ],
+            "type": "string"
+          },
+          "message": {
+            "maxLength": 500,
+            "minLength": 1,
+            "type": "string"
+          },
+          "panelId": {
+            "maxLength": 128,
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "ObservabilityDashboardListEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "items": {
+              "$ref": "#/components/schemas/ObservabilityDashboard"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "items"
+        ],
+        "type": "object"
+      },
+      "ObservabilityDashboardPanel": {
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "layout": {
+            "$ref": "#/components/schemas/ObservabilityDashboardPanelLayout"
+          },
+          "markdown": {
+            "maxLength": 32768,
+            "type": "string"
+          },
+          "queryable": {
+            "type": "boolean"
+          },
+          "targets": {
+            "items": {
+              "$ref": "#/components/schemas/ObservabilityDashboardTarget"
+            },
+            "maxItems": 8,
+            "type": "array"
+          },
+          "title": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": {
+            "$ref": "#/components/schemas/ObservabilityDashboardPanelType"
+          }
+        },
+        "required": [
+          "id",
+          "title",
+          "type",
+          "layout",
+          "targets",
+          "queryable"
+        ],
+        "type": "object"
+      },
+      "ObservabilityDashboardPanelLayout": {
+        "additionalProperties": false,
+        "properties": {
+          "h": {
+            "maximum": 100,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "w": {
+            "maximum": 24,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "x": {
+            "maximum": 23,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "y": {
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "x",
+          "y",
+          "w",
+          "h"
+        ],
+        "type": "object"
+      },
+      "ObservabilityDashboardPanelQueryInput": {
+        "additionalProperties": false,
+        "properties": {
+          "stepSeconds": {
+            "default": 60,
+            "maximum": 3600,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "timeFrom": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "timeTo": {
+            "format": "date-time",
+            "type": "string"
+          }
+        },
+        "required": [
+          "timeFrom",
+          "timeTo"
+        ],
+        "type": "object"
+      },
+      "ObservabilityDashboardPanelType": {
+        "enum": [
+          "timeseries",
+          "stat",
+          "text",
+          "row"
+        ],
+        "type": "string",
+        "x-enum-varnames": [
+          "ObservabilityDashboardPanelTypeTimeseries",
+          "ObservabilityDashboardPanelTypeStat",
+          "ObservabilityDashboardPanelTypeText",
+          "ObservabilityDashboardPanelTypeRow"
+        ]
+      },
+      "ObservabilityDashboardSource": {
+        "enum": [
+          "grafana"
+        ],
+        "type": "string",
+        "x-enum-varnames": [
+          "ObservabilityDashboardSourceGrafana"
+        ]
+      },
+      "ObservabilityDashboardTarget": {
+        "additionalProperties": false,
+        "properties": {
+          "expression": {
+            "maxLength": 8192,
+            "minLength": 1,
+            "type": "string"
+          },
+          "legend": {
+            "maxLength": 256,
+            "type": "string"
+          },
+          "refId": {
+            "maxLength": 16,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "refId",
+          "expression"
+        ],
+        "type": "object"
+      },
       "ObservabilityDataSource": {
         "additionalProperties": false,
         "properties": {
@@ -19987,6 +21397,28 @@
           "ObservabilityDataSourceValidationStatusFailed"
         ]
       },
+      "ObservabilityGrafanaDashboardImportInput": {
+        "additionalProperties": false,
+        "properties": {
+          "dataSourceId": {
+            "description": "Enabled Soha Prometheus data source used by every imported queryable panel.",
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "json": {
+            "description": "Grafana Classic dashboard JSON or a V1 resource whose spec contains the Classic dashboard model.",
+            "maxLength": 2097152,
+            "minLength": 2,
+            "type": "string"
+          }
+        },
+        "required": [
+          "json",
+          "dataSourceId"
+        ],
+        "type": "object"
+      },
       "ObservabilityLogDataSourceConfig": {
         "additionalProperties": false,
         "properties": {
@@ -20140,6 +21572,41 @@
         },
         "type": "object"
       },
+      "ObservabilityMetricDataSource": {
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "name": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "name"
+        ],
+        "type": "object"
+      },
+      "ObservabilityMetricDataSourceListEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "items": {
+              "$ref": "#/components/schemas/ObservabilityMetricDataSource"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "items"
+        ],
+        "type": "object"
+      },
       "ObservabilityMetricKey": {
         "enum": [
           "cpu_usage",
@@ -21613,6 +23080,64 @@
         },
         "type": "object"
       },
+      "PluginArtifactRecord": {
+        "additionalProperties": false,
+        "properties": {
+          "active": {
+            "type": "boolean"
+          },
+          "checksumStatus": {
+            "enum": [
+              "verified",
+              "mismatch"
+            ],
+            "type": "string"
+          },
+          "installedAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "provenanceStatus": {
+            "enum": [
+              "verified",
+              "not_provided",
+              "invalid"
+            ],
+            "type": "string"
+          },
+          "sha256": {
+            "pattern": "^sha256:[a-f0-9]{64}$",
+            "type": "string"
+          },
+          "signatureStatus": {
+            "enum": [
+              "verified",
+              "not_provided",
+              "untrusted",
+              "invalid"
+            ],
+            "type": "string"
+          },
+          "sizeBytes": {
+            "format": "int64",
+            "minimum": 1,
+            "type": "integer"
+          },
+          "version": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "version",
+          "sha256",
+          "sizeBytes",
+          "checksumStatus",
+          "signatureStatus",
+          "provenanceStatus",
+          "active"
+        ],
+        "type": "object"
+      },
       "PluginAssetSnapshot": {
         "additionalProperties": false,
         "properties": {
@@ -22080,6 +23605,9 @@
           "marketplaceUrl": {
             "type": "string"
           },
+          "package": {
+            "$ref": "#/components/schemas/PluginPackageDescriptor"
+          },
           "pluginId": {
             "type": "string"
           },
@@ -22122,6 +23650,9 @@
           "capabilities": {
             "$ref": "#/components/schemas/PluginCapabilityRequest"
           },
+          "companionPack": {
+            "$ref": "#/components/schemas/CompanionPackManifest"
+          },
           "compatibility": {
             "$ref": "#/components/schemas/PluginCompatibility"
           },
@@ -22186,7 +23717,8 @@
               "metric-extension",
               "notification-channel",
               "identity-template",
-              "ui-extension"
+              "ui-extension",
+              "companion-pack"
             ],
             "type": "string"
           },
@@ -22320,6 +23852,62 @@
         ],
         "type": "object"
       },
+      "PluginPackageDescriptor": {
+        "additionalProperties": false,
+        "properties": {
+          "contentType": {
+            "enum": [
+              "application/zip",
+              "application/gzip",
+              "application/x-tar"
+            ],
+            "type": "string"
+          },
+          "provenanceUrl": {
+            "format": "uri",
+            "type": "string"
+          },
+          "sbomUrl": {
+            "format": "uri",
+            "type": "string"
+          },
+          "sha256": {
+            "pattern": "^sha256:[a-f0-9]{64}$",
+            "type": "string"
+          },
+          "signature": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "signatureAlgorithm": {
+            "enum": [
+              "ed25519"
+            ],
+            "type": "string"
+          },
+          "signingKeyId": {
+            "pattern": "^[a-z][a-z0-9._-]*$",
+            "type": "string"
+          },
+          "sizeBytes": {
+            "format": "int64",
+            "maximum": 268435456,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "url": {
+            "format": "uri",
+            "type": "string"
+          }
+        },
+        "required": [
+          "url",
+          "contentType",
+          "sizeBytes",
+          "sha256"
+        ],
+        "type": "object"
+      },
       "PluginPermissionRequest": {
         "additionalProperties": false,
         "properties": {
@@ -22338,6 +23926,58 @@
         },
         "type": "object"
       },
+      "PluginProvenanceStatement": {
+        "additionalProperties": false,
+        "description": "The Ed25519 signature covers UTF-8 lines subjectSha256, builderId, sourceUri, sourceCommit, and builtAt in that order, joined with LF and without a trailing LF.",
+        "properties": {
+          "builderId": {
+            "maxLength": 512,
+            "minLength": 1,
+            "type": "string"
+          },
+          "builtAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "signature": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "signatureAlgorithm": {
+            "enum": [
+              "ed25519"
+            ],
+            "type": "string"
+          },
+          "signingKeyId": {
+            "pattern": "^[a-z][a-z0-9._-]*$",
+            "type": "string"
+          },
+          "sourceCommit": {
+            "pattern": "^[A-Fa-f0-9]{7,64}$",
+            "type": "string"
+          },
+          "sourceUri": {
+            "format": "uri",
+            "type": "string"
+          },
+          "subjectSha256": {
+            "pattern": "^sha256:[a-f0-9]{64}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "subjectSha256",
+          "builderId",
+          "sourceUri",
+          "sourceCommit",
+          "builtAt",
+          "signingKeyId",
+          "signatureAlgorithm",
+          "signature"
+        ],
+        "type": "object"
+      },
       "PluginResourceExtensions": {
         "additionalProperties": false,
         "properties": {
@@ -22668,6 +24308,140 @@
         },
         "type": "object"
       },
+      "RegistryConnection": {
+        "additionalProperties": false,
+        "properties": {
+          "createdAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "endpoint": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "id": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "insecure": {
+            "type": "boolean"
+          },
+          "metadata": {
+            "$ref": "#/components/schemas/RegistryConnectionMetadata"
+          },
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "namespace": {
+            "type": "string"
+          },
+          "registryType": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "updatedAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "username": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "registryType",
+          "endpoint",
+          "insecure",
+          "metadata",
+          "createdAt",
+          "updatedAt"
+        ],
+        "type": "object"
+      },
+      "RegistryConnectionEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/RegistryConnection"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "RegistryConnectionInput": {
+        "additionalProperties": false,
+        "properties": {
+          "endpoint": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "insecure": {
+            "type": "boolean"
+          },
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "namespace": {
+            "type": "string"
+          },
+          "registryType": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "secret": {
+            "type": "string",
+            "writeOnly": true
+          },
+          "username": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "registryType",
+          "endpoint"
+        ],
+        "type": "object"
+      },
+      "RegistryConnectionListEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "items": {
+              "$ref": "#/components/schemas/RegistryConnection"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "items"
+        ],
+        "type": "object"
+      },
+      "RegistryConnectionMetadata": {
+        "additionalProperties": false,
+        "properties": {
+          "secretConfigured": {
+            "type": "boolean"
+          },
+          "secretStorage": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "secretConfigured",
+          "secretStorage"
+        ],
+        "type": "object"
+      },
       "ReleaseBundle": {
         "additionalProperties": false,
         "properties": {
@@ -25347,6 +27121,287 @@
         ],
         "type": "object"
       },
+      "SoftwarePackage": {
+        "additionalProperties": false,
+        "properties": {
+          "arch": {
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$",
+            "type": "string"
+          },
+          "category": {
+            "maxLength": 50,
+            "type": "string"
+          },
+          "createdAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "description": {
+            "maxLength": 500,
+            "type": "string"
+          },
+          "downloadPath": {
+            "pattern": "^/api/v1/software/packages/[^/]+/download$",
+            "type": "string"
+          },
+          "fileName": {
+            "maxLength": 255,
+            "minLength": 1,
+            "type": "string"
+          },
+          "id": {
+            "maxLength": 128,
+            "minLength": 1,
+            "type": "string"
+          },
+          "name": {
+            "maxLength": 100,
+            "minLength": 1,
+            "type": "string"
+          },
+          "platform": {
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$",
+            "type": "string"
+          },
+          "publisher": {
+            "maxLength": 100,
+            "minLength": 1,
+            "type": "string"
+          },
+          "sha256": {
+            "pattern": "^[0-9a-f]{64}$",
+            "type": "string"
+          },
+          "sizeBytes": {
+            "format": "int64",
+            "maximum": 4294967296,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "softwareId": {
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$",
+            "type": "string"
+          },
+          "updatedAt": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "version": {
+            "maxLength": 64,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "softwareId",
+          "name",
+          "publisher",
+          "version",
+          "platform",
+          "arch",
+          "fileName",
+          "sizeBytes",
+          "sha256",
+          "downloadPath",
+          "createdAt",
+          "updatedAt"
+        ],
+        "type": "object"
+      },
+      "SoftwarePackageEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/SoftwarePackage"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
+      "SoftwarePackageListEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "items": {
+              "$ref": "#/components/schemas/SoftwarePackage"
+            },
+            "type": "array"
+          },
+          "nextCursor": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "items"
+        ],
+        "type": "object"
+      },
+      "SoftwarePackageUploadRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "arch": {
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$",
+            "type": "string"
+          },
+          "category": {
+            "maxLength": 50,
+            "type": "string"
+          },
+          "description": {
+            "maxLength": 500,
+            "type": "string"
+          },
+          "file": {
+            "format": "binary",
+            "type": "string"
+          },
+          "name": {
+            "maxLength": 100,
+            "minLength": 1,
+            "type": "string"
+          },
+          "platform": {
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$",
+            "type": "string"
+          },
+          "publisher": {
+            "maxLength": 100,
+            "minLength": 1,
+            "type": "string"
+          },
+          "softwareId": {
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$",
+            "type": "string"
+          },
+          "version": {
+            "maxLength": 64,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "softwareId",
+          "name",
+          "publisher",
+          "version",
+          "platform",
+          "arch",
+          "file"
+        ],
+        "type": "object"
+      },
+      "SoftwarePackageURLImportRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "arch": {
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$",
+            "type": "string"
+          },
+          "category": {
+            "maxLength": 50,
+            "type": "string"
+          },
+          "description": {
+            "maxLength": 500,
+            "type": "string"
+          },
+          "fileName": {
+            "maxLength": 255,
+            "minLength": 1,
+            "type": "string"
+          },
+          "name": {
+            "maxLength": 100,
+            "minLength": 1,
+            "type": "string"
+          },
+          "platform": {
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$",
+            "type": "string"
+          },
+          "publisher": {
+            "maxLength": 100,
+            "minLength": 1,
+            "type": "string"
+          },
+          "softwareId": {
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$",
+            "type": "string"
+          },
+          "url": {
+            "format": "uri",
+            "maxLength": 2048,
+            "pattern": "^https://",
+            "type": "string"
+          },
+          "version": {
+            "maxLength": 64,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "softwareId",
+          "name",
+          "publisher",
+          "version",
+          "platform",
+          "arch",
+          "url"
+        ],
+        "type": "object"
+      },
+      "SoftwareStorage": {
+        "additionalProperties": false,
+        "properties": {
+          "backend": {
+            "maxLength": 64,
+            "minLength": 1,
+            "type": "string"
+          },
+          "items": {
+            "items": {
+              "$ref": "#/components/schemas/SoftwarePackage"
+            },
+            "type": "array"
+          },
+          "nextCursor": {
+            "type": "string"
+          },
+          "objectCount": {
+            "format": "int64",
+            "minimum": 0,
+            "type": "integer"
+          },
+          "totalBytes": {
+            "format": "int64",
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "backend",
+          "objectCount",
+          "totalBytes",
+          "items"
+        ],
+        "type": "object"
+      },
+      "SoftwareStorageEnvelope": {
+        "additionalProperties": false,
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/SoftwareStorage"
+          }
+        },
+        "required": [
+          "data"
+        ],
+        "type": "object"
+      },
       "SourceBranch": {
         "additionalProperties": false,
         "properties": {
@@ -27511,6 +29566,11 @@
       }
     },
     "securitySchemes": {
+      "agentBearerAuth": {
+        "description": "Per-cluster Agent session token provisioned through the installation manifest.",
+        "scheme": "bearer",
+        "type": "http"
+      },
       "bearerAuth": {
         "bearerFormat": "JWT",
         "scheme": "bearer",
@@ -27532,7 +29592,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.6"
+    "version": "0.1.8"
   },
   "openapi": "3.1.0",
   "paths": {
@@ -27856,6 +29916,39 @@
         ]
       }
     },
+    "/agent-sessions/connect": {
+      "get": {
+        "description": "Upgrades to the soha-agent-tunnel.v1 WebSocket subprotocol. The Agent initiates this connection and carries multiplexed HTTP and stream traffic over the resulting session.\n",
+        "operationId": "connectClusterAgentSession",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClusterIDQuery"
+          }
+        ],
+        "responses": {
+          "101": {
+            "description": "WebSocket session established."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "409": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "security": [
+          {
+            "agentBearerAuth": []
+          }
+        ],
+        "tags": [
+          "Platform"
+        ]
+      }
+    },
     "/ai-gateway/approval-requests": {
       "get": {
         "operationId": "listAIGatewayApprovalRequests",
@@ -34406,6 +36499,149 @@
         ]
       }
     },
+    "/application-environments/helm-release-imports": {
+      "post": {
+        "operationId": "importHelmReleases",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/HelmReleaseImportRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HelmReleaseImportResultEnvelope"
+                }
+              }
+            },
+            "description": "Idempotent Helm release import result."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "409": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Delivery"
+        ]
+      }
+    },
+    "/application-environments/imports": {
+      "post": {
+        "operationId": "importKubernetesServices",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/KubernetesServiceImportRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/KubernetesServiceImportResultEnvelope"
+                }
+              }
+            },
+            "description": "Idempotent Kubernetes service import result."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "409": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Delivery"
+        ]
+      }
+    },
+    "/application-environments/target-candidates": {
+      "get": {
+        "operationId": "listApplicationEnvironmentTargetCandidates",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "clusterId",
+            "required": true,
+            "schema": {
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "namespace",
+            "required": true,
+            "schema": {
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "search",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": {
+              "default": 100,
+              "maximum": 200,
+              "minimum": 1,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/KubernetesImportCandidateListEnvelope"
+                }
+              }
+            },
+            "description": "Discoverable Kubernetes workloads and their related resources."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Delivery"
+        ]
+      }
+    },
     "/applications": {
       "get": {
         "operationId": "listApplications",
@@ -35365,6 +37601,43 @@
         ]
       }
     },
+    "/clusters/{clusterID}/agent-installation": {
+      "post": {
+        "operationId": "createClusterAgentInstallation",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ClusterID"
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentInstallationEnvelope"
+                }
+              }
+            },
+            "description": "Short-lived Kubernetes manifest URL and kubectl command for installing the cluster Agent."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          },
+          "409": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Platform"
+        ]
+      }
+    },
     "/clusters/{clusterID}/logs/query": {
       "post": {
         "operationId": "queryClusterLogs",
@@ -35808,6 +38081,151 @@
         ]
       }
     },
+    "/companion/interactions": {
+      "post": {
+        "operationId": "recordCompanionInteraction",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/IdempotencyKey"
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CompanionInteractionRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CompanionInteractionReceiptEnvelope"
+                }
+              }
+            },
+            "description": "Existing idempotent interaction result."
+          },
+          "201": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CompanionInteractionReceiptEnvelope"
+                }
+              }
+            },
+            "description": "Interaction applied to the companion profile."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          },
+          "409": {
+            "$ref": "#/components/responses/Error"
+          },
+          "422": {
+            "$ref": "#/components/responses/Error"
+          },
+          "503": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Companion"
+        ]
+      }
+    },
+    "/companion/profile": {
+      "get": {
+        "operationId": "getCompanionProfile",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CompanionProfileEnvelope"
+                }
+              }
+            },
+            "description": "Current principal's companion profile."
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "503": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Companion"
+        ]
+      }
+    },
+    "/companion/profile/reset": {
+      "post": {
+        "operationId": "resetCompanionProfile",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/IdempotencyKey"
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CompanionProfileResetRequest"
+              }
+            }
+          },
+          "required": false
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CompanionProfileEnvelope"
+                }
+              }
+            },
+            "description": "Companion progression reset for the selected pack."
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          },
+          "409": {
+            "$ref": "#/components/responses/Error"
+          },
+          "503": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Companion"
+        ]
+      }
+    },
     "/compute/access-sources": {
       "get": {
         "operationId": "listComputeAccessSources",
@@ -40467,6 +42885,38 @@
         ]
       }
     },
+    "/kubernetes/agent-installations/{installTicket}/manifest.yaml": {
+      "get": {
+        "operationId": "downloadKubernetesAgentInstallationManifest",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/AgentInstallTicket"
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/yaml": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Complete Kubernetes Agent installation manifest. The download URL is short-lived."
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          },
+          "410": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "security": [],
+        "tags": [
+          "Platform"
+        ]
+      }
+    },
     "/marketplace/index.json": {
       "get": {
         "operationId": "getPublicMarketplaceCatalog",
@@ -40522,6 +42972,40 @@
         ]
       }
     },
+    "/marketplace/plugins/{pluginID}/{version}/provenance.json": {
+      "get": {
+        "operationId": "getPublicMarketplacePluginProvenance",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/PluginID"
+          },
+          {
+            "in": "path",
+            "name": "version",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PluginProvenanceStatement"
+                }
+              }
+            },
+            "description": "Immutable signed provenance statement for a plugin package."
+          }
+        },
+        "security": [],
+        "tags": [
+          "Marketplace"
+        ]
+      }
+    },
     "/mcp/capabilities": {
       "get": {
         "operationId": "listMCPCapabilities",
@@ -40542,6 +43026,178 @@
         ]
       }
     },
+    "/observability/dashboards": {
+      "get": {
+        "operationId": "listObservabilityDashboards",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ObservabilityDashboardListEnvelope"
+                }
+              }
+            },
+            "description": "Dashboards visible to the current principal."
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Observability"
+        ]
+      }
+    },
+    "/observability/dashboards/{dashboardID}": {
+      "delete": {
+        "operationId": "deleteObservabilityDashboard",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/DashboardID"
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/OperationStatus"
+                }
+              }
+            },
+            "description": "Dashboard deleted."
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Observability"
+        ]
+      },
+      "get": {
+        "operationId": "getObservabilityDashboard",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/DashboardID"
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ObservabilityDashboardEnvelope"
+                }
+              }
+            },
+            "description": "Dashboard detail including normalized panels and targets."
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Observability"
+        ]
+      }
+    },
+    "/observability/dashboards/{dashboardID}/panels/{panelID}/query": {
+      "post": {
+        "operationId": "queryObservabilityDashboardPanel",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/DashboardID"
+          },
+          {
+            "$ref": "#/components/parameters/DashboardPanelID"
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ObservabilityDashboardPanelQueryInput"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ObservabilityMetricQueryEnvelope"
+                }
+              }
+            },
+            "description": "Normalized metric series for the persisted dashboard panel targets."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          },
+          "503": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Observability"
+        ]
+      }
+    },
+    "/observability/dashboards/imports": {
+      "post": {
+        "operationId": "importGrafanaDashboard",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ObservabilityGrafanaDashboardImportInput"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ObservabilityDashboardImportResultEnvelope"
+                }
+              }
+            },
+            "description": "Imported native dashboard and explicit compatibility warnings."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Observability"
+        ]
+      }
+    },
     "/observability/data-sources": {
       "get": {
         "operationId": "listObservabilityDataSources",
@@ -40677,6 +43333,29 @@
         ]
       }
     },
+    "/observability/metrics/data-sources": {
+      "get": {
+        "operationId": "listObservabilityMetricDataSources",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ObservabilityMetricDataSourceListEnvelope"
+                }
+              }
+            },
+            "description": "Enabled Prometheus data sources available for metric dashboards."
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Observability"
+        ]
+      }
+    },
     "/observability/metrics/query": {
       "post": {
         "operationId": "queryObservabilityMetrics",
@@ -40832,6 +43511,137 @@
         ]
       }
     },
+    "/plugins/{pluginID}/activate": {
+      "post": {
+        "operationId": "activateInstalledPlugin",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/PluginID"
+          },
+          {
+            "$ref": "#/components/parameters/IdempotencyKey"
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CompanionActivationRequest"
+              }
+            }
+          },
+          "required": false
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InstalledPluginEnvelope"
+                }
+              }
+            },
+            "description": "Companion pack version activated."
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          },
+          "409": {
+            "$ref": "#/components/responses/Error"
+          },
+          "422": {
+            "$ref": "#/components/responses/Error"
+          },
+          "503": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Plugins"
+        ]
+      }
+    },
+    "/plugins/{pluginID}/assets/{assetPath}": {
+      "get": {
+        "operationId": "getInstalledPluginAsset",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/PluginID"
+          },
+          {
+            "$ref": "#/components/parameters/PluginAssetPath"
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "format": "binary",
+                  "type": "string"
+                }
+              },
+              "application/octet-stream": {
+                "schema": {
+                  "format": "binary",
+                  "type": "string"
+                }
+              },
+              "image/jpeg": {
+                "schema": {
+                  "format": "binary",
+                  "type": "string"
+                }
+              },
+              "image/png": {
+                "schema": {
+                  "format": "binary",
+                  "type": "string"
+                }
+              },
+              "image/svg+xml": {
+                "schema": {
+                  "format": "binary",
+                  "type": "string"
+                }
+              },
+              "image/webp": {
+                "schema": {
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Immutable verified asset from the active companion pack.",
+            "headers": {
+              "Cache-Control": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Plugins"
+        ]
+      }
+    },
     "/plugins/{pluginID}/config": {
       "put": {
         "operationId": "configureInstalledPlugin",
@@ -40942,6 +43752,62 @@
         ]
       }
     },
+    "/plugins/{pluginID}/rollback": {
+      "post": {
+        "operationId": "rollbackInstalledPlugin",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/PluginID"
+          },
+          {
+            "$ref": "#/components/parameters/IdempotencyKey"
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CompanionRollbackRequest"
+              }
+            }
+          },
+          "required": false
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InstalledPluginEnvelope"
+                }
+              }
+            },
+            "description": "Companion pack rolled back to a retained verified version."
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          },
+          "409": {
+            "$ref": "#/components/responses/Error"
+          },
+          "422": {
+            "$ref": "#/components/responses/Error"
+          },
+          "503": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Plugins"
+        ]
+      }
+    },
     "/plugins/{pluginID}/upgrade": {
       "post": {
         "operationId": "upgradeInstalledPlugin",
@@ -41167,6 +44033,148 @@
         ]
       }
     },
+    "/registries": {
+      "get": {
+        "operationId": "listRegistryConnections",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": {
+              "maximum": 200,
+              "minimum": 1,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RegistryConnectionListEnvelope"
+                }
+              }
+            },
+            "description": "Registry connections visible to the current principal."
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Delivery"
+        ]
+      },
+      "post": {
+        "operationId": "createRegistryConnection",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RegistryConnectionInput"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RegistryConnectionEnvelope"
+                }
+              }
+            },
+            "description": "Created registry connection."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Delivery"
+        ]
+      }
+    },
+    "/registries/{connectionID}": {
+      "delete": {
+        "operationId": "deleteRegistryConnection",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/RegistryConnectionID"
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/OperationStatus"
+                }
+              }
+            },
+            "description": "Deleted registry connection."
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Delivery"
+        ]
+      },
+      "put": {
+        "operationId": "updateRegistryConnection",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/RegistryConnectionID"
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RegistryConnectionInput"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RegistryConnectionEnvelope"
+                }
+              }
+            },
+            "description": "Updated registry connection."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Delivery"
+        ]
+      }
+    },
     "/repositories": {
       "get": {
         "operationId": "listRepositories",
@@ -42139,6 +45147,271 @@
         ]
       }
     },
+    "/software/packages": {
+      "get": {
+        "operationId": "listSoftwarePackages",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "platform",
+            "required": false,
+            "schema": {
+              "maxLength": 64,
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "arch",
+            "required": false,
+            "schema": {
+              "maxLength": 64,
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "cursor",
+            "required": false,
+            "schema": {
+              "maxLength": 256,
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": {
+              "maximum": 200,
+              "minimum": 1,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SoftwarePackageListEnvelope"
+                }
+              }
+            },
+            "description": "Software packages visible to the current principal."
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Software"
+        ]
+      },
+      "post": {
+        "operationId": "uploadSoftwarePackage",
+        "requestBody": {
+          "content": {
+            "multipart/form-data": {
+              "schema": {
+                "$ref": "#/components/schemas/SoftwarePackageUploadRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SoftwarePackageEnvelope"
+                }
+              }
+            },
+            "description": "Software package uploaded and published."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "409": {
+            "$ref": "#/components/responses/Error"
+          },
+          "413": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Software"
+        ]
+      }
+    },
+    "/software/packages/{packageID}": {
+      "delete": {
+        "operationId": "deleteSoftwarePackage",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/SoftwarePackageID"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Software package deleted."
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Software"
+        ]
+      }
+    },
+    "/software/packages/{packageID}/download": {
+      "get": {
+        "operationId": "downloadSoftwarePackage",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/SoftwarePackageID"
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/octet-stream": {
+                "schema": {
+                  "format": "binary",
+                  "type": "string"
+                }
+              }
+            },
+            "description": "Software package binary."
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "404": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Software"
+        ]
+      }
+    },
+    "/software/packages/import": {
+      "post": {
+        "operationId": "importSoftwarePackage",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SoftwarePackageURLImportRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SoftwarePackageEnvelope"
+                }
+              }
+            },
+            "description": "Software package downloaded from the source URL and published."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          },
+          "409": {
+            "$ref": "#/components/responses/Error"
+          },
+          "413": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Software"
+        ]
+      }
+    },
+    "/software/storage": {
+      "get": {
+        "operationId": "getSoftwareStorage",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "cursor",
+            "required": false,
+            "schema": {
+              "maxLength": 256,
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": {
+              "maximum": 200,
+              "minimum": 1,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SoftwareStorageEnvelope"
+                }
+              }
+            },
+            "description": "Managed software storage summary and object records."
+          },
+          "400": {
+            "$ref": "#/components/responses/Error"
+          },
+          "401": {
+            "$ref": "#/components/responses/Error"
+          },
+          "403": {
+            "$ref": "#/components/responses/Error"
+          }
+        },
+        "tags": [
+          "Software"
+        ]
+      }
+    },
     "/source-connections": {
       "get": {
         "operationId": "listSourceConnections",
@@ -43010,6 +46283,9 @@
     {
       "name": "Plugins"
     },
+    {
+      "name": "Software"
+    },
     {
       "name": "Access"
     },