@alienplatform/core 1.11.1 → 1.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alienplatform/core",
-  "version": "1.11.1",
+  "version": "1.12.0",
   "type": "module",
   "exports": {
     ".": {
@@ -40,7 +40,7 @@
     "@types/node": "^24.0.15",
     "tsdown": "^0.13.0",
     "typescript": "^5.8.3",
-    "vitest": "^3.1.4",
+    "vitest": "^3.2.7",
     "@alienplatform/typescript-config": "^1.0.0"
   },
   "dependencies": {

package/src/error.ts

@@ -224,6 +224,8 @@ export class AlienError<TContext extends z.ZodTypeAny = z.ZodAny> extends Error
   public readonly httpStatusCode: number
   /** Type-safe context data specific to this error */
   public readonly context?: z.infer<TContext>
+  /** Optional human-facing remediation hint */
+  public readonly hint?: string | null
   /** Source error that caused this error (for chaining) */
   public readonly source?: AlienError<any>
 
@@ -259,6 +261,7 @@ export class AlienError<TContext extends z.ZodTypeAny = z.ZodAny> extends Error
     this.internal = options.internal
     this.httpStatusCode = options.httpStatusCode ?? 500
     this.context = options.context
+    this.hint = options.hint
 
     // Handle source construction - check if it's a valid AlienErrorOptions object
     this.source = undefined
@@ -489,6 +492,7 @@ export class AlienError<TContext extends z.ZodTypeAny = z.ZodAny> extends Error
       internal: this.internal,
       httpStatusCode: this.httpStatusCode,
       context: this.context,
+      hint: this.hint,
       source: this.source?.toOptions(),
     }
 
@@ -519,6 +523,7 @@ export class AlienError<TContext extends z.ZodTypeAny = z.ZodAny> extends Error
       internal: this.internal,
       httpStatusCode: this.httpStatusCode,
       context: this.context,
+      hint: this.hint,
       source: this.source?.toOptions(),
     }
   }
@@ -565,6 +570,7 @@ export class AlienError<TContext extends z.ZodTypeAny = z.ZodAny> extends Error
       internal: this.internal,
       httpStatusCode: this.httpStatusCode,
       context: this.context,
+      hint: this.hint,
       source: this.source?.toExternal(),
     }
   }

package/src/generated/schemas/agentStatus.json

@@ -1 +1 @@
-{"type":"object","description":"Status of a single agent in the dev server","required":["id","name","status","resources","createdAt"],"properties":{"commandsUrl":{"type":["string","null"],"description":"Commands endpoint URL for the deployment"},"createdAt":{"type":"string","description":"ISO 8601 timestamp when agent was created"},"error":{"oneOf":[{"type":"null"},{"description":"Error if this agent has failed","type":"object","required":["code","message","retryable","internal"],"properties":{"code":{"type":"string","description":"A unique identifier for the type of error.\n\nThis should be a short, machine-readable string that can be used\nby clients to programmatically handle different error types.\nExamples: \"NOT_FOUND\", \"VALIDATION_ERROR\", \"TIMEOUT\"","example":"NOT_FOUND","maxLength":128},"context":{"description":"Additional diagnostic information about the error context.\n\nThis optional field can contain structured data providing more details\nabout the error, such as validation errors, request parameters that\ncaused the issue, or other relevant context information."},"hint":{"type":["string","null"],"description":"Optional human-facing remediation hint."},"httpStatusCode":{"type":["integer","null"],"format":"int32","description":"HTTP status code for this error.\n\nUsed when converting the error to an HTTP response. If None, falls back to\nthe error type's default status code or 500.","maximum":599,"minimum":100},"internal":{"type":"boolean","description":"Indicates if this is an internal error that should not be exposed to users.\n\nWhen `true`, this error contains sensitive information or implementation\ndetails that should not be shown to end-users. Such errors should be\nlogged for debugging but replaced with generic error messages in responses."},"message":{"type":"string","description":"Human-readable error message.\n\nThis message should be clear and actionable for developers or end-users,\nproviding context about what went wrong and potentially how to fix it.","example":"Item not found.","maxLength":16384},"retryable":{"type":"boolean","description":"Indicates whether the operation that caused the error should be retried.\n\nWhen `true`, the error is transient and the operation might succeed\nif attempted again. When `false`, retrying the same operation is\nunlikely to succeed without changes.","default":false},"source":{"description":"The underlying error that caused this error, creating an error chain.\n\nThis allows for proper error propagation and debugging by maintaining\nthe full context of how an error occurred through multiple layers\nof an application."}},"x-readme-ref-name":"AlienError"}]},"id":{"type":"string","description":"Deployment ID (e.g., dep_xyz123)"},"name":{"type":"string","description":"Agent name (from --agent-name flag)"},"resources":{"type":"object","description":"Resources deployed by this agent (keyed by resource name)","additionalProperties":{"type":"object","description":"Information about a deployed resource","required":["url"],"properties":{"resourceType":{"type":["string","null"],"description":"Resource type (\"worker\" | \"container\")"},"url":{"type":"string","description":"Resource URL (e.g., http://localhost:8080)"}},"x-readme-ref-name":"DevResourceInfo"},"propertyNames":{"type":"string"}},"status":{"description":"Deployment status (running, provisioning, etc.)","type":"string","enum":["pending","preflights-failed","initial-setup","initial-setup-failed","provisioning","provisioning-failed","running","refresh-failed","update-pending","updating","update-failed","delete-pending","deleting","delete-failed","teardown-required","teardown-failed","deleted","error"],"x-readme-ref-name":"DeploymentStatus"}},"x-readme-ref-name":"AgentStatus"}
+{"type":"object","description":"Status of a single agent in the dev server","required":["id","name","status","resources","createdAt"],"properties":{"commandsUrl":{"type":["string","null"],"description":"Commands endpoint URL for the deployment"},"createdAt":{"type":"string","description":"ISO 8601 timestamp when agent was created"},"error":{"oneOf":[{"type":"null"},{"description":"Error if this agent has failed","type":"object","required":["code","message","retryable","internal"],"properties":{"code":{"type":"string","description":"A unique identifier for the type of error.\n\nThis should be a short, machine-readable string that can be used\nby clients to programmatically handle different error types.\nExamples: \"NOT_FOUND\", \"VALIDATION_ERROR\", \"TIMEOUT\"","example":"NOT_FOUND","maxLength":128},"context":{"description":"Additional diagnostic information about the error context.\n\nThis optional field can contain structured data providing more details\nabout the error, such as validation errors, request parameters that\ncaused the issue, or other relevant context information."},"hint":{"type":["string","null"],"description":"Optional human-facing remediation hint."},"httpStatusCode":{"type":["integer","null"],"format":"int32","description":"HTTP status code for this error.\n\nUsed when converting the error to an HTTP response. If None, falls back to\nthe error type's default status code or 500.","maximum":599,"minimum":100},"internal":{"type":"boolean","description":"Indicates if this is an internal error that should not be exposed to users.\n\nWhen `true`, this error contains sensitive information or implementation\ndetails that should not be shown to end-users. Such errors should be\nlogged for debugging but replaced with generic error messages in responses."},"message":{"type":"string","description":"Human-readable error message.\n\nThis message should be clear and actionable for developers or end-users,\nproviding context about what went wrong and potentially how to fix it.","example":"Item not found.","maxLength":16384},"retryable":{"type":"boolean","description":"Indicates whether the operation that caused the error should be retried.\n\nWhen `true`, the error is transient and the operation might succeed\nif attempted again. When `false`, retrying the same operation is\nunlikely to succeed without changes.","default":false},"source":{"description":"The underlying error that caused this error, creating an error chain.\n\nThis allows for proper error propagation and debugging by maintaining\nthe full context of how an error occurred through multiple layers\nof an application."}},"x-readme-ref-name":"AlienError"}]},"id":{"type":"string","description":"Deployment ID (e.g., dep_xyz123)"},"name":{"type":"string","description":"Agent name (from --agent-name flag)"},"resources":{"type":"object","description":"Resources deployed by this agent (keyed by resource name)","additionalProperties":{"type":"object","description":"Information about a deployed resource","required":["url"],"properties":{"resourceType":{"type":["string","null"],"description":"Resource type (\"worker\" | \"container\")"},"url":{"type":"string","description":"Resource URL (e.g., http://localhost:8080)"}},"x-readme-ref-name":"DevResourceInfo"},"propertyNames":{"type":"string"}},"status":{"description":"Deployment status (running, provisioning, etc.)","type":"string","enum":["pending","preflights-failed","initial-setup","initial-setup-failed","provisioning","waiting-for-machines","provisioning-failed","running","refresh-failed","update-pending","updating","update-failed","delete-pending","deleting","delete-failed","teardown-required","teardown-failed","deleted","error"],"x-readme-ref-name":"DeploymentStatus"}},"x-readme-ref-name":"AgentStatus"}

package/src/generated/schemas/deploymentStatus.json

@@ -1 +1 @@
-{"type":"string","description":"Deployment status in the deployment lifecycle.\n\nFor observe-only deployments with no release or stack state, `Running`\nmeans the Operator is attached. Connectivity comes from `lastHeartbeatAt`;\nresource health comes from inventory and resource heartbeat data.","enum":["pending","preflights-failed","initial-setup","initial-setup-failed","provisioning","provisioning-failed","running","refresh-failed","update-pending","updating","update-failed","delete-pending","deleting","delete-failed","teardown-required","teardown-failed","deleted","error"],"x-readme-ref-name":"DeploymentStatus"}
+{"type":"string","description":"Deployment status in the deployment lifecycle.\n\nFor observe-only deployments with no release or stack state, `Running`\nmeans the Operator is attached. Connectivity comes from `lastHeartbeatAt`;\nresource health comes from inventory and resource heartbeat data.","enum":["pending","preflights-failed","initial-setup","initial-setup-failed","provisioning","waiting-for-machines","provisioning-failed","running","refresh-failed","update-pending","updating","update-failed","delete-pending","deleting","delete-failed","teardown-required","teardown-failed","deleted","error"],"x-readme-ref-name":"DeploymentStatus"}

package/src/generated/schemas/devStatus.json

@@ -1 +1 @@
-{"type":"object","description":"Overall status of the dev server","required":["pid","platform","stackId","stateDir","apiUrl","startedAt","status","agents","lastUpdated"],"properties":{"agents":{"type":"object","description":"Agents being managed by this dev server (keyed by agent name)","additionalProperties":{"type":"object","description":"Status of a single agent in the dev server","required":["id","name","status","resources","createdAt"],"properties":{"commandsUrl":{"type":["string","null"],"description":"Commands endpoint URL for the deployment"},"createdAt":{"type":"string","description":"ISO 8601 timestamp when agent was created"},"error":{"oneOf":[{"type":"null"},{"description":"Error if this agent has failed","type":"object","required":["code","message","retryable","internal"],"properties":{"code":{"type":"string","description":"A unique identifier for the type of error.\n\nThis should be a short, machine-readable string that can be used\nby clients to programmatically handle different error types.\nExamples: \"NOT_FOUND\", \"VALIDATION_ERROR\", \"TIMEOUT\"","example":"NOT_FOUND","maxLength":128},"context":{"description":"Additional diagnostic information about the error context.\n\nThis optional field can contain structured data providing more details\nabout the error, such as validation errors, request parameters that\ncaused the issue, or other relevant context information."},"hint":{"type":["string","null"],"description":"Optional human-facing remediation hint."},"httpStatusCode":{"type":["integer","null"],"format":"int32","description":"HTTP status code for this error.\n\nUsed when converting the error to an HTTP response. If None, falls back to\nthe error type's default status code or 500.","maximum":599,"minimum":100},"internal":{"type":"boolean","description":"Indicates if this is an internal error that should not be exposed to users.\n\nWhen `true`, this error contains sensitive information or implementation\ndetails that should not be shown to end-users. Such errors should be\nlogged for debugging but replaced with generic error messages in responses."},"message":{"type":"string","description":"Human-readable error message.\n\nThis message should be clear and actionable for developers or end-users,\nproviding context about what went wrong and potentially how to fix it.","example":"Item not found.","maxLength":16384},"retryable":{"type":"boolean","description":"Indicates whether the operation that caused the error should be retried.\n\nWhen `true`, the error is transient and the operation might succeed\nif attempted again. When `false`, retrying the same operation is\nunlikely to succeed without changes.","default":false},"source":{"description":"The underlying error that caused this error, creating an error chain.\n\nThis allows for proper error propagation and debugging by maintaining\nthe full context of how an error occurred through multiple layers\nof an application."}},"x-readme-ref-name":"AlienError"}]},"id":{"type":"string","description":"Deployment ID (e.g., dep_xyz123)"},"name":{"type":"string","description":"Agent name (from --agent-name flag)"},"resources":{"type":"object","description":"Resources deployed by this agent (keyed by resource name)","additionalProperties":{"type":"object","description":"Information about a deployed resource","required":["url"],"properties":{"resourceType":{"type":["string","null"],"description":"Resource type (\"worker\" | \"container\")"},"url":{"type":"string","description":"Resource URL (e.g., http://localhost:8080)"}},"x-readme-ref-name":"DevResourceInfo"},"propertyNames":{"type":"string"}},"status":{"description":"Deployment status (running, provisioning, etc.)","type":"string","enum":["pending","preflights-failed","initial-setup","initial-setup-failed","provisioning","provisioning-failed","running","refresh-failed","update-pending","updating","update-failed","delete-pending","deleting","delete-failed","teardown-required","teardown-failed","deleted","error"],"x-readme-ref-name":"DeploymentStatus"}},"x-readme-ref-name":"AgentStatus"},"propertyNames":{"type":"string"}},"apiUrl":{"type":"string","description":"Dev server API URL (e.g., http://localhost:9090)"},"error":{"oneOf":[{"type":"null"},{"description":"Global error if dev server itself has an error","type":"object","required":["code","message","retryable","internal"],"properties":{"code":{"type":"string","description":"A unique identifier for the type of error.\n\nThis should be a short, machine-readable string that can be used\nby clients to programmatically handle different error types.\nExamples: \"NOT_FOUND\", \"VALIDATION_ERROR\", \"TIMEOUT\"","example":"NOT_FOUND","maxLength":128},"context":{"description":"Additional diagnostic information about the error context.\n\nThis optional field can contain structured data providing more details\nabout the error, such as validation errors, request parameters that\ncaused the issue, or other relevant context information."},"hint":{"type":["string","null"],"description":"Optional human-facing remediation hint."},"httpStatusCode":{"type":["integer","null"],"format":"int32","description":"HTTP status code for this error.\n\nUsed when converting the error to an HTTP response. If None, falls back to\nthe error type's default status code or 500.","maximum":599,"minimum":100},"internal":{"type":"boolean","description":"Indicates if this is an internal error that should not be exposed to users.\n\nWhen `true`, this error contains sensitive information or implementation\ndetails that should not be shown to end-users. Such errors should be\nlogged for debugging but replaced with generic error messages in responses."},"message":{"type":"string","description":"Human-readable error message.\n\nThis message should be clear and actionable for developers or end-users,\nproviding context about what went wrong and potentially how to fix it.","example":"Item not found.","maxLength":16384},"retryable":{"type":"boolean","description":"Indicates whether the operation that caused the error should be retried.\n\nWhen `true`, the error is transient and the operation might succeed\nif attempted again. When `false`, retrying the same operation is\nunlikely to succeed without changes.","default":false},"source":{"description":"The underlying error that caused this error, creating an error chain.\n\nThis allows for proper error propagation and debugging by maintaining\nthe full context of how an error occurred through multiple layers\nof an application."}},"x-readme-ref-name":"AlienError"}]},"lastUpdated":{"type":"string","description":"ISO 8601 timestamp of last status update"},"pid":{"type":"integer","format":"int32","description":"Dev server process ID","minimum":0},"platform":{"type":"string","description":"Platform (always \"local\" for dev server)"},"stackId":{"type":"string","description":"Stack ID (always \"dev\" for dev server)"},"startedAt":{"type":"string","description":"ISO 8601 timestamp when dev server started"},"stateDir":{"type":"string","description":"Path to state directory"},"status":{"description":"Overall dev server status","type":"string","enum":["initializing","ready","error","shuttingDown"],"x-readme-ref-name":"DevStatusState"}},"x-readme-ref-name":"DevStatus"}
+{"type":"object","description":"Overall status of the dev server","required":["pid","platform","stackId","stateDir","apiUrl","startedAt","status","agents","lastUpdated"],"properties":{"agents":{"type":"object","description":"Agents being managed by this dev server (keyed by agent name)","additionalProperties":{"type":"object","description":"Status of a single agent in the dev server","required":["id","name","status","resources","createdAt"],"properties":{"commandsUrl":{"type":["string","null"],"description":"Commands endpoint URL for the deployment"},"createdAt":{"type":"string","description":"ISO 8601 timestamp when agent was created"},"error":{"oneOf":[{"type":"null"},{"description":"Error if this agent has failed","type":"object","required":["code","message","retryable","internal"],"properties":{"code":{"type":"string","description":"A unique identifier for the type of error.\n\nThis should be a short, machine-readable string that can be used\nby clients to programmatically handle different error types.\nExamples: \"NOT_FOUND\", \"VALIDATION_ERROR\", \"TIMEOUT\"","example":"NOT_FOUND","maxLength":128},"context":{"description":"Additional diagnostic information about the error context.\n\nThis optional field can contain structured data providing more details\nabout the error, such as validation errors, request parameters that\ncaused the issue, or other relevant context information."},"hint":{"type":["string","null"],"description":"Optional human-facing remediation hint."},"httpStatusCode":{"type":["integer","null"],"format":"int32","description":"HTTP status code for this error.\n\nUsed when converting the error to an HTTP response. If None, falls back to\nthe error type's default status code or 500.","maximum":599,"minimum":100},"internal":{"type":"boolean","description":"Indicates if this is an internal error that should not be exposed to users.\n\nWhen `true`, this error contains sensitive information or implementation\ndetails that should not be shown to end-users. Such errors should be\nlogged for debugging but replaced with generic error messages in responses."},"message":{"type":"string","description":"Human-readable error message.\n\nThis message should be clear and actionable for developers or end-users,\nproviding context about what went wrong and potentially how to fix it.","example":"Item not found.","maxLength":16384},"retryable":{"type":"boolean","description":"Indicates whether the operation that caused the error should be retried.\n\nWhen `true`, the error is transient and the operation might succeed\nif attempted again. When `false`, retrying the same operation is\nunlikely to succeed without changes.","default":false},"source":{"description":"The underlying error that caused this error, creating an error chain.\n\nThis allows for proper error propagation and debugging by maintaining\nthe full context of how an error occurred through multiple layers\nof an application."}},"x-readme-ref-name":"AlienError"}]},"id":{"type":"string","description":"Deployment ID (e.g., dep_xyz123)"},"name":{"type":"string","description":"Agent name (from --agent-name flag)"},"resources":{"type":"object","description":"Resources deployed by this agent (keyed by resource name)","additionalProperties":{"type":"object","description":"Information about a deployed resource","required":["url"],"properties":{"resourceType":{"type":["string","null"],"description":"Resource type (\"worker\" | \"container\")"},"url":{"type":"string","description":"Resource URL (e.g., http://localhost:8080)"}},"x-readme-ref-name":"DevResourceInfo"},"propertyNames":{"type":"string"}},"status":{"description":"Deployment status (running, provisioning, etc.)","type":"string","enum":["pending","preflights-failed","initial-setup","initial-setup-failed","provisioning","waiting-for-machines","provisioning-failed","running","refresh-failed","update-pending","updating","update-failed","delete-pending","deleting","delete-failed","teardown-required","teardown-failed","deleted","error"],"x-readme-ref-name":"DeploymentStatus"}},"x-readme-ref-name":"AgentStatus"},"propertyNames":{"type":"string"}},"apiUrl":{"type":"string","description":"Dev server API URL (e.g., http://localhost:9090)"},"error":{"oneOf":[{"type":"null"},{"description":"Global error if dev server itself has an error","type":"object","required":["code","message","retryable","internal"],"properties":{"code":{"type":"string","description":"A unique identifier for the type of error.\n\nThis should be a short, machine-readable string that can be used\nby clients to programmatically handle different error types.\nExamples: \"NOT_FOUND\", \"VALIDATION_ERROR\", \"TIMEOUT\"","example":"NOT_FOUND","maxLength":128},"context":{"description":"Additional diagnostic information about the error context.\n\nThis optional field can contain structured data providing more details\nabout the error, such as validation errors, request parameters that\ncaused the issue, or other relevant context information."},"hint":{"type":["string","null"],"description":"Optional human-facing remediation hint."},"httpStatusCode":{"type":["integer","null"],"format":"int32","description":"HTTP status code for this error.\n\nUsed when converting the error to an HTTP response. If None, falls back to\nthe error type's default status code or 500.","maximum":599,"minimum":100},"internal":{"type":"boolean","description":"Indicates if this is an internal error that should not be exposed to users.\n\nWhen `true`, this error contains sensitive information or implementation\ndetails that should not be shown to end-users. Such errors should be\nlogged for debugging but replaced with generic error messages in responses."},"message":{"type":"string","description":"Human-readable error message.\n\nThis message should be clear and actionable for developers or end-users,\nproviding context about what went wrong and potentially how to fix it.","example":"Item not found.","maxLength":16384},"retryable":{"type":"boolean","description":"Indicates whether the operation that caused the error should be retried.\n\nWhen `true`, the error is transient and the operation might succeed\nif attempted again. When `false`, retrying the same operation is\nunlikely to succeed without changes.","default":false},"source":{"description":"The underlying error that caused this error, creating an error chain.\n\nThis allows for proper error propagation and debugging by maintaining\nthe full context of how an error occurred through multiple layers\nof an application."}},"x-readme-ref-name":"AlienError"}]},"lastUpdated":{"type":"string","description":"ISO 8601 timestamp of last status update"},"pid":{"type":"integer","format":"int32","description":"Dev server process ID","minimum":0},"platform":{"type":"string","description":"Platform (always \"local\" for dev server)"},"stackId":{"type":"string","description":"Stack ID (always \"dev\" for dev server)"},"startedAt":{"type":"string","description":"ISO 8601 timestamp when dev server started"},"stateDir":{"type":"string","description":"Path to state directory"},"status":{"description":"Overall dev server status","type":"string","enum":["initializing","ready","error","shuttingDown"],"x-readme-ref-name":"DevStatusState"}},"x-readme-ref-name":"DevStatus"}

package/src/generated/zod/deployment-status-schema.ts

@@ -8,6 +8,6 @@ import * as z from "zod";
 /**
  * @description Deployment status in the deployment lifecycle.\n\nFor observe-only deployments with no release or stack state, `Running`\nmeans the Operator is attached. Connectivity comes from `lastHeartbeatAt`;\nresource health comes from inventory and resource heartbeat data.
  */
-export const DeploymentStatusSchema = z.enum(["pending", "preflights-failed", "initial-setup", "initial-setup-failed", "provisioning", "provisioning-failed", "running", "refresh-failed", "update-pending", "updating", "update-failed", "delete-pending", "deleting", "delete-failed", "teardown-required", "teardown-failed", "deleted", "error"]).describe("Deployment status in the deployment lifecycle.\n\nFor observe-only deployments with no release or stack state, `Running`\nmeans the Operator is attached. Connectivity comes from `lastHeartbeatAt`;\nresource health comes from inventory and resource heartbeat data.")
+export const DeploymentStatusSchema = z.enum(["pending", "preflights-failed", "initial-setup", "initial-setup-failed", "provisioning", "waiting-for-machines", "provisioning-failed", "running", "refresh-failed", "update-pending", "updating", "update-failed", "delete-pending", "deleting", "delete-failed", "teardown-required", "teardown-failed", "deleted", "error"]).describe("Deployment status in the deployment lifecycle.\n\nFor observe-only deployments with no release or stack state, `Running`\nmeans the Operator is attached. Connectivity comes from `lastHeartbeatAt`;\nresource health comes from inventory and resource heartbeat data.")
 
 export type DeploymentStatus = z.infer<typeof DeploymentStatusSchema>

package/src/generated/zod/kubernetes-certificate-mode-schema.ts

@@ -11,7 +11,7 @@ import { KubernetesTlsSecretRefSchema } from "./kubernetes-tls-secret-ref-schema
  */
 export const KubernetesCertificateModeSchema = z.union([z.lazy(() => KubernetesTlsSecretRefSchema).and(z.object({
     "mode": z.enum(["tlsSecretRef"])
-    })), z.object({
+    })).describe("Namespace-scoped Kubernetes TLS Secret reference."), z.object({
     "mode": z.enum(["managedAcmImport"]),
 "region": z.string().describe("ACM region. Defaults to the deployment region when omitted.").nullish(),
 "tags": z.optional(z.object({

package/src/generated/zod/kubernetes-route-profile-schema.ts

@@ -12,8 +12,8 @@ import { KubernetesIngressRouteProfileSchema } from "./kubernetes-ingress-route-
  */
 export const KubernetesRouteProfileSchema = z.union([z.lazy(() => KubernetesIngressRouteProfileSchema).and(z.object({
     "routeApi": z.enum(["ingress"])
-    })), z.lazy(() => KubernetesGatewayRouteProfileSchema).and(z.object({
+    })).describe("Shared Ingress route profile values."), z.lazy(() => KubernetesGatewayRouteProfileSchema).and(z.object({
     "routeApi": z.enum(["gateway"])
-    }))]).describe("Kubernetes route API selected for public endpoints.")
+    })).describe("Shared Gateway API route profile values.")]).describe("Kubernetes route API selected for public endpoints.")
 
 export type KubernetesRouteProfile = z.infer<typeof KubernetesRouteProfileSchema>

package/src/generated/zod/management-config-schema.ts

@@ -13,11 +13,11 @@ import { GcpManagementConfigSchema } from "./gcp-management-config-schema.js";
  */
 export const ManagementConfigSchema = z.union([z.lazy(() => AwsManagementConfigSchema).and(z.object({
     "platform": z.enum(["aws"])
-    })), z.lazy(() => GcpManagementConfigSchema).and(z.object({
+    })).describe("AWS management configuration extracted from stack settings"), z.lazy(() => GcpManagementConfigSchema).and(z.object({
     "platform": z.enum(["gcp"])
-    })), z.lazy(() => AzureManagementConfigSchema).and(z.object({
+    })).describe("GCP management configuration extracted from stack settings"), z.lazy(() => AzureManagementConfigSchema).and(z.object({
     "platform": z.enum(["azure"])
-    })), z.object({
+    })).describe("Azure management configuration extracted from stack settings"), z.object({
     "platform": z.enum(["kubernetes"])
     })]).describe("Management configuration for different cloud platforms.\n\nPlatform-derived configuration for cross-account/cross-tenant access.\nThis is NOT user-specified - it's derived from the Manager's ServiceAccount.")
 

package/src/generated/zod/postgres-heartbeat-data-schema.ts

@@ -11,12 +11,12 @@ import { LocalPostgresHeartbeatDataSchema } from "./local-postgres-heartbeat-dat
 
 export const PostgresHeartbeatDataSchema = z.union([z.lazy(() => AuroraPostgresHeartbeatDataSchema).and(z.object({
     "backend": z.enum(["aurora"])
-    })), z.lazy(() => GcpCloudSqlPostgresHeartbeatDataSchema).and(z.object({
+    })).describe("AWS Aurora Serverless v2 backend."), z.lazy(() => GcpCloudSqlPostgresHeartbeatDataSchema).and(z.object({
     "backend": z.enum(["cloudSql"])
-    })), z.lazy(() => AzureFlexibleServerPostgresHeartbeatDataSchema).and(z.object({
+    })).describe("GCP Cloud SQL backend."), z.lazy(() => AzureFlexibleServerPostgresHeartbeatDataSchema).and(z.object({
     "backend": z.enum(["flexibleServer"])
-    })), z.lazy(() => LocalPostgresHeartbeatDataSchema).and(z.object({
+    })).describe("Azure Flexible Server backend."), z.lazy(() => LocalPostgresHeartbeatDataSchema).and(z.object({
     "backend": z.enum(["local"])
-    }))])
+    })).describe("Local embedded Postgres backend.")])
 
 export type PostgresHeartbeatData = z.infer<typeof PostgresHeartbeatDataSchema>

package/src/generated/zod/submit-response-request-schema.ts

@@ -9,6 +9,6 @@ import { CommandResponseSchema } from "./command-response-schema.js";
 /**
  * @description Request to submit a command response (from deployment)
  */
-export const SubmitResponseRequestSchema = z.lazy(() => CommandResponseSchema).describe("Request to submit a command response (from deployment)")
+export const SubmitResponseRequestSchema = z.lazy(() => CommandResponseSchema).describe("Command response from deployment").describe("Request to submit a command response (from deployment)")
 
 export type SubmitResponseRequest = z.infer<typeof SubmitResponseRequestSchema>