@objectstack/spec 3.0.8 → 3.0.9

package/dist/kernel/index.mjs

@@ -37,6 +37,222 @@ var OclifPluginConfigSchema = z.object({
   /** Topic separator character (default: space) */
   topicSeparator: z.string().optional().describe("Character separating topic and command names")
 }).describe("oclif plugin configuration section");
+var MetadataCategoryEnum = z.enum([
+  "objects",
+  "views",
+  "pages",
+  "flows",
+  "dashboards",
+  "permissions",
+  "agents",
+  "reports",
+  "actions",
+  "translations",
+  "themes",
+  "datasets",
+  "apis",
+  "triggers",
+  "workflows"
+]).describe("Metadata category within the artifact");
+var ArtifactFileEntrySchema = z.object({
+  /** Relative path within the artifact (e.g. "metadata/objects/account.object.json") */
+  path: z.string().describe("Relative file path within the artifact"),
+  /** File size in bytes */
+  size: z.number().int().nonnegative().describe("File size in bytes"),
+  /** Metadata category (if under metadata/) */
+  category: MetadataCategoryEnum.optional().describe("Metadata category this file belongs to")
+}).describe("A single file entry within the artifact");
+var ArtifactChecksumSchema = z.object({
+  /** Hash algorithm used (default: SHA256) */
+  algorithm: z.enum(["sha256", "sha384", "sha512"]).default("sha256").describe("Hash algorithm used for checksums"),
+  /** Map of relative file paths to their hash values */
+  files: z.record(z.string(), z.string().regex(/^[a-f0-9]+$/)).describe("File path to hash value mapping")
+}).describe("Checksum manifest for artifact integrity verification");
+var ArtifactSignatureSchema = z.object({
+  /** Signature algorithm */
+  algorithm: z.enum(["RSA-SHA256", "RSA-SHA384", "RSA-SHA512", "ECDSA-SHA256"]).default("RSA-SHA256").describe("Signing algorithm used"),
+  /** Public key reference (URL or fingerprint) for verification */
+  publicKeyRef: z.string().describe("Public key reference (URL or fingerprint) for signature verification"),
+  /** Base64-encoded signature value */
+  signature: z.string().describe("Base64-encoded digital signature"),
+  /** Timestamp of when the artifact was signed */
+  signedAt: z.string().datetime().optional().describe("ISO 8601 timestamp of when the artifact was signed"),
+  /** Signer identity (publisher ID or email) */
+  signedBy: z.string().optional().describe("Identity of the signer (publisher ID or email)")
+}).describe("Digital signature for artifact authenticity verification");
+var PackageArtifactSchema = z.object({
+  /** Artifact format version (for forward compatibility) */
+  formatVersion: z.string().regex(/^\d+\.\d+$/).default("1.0").describe('Artifact format version (e.g. "1.0")'),
+  /** Package ID from the manifest */
+  packageId: z.string().describe("Package identifier from manifest"),
+  /** Package version from the manifest */
+  version: z.string().describe("Package version from manifest"),
+  /** Artifact format */
+  format: z.enum(["tgz", "zip"]).default("tgz").describe("Archive format of the artifact"),
+  /** Total artifact size in bytes */
+  size: z.number().int().positive().optional().describe("Total artifact file size in bytes"),
+  /** Build timestamp */
+  builtAt: z.string().datetime().describe("ISO 8601 timestamp of when the artifact was built"),
+  /** Build tool and version that produced this artifact */
+  builtWith: z.string().optional().describe('Build tool identifier (e.g. "os-cli@3.2.0")'),
+  /** File listing within the artifact */
+  files: z.array(ArtifactFileEntrySchema).optional().describe("List of files contained in the artifact"),
+  /** Metadata categories present in the artifact */
+  metadataCategories: z.array(MetadataCategoryEnum).optional().describe("Metadata categories included in this artifact"),
+  /** Integrity checksums for all files */
+  checksums: ArtifactChecksumSchema.optional().describe("SHA256 checksums for artifact integrity verification"),
+  /** Digital signature for authenticity */
+  signature: ArtifactSignatureSchema.optional().describe("Digital signature for artifact authenticity verification")
+}).describe("Package artifact structure and metadata");
+
+// src/kernel/cli-plugin-commands.zod.ts
+var PluginBuildOptionsSchema = z.object({
+  /** Project root directory (defaults to cwd) */
+  directory: z.string().optional().describe("Project root directory (defaults to current working directory)"),
+  /** Output directory for the built artifact */
+  outDir: z.string().optional().describe("Output directory for the built artifact (defaults to ./dist)"),
+  /** Archive format */
+  format: z.enum(["tgz", "zip"]).default("tgz").describe("Archive format for the artifact"),
+  /** Whether to sign the artifact */
+  sign: z.boolean().default(false).describe("Whether to digitally sign the artifact"),
+  /** Path to the private key for signing */
+  privateKeyPath: z.string().optional().describe("Path to RSA/ECDSA private key file for signing"),
+  /** Signing algorithm */
+  signAlgorithm: z.enum(["RSA-SHA256", "RSA-SHA384", "RSA-SHA512", "ECDSA-SHA256"]).optional().describe("Signing algorithm to use"),
+  /** Checksum algorithm */
+  checksumAlgorithm: z.enum(["sha256", "sha384", "sha512"]).default("sha256").describe("Hash algorithm for file checksums"),
+  /** Whether to include seed data */
+  includeData: z.boolean().default(true).describe("Whether to include seed data in the artifact"),
+  /** Whether to include locale/translation files */
+  includeLocales: z.boolean().default(true).describe("Whether to include locale/translation files")
+}).describe("Options for the os plugin build command");
+var PluginBuildResultSchema = z.object({
+  /** Whether the build succeeded */
+  success: z.boolean().describe("Whether the build succeeded"),
+  /** Path to the generated artifact file */
+  artifactPath: z.string().optional().describe("Absolute path to the generated artifact file"),
+  /** Artifact metadata (validated against PackageArtifactSchema) */
+  artifact: PackageArtifactSchema.optional().describe("Artifact metadata"),
+  /** Total file count in the artifact */
+  fileCount: z.number().int().min(0).optional().describe("Total number of files in the artifact"),
+  /** Total artifact size in bytes */
+  size: z.number().int().min(0).optional().describe("Total artifact size in bytes"),
+  /** Build duration in milliseconds */
+  durationMs: z.number().optional().describe("Build duration in milliseconds"),
+  /** Error message if build failed */
+  errorMessage: z.string().optional().describe("Error message if build failed"),
+  /** Warnings emitted during build */
+  warnings: z.array(z.string()).optional().describe("Warnings emitted during build")
+}).describe("Result of the os plugin build command");
+var ValidationSeverityEnum = z.enum([
+  "error",
+  // Must fix — artifact is invalid
+  "warning",
+  // Should fix — may cause issues
+  "info"
+  // Informational — suggestion
+]).describe("Validation issue severity");
+var ValidationFindingSchema = z.object({
+  /** Finding severity */
+  severity: ValidationSeverityEnum.describe("Issue severity level"),
+  /** Rule or check that produced this finding */
+  rule: z.string().describe("Validation rule identifier"),
+  /** Human-readable message */
+  message: z.string().describe("Human-readable finding description"),
+  /** File path within the artifact (if applicable) */
+  path: z.string().optional().describe("Relative file path within the artifact")
+}).describe("A single validation finding");
+var PluginValidateOptionsSchema = z.object({
+  /** Path to the .tgz artifact file to validate */
+  artifactPath: z.string().describe("Path to the artifact file to validate"),
+  /** Whether to verify the digital signature */
+  verifySignature: z.boolean().default(true).describe("Whether to verify the digital signature"),
+  /** Path to the public key for signature verification */
+  publicKeyPath: z.string().optional().describe("Path to the public key for signature verification"),
+  /** Whether to verify SHA256 checksums of all files */
+  verifyChecksums: z.boolean().default(true).describe("Whether to verify checksums of all files"),
+  /** Whether to validate metadata schema compliance */
+  validateMetadata: z.boolean().default(true).describe("Whether to validate metadata against schemas"),
+  /** Target platform version for compatibility check */
+  platformVersion: z.string().optional().describe("Platform version for compatibility verification")
+}).describe("Options for the os plugin validate command");
+var PluginValidateResultSchema = z.object({
+  /** Whether the artifact is valid (no error-level findings) */
+  valid: z.boolean().describe("Whether the artifact passed validation"),
+  /** Artifact metadata extracted from the archive */
+  artifact: PackageArtifactSchema.optional().describe("Extracted artifact metadata"),
+  /** Checksum verification result */
+  checksumVerification: z.object({
+    /** Whether all checksums match */
+    passed: z.boolean().describe("Whether all checksums match"),
+    /** Checksum details */
+    checksums: ArtifactChecksumSchema.optional().describe("Verified checksums"),
+    /** Files with mismatched checksums */
+    mismatches: z.array(z.string()).optional().describe("Files with checksum mismatches")
+  }).optional().describe("Checksum verification result"),
+  /** Signature verification result */
+  signatureVerification: z.object({
+    /** Whether the signature is valid */
+    passed: z.boolean().describe("Whether the signature is valid"),
+    /** Signature details */
+    signature: ArtifactSignatureSchema.optional().describe("Signature details"),
+    /** Reason for failure */
+    failureReason: z.string().optional().describe("Signature verification failure reason")
+  }).optional().describe("Signature verification result"),
+  /** Platform compatibility result */
+  platformCompatibility: z.object({
+    /** Whether the artifact is compatible with the target platform */
+    compatible: z.boolean().describe("Whether artifact is compatible"),
+    /** Required platform version range */
+    requiredRange: z.string().optional().describe("Required platform version range"),
+    /** Target platform version checked against */
+    targetVersion: z.string().optional().describe("Target platform version")
+  }).optional().describe("Platform compatibility check result"),
+  /** All validation findings */
+  findings: z.array(ValidationFindingSchema).describe("All validation findings"),
+  /** Counts by severity */
+  summary: z.object({
+    errors: z.number().int().min(0).describe("Error count"),
+    warnings: z.number().int().min(0).describe("Warning count"),
+    infos: z.number().int().min(0).describe("Info count")
+  }).optional().describe("Finding counts by severity")
+}).describe("Result of the os plugin validate command");
+var PluginPublishOptionsSchema = z.object({
+  /** Path to the .tgz artifact file to publish */
+  artifactPath: z.string().describe("Path to the artifact file to publish"),
+  /** Marketplace API base URL */
+  registryUrl: z.string().url().optional().describe("Marketplace API base URL"),
+  /** Authentication token for the marketplace API */
+  token: z.string().optional().describe("Authentication token for marketplace API"),
+  /** Release notes for this version */
+  releaseNotes: z.string().optional().describe("Release notes for this version"),
+  /** Whether this is a pre-release */
+  preRelease: z.boolean().default(false).describe("Whether this is a pre-release version"),
+  /** Whether to skip validation before publishing */
+  skipValidation: z.boolean().default(false).describe("Whether to skip local validation before publish"),
+  /** Access level for the published package */
+  access: z.enum(["public", "restricted"]).default("public").describe("Package access level on the marketplace"),
+  /** Tags for categorization */
+  tags: z.array(z.string()).optional().describe("Tags for marketplace categorization")
+}).describe("Options for the os plugin publish command");
+var PluginPublishResultSchema = z.object({
+  /** Whether the publish succeeded */
+  success: z.boolean().describe("Whether the publish succeeded"),
+  /** Package ID that was published */
+  packageId: z.string().optional().describe("Published package identifier"),
+  /** Version that was published */
+  version: z.string().optional().describe("Published version string"),
+  /** Artifact reference in the marketplace */
+  artifactUrl: z.string().url().optional().describe("URL of the published artifact in the marketplace"),
+  /** SHA256 checksum of the uploaded artifact */
+  sha256: z.string().optional().describe("SHA256 checksum of the uploaded artifact"),
+  /** Submission ID for tracking the review process */
+  submissionId: z.string().optional().describe("Marketplace submission ID for review tracking"),
+  /** Error message if publish failed */
+  errorMessage: z.string().optional().describe("Error message if publish failed"),
+  /** Human-readable status message */
+  message: z.string().optional().describe("Human-readable status message")
+}).describe("Result of the os plugin publish command");
 var RuntimeMode = z.enum([
   "development",
   // Hot-reload, verbose logging
@@ -111,6 +327,50 @@ var KernelContextSchema = z.object({
    */
   previewMode: PreviewModeConfigSchema.optional().describe('Preview/demo mode configuration (used when mode is "preview")')
 });
+var DependencyStatusEnum = z.enum([
+  "satisfied",
+  // Already installed and version compatible
+  "needs_install",
+  // Not installed, needs to be installed
+  "needs_upgrade",
+  // Installed but version incompatible, needs upgrade
+  "conflict"
+  // Conflicts with another package's dependency
+]).describe("Resolution status for a dependency");
+var ResolvedDependencySchema = z.object({
+  /** Package identifier of the dependency */
+  packageId: z.string().describe("Dependency package identifier"),
+  /** SemVer range required by the parent package */
+  requiredRange: z.string().describe('SemVer range required (e.g. "^2.0.0")'),
+  /** Actual version resolved (if available) */
+  resolvedVersion: z.string().optional().describe("Actual version resolved from registry"),
+  /** Currently installed version (if any) */
+  installedVersion: z.string().optional().describe("Currently installed version"),
+  /** Resolution status */
+  status: DependencyStatusEnum.describe("Resolution status"),
+  /** Conflict details (when status is "conflict") */
+  conflictReason: z.string().optional().describe("Explanation of the conflict")
+}).describe("Resolution result for a single dependency");
+var RequiredActionSchema = z.object({
+  /** Type of action required */
+  type: z.enum(["install", "upgrade", "confirm_conflict"]).describe("Type of action required"),
+  /** Target package identifier */
+  packageId: z.string().describe("Target package identifier"),
+  /** Human-readable description of the action */
+  description: z.string().describe("Human-readable action description")
+}).describe("Action required before installation can proceed");
+var DependencyResolutionResultSchema = z.object({
+  /** All dependencies and their resolution results */
+  dependencies: z.array(ResolvedDependencySchema).describe("Resolution result for each dependency"),
+  /** Whether installation can proceed without conflicts */
+  canProceed: z.boolean().describe("Whether installation can proceed"),
+  /** Actions that require user confirmation or system execution */
+  requiredActions: z.array(RequiredActionSchema).describe("Actions required before proceeding"),
+  /** Topologically sorted package IDs for installation order */
+  installOrder: z.array(z.string()).describe("Topologically sorted package IDs for installation"),
+  /** Detected circular dependency chains */
+  circularDependencies: z.array(z.array(z.string())).optional().describe('Circular dependency chains detected (e.g. [["A", "B", "A"]])')
+}).describe("Complete dependency resolution result");
 var DevServiceOverrideSchema = z.object({
   /** Service identifier (e.g. 'auth', 'eventBus', 'fileStorage') */
   service: z.string().min(1).describe("Target service identifier"),
@@ -1611,12 +1871,22 @@ var PluginContextSchema = z.object({
     register: z.function().describe("Register a driver")
   }).passthrough().describe("Driver Registry")
 });
+var UpgradeContextSchema = z.object({
+  /** Version before upgrade */
+  previousVersion: z.string().describe("Version before upgrade"),
+  /** Version after upgrade */
+  newVersion: z.string().describe("Version after upgrade"),
+  /** Whether this is a major version bump */
+  isMajorUpgrade: z.boolean().describe("Whether this is a major version bump"),
+  /** Metadata snapshot before upgrade (for migration logic) */
+  previousMetadata: z.record(z.string(), z.unknown()).optional().describe("Metadata snapshot before upgrade")
+}).describe("Version migration context for onUpgrade hook");
 var PluginLifecycleSchema = z.object({
   onInstall: z.function().optional().describe("Called when plugin is installed"),
   onEnable: z.function().optional().describe("Called when plugin is enabled"),
   onDisable: z.function().optional().describe("Called when plugin is disabled"),
   onUninstall: z.function().optional().describe("Called when plugin is uninstalled"),
-  onUpgrade: z.function().optional().describe("Called when plugin is upgraded")
+  onUpgrade: z.function().optional().describe("Called when plugin is upgraded. Receives UpgradeContext with previousVersion, newVersion, and isMajorUpgrade")
 });
 var CORE_PLUGIN_TYPES = [
   "ui",
@@ -1974,7 +2244,22 @@ var ManifestSchema = z.object({
    * Configures how the plugin is loaded, initialized, and managed at runtime.
    * Includes strategies for lazy loading, code splitting, caching, and hot reload.
    */
-  loading: PluginLoadingConfigSchema.optional().describe("Plugin loading and runtime behavior configuration")
+  loading: PluginLoadingConfigSchema.optional().describe("Plugin loading and runtime behavior configuration"),
+  /**
+   * Platform Compatibility Requirements.
+   * Specifies the minimum ObjectStack platform version required to run this package.
+   * Used at install time to prevent incompatible packages from being installed.
+   *
+   * @example
+   * ```yaml
+   * engine:
+   *   objectstack: ">=3.0.0"
+   * ```
+   */
+  engine: z.object({
+    /** ObjectStack platform version requirement (SemVer range) */
+    objectstack: z.string().regex(/^[><=~^]*\d+\.\d+\.\d+/).describe('ObjectStack platform version requirement (SemVer range, e.g. ">=3.0.0")')
+  }).optional().describe("Platform compatibility requirements")
 });
 var CustomizationOriginSchema = z.enum([
   "package",
@@ -2827,29 +3112,29 @@ var PackageStatusEnum = z.enum([
   // Removal in progress
   "error"
   // Installation or runtime error
-]);
+]).describe("Package installation status");
 var InstalledPackageSchema = z.object({
   /** 
    * The full package manifest (source of truth for package definition).
    */
-  manifest: ManifestSchema,
+  manifest: ManifestSchema.describe("Full package manifest"),
   /**
    * Current lifecycle status.
    */
-  status: PackageStatusEnum.default("installed"),
+  status: PackageStatusEnum.default("installed").describe("Package state: installed, disabled, installing, upgrading, uninstalling, or error"),
   /**
    * Whether the package is currently enabled (active).
    * When disabled, the package's metadata is not loaded into the registry.
    */
-  enabled: z.boolean().default(true),
+  enabled: z.boolean().default(true).describe("Whether the package is currently enabled"),
   /**
    * ISO 8601 timestamp of when the package was installed.
    */
-  installedAt: z.string().datetime().optional(),
+  installedAt: z.string().datetime().optional().describe("Installation timestamp"),
   /**
    * ISO 8601 timestamp of last update.
    */
-  updatedAt: z.string().datetime().optional(),
+  updatedAt: z.string().datetime().optional().describe("Last update timestamp"),
   /**
    * The currently installed version string.
    * Mirrors manifest.version for quick access without parsing the full manifest.
@@ -2863,73 +3148,124 @@ var InstalledPackageSchema = z.object({
   /**
    * ISO 8601 timestamp of when the package was last enabled/disabled.
    */
-  statusChangedAt: z.string().datetime().optional(),
+  statusChangedAt: z.string().datetime().optional().describe("Status change timestamp"),
   /**
    * Error message if status is 'error'.
    */
-  errorMessage: z.string().optional(),
+  errorMessage: z.string().optional().describe("Error message when status is error"),
   /**
    * Configuration values set by the user for this package.
    * Keys correspond to the package's `configuration.properties`.
    */
-  settings: z.record(z.string(), z.unknown()).optional()
-});
+  settings: z.record(z.string(), z.unknown()).optional().describe("User-provided configuration settings"),
+  /**
+   * Upgrade history for this package.
+   * Records each version migration with status and optional log.
+   */
+  upgradeHistory: z.array(z.object({
+    /** Previous version before upgrade */
+    fromVersion: z.string().describe("Version before upgrade"),
+    /** New version after upgrade */
+    toVersion: z.string().describe("Version after upgrade"),
+    /** Timestamp of the upgrade */
+    upgradedAt: z.string().datetime().describe("Upgrade timestamp"),
+    /** Outcome of the upgrade */
+    status: z.enum(["success", "failed", "rolled_back"]).describe("Upgrade outcome"),
+    /** Migration log entries */
+    migrationLog: z.array(z.string()).optional().describe("Migration step logs")
+  })).optional().describe("Version upgrade history"),
+  /**
+   * Namespaces registered by this package.
+   * Tracks which namespace prefixes are occupied by this package.
+   */
+  registeredNamespaces: z.array(z.string()).optional().describe("Namespace prefixes registered by this package")
+}).describe("Installed package with runtime lifecycle state");
+var NamespaceRegistryEntrySchema = z.object({
+  /** Namespace prefix */
+  namespace: z.string().describe("Namespace prefix"),
+  /** Package that owns this namespace */
+  packageId: z.string().describe("Owning package ID"),
+  /** Registration timestamp */
+  registeredAt: z.string().datetime().describe("Registration timestamp"),
+  /** Namespace status */
+  status: z.enum(["active", "disabled", "reserved"]).describe("Namespace status")
+}).describe("Namespace ownership entry in the registry");
+var NamespaceConflictErrorSchema = z.object({
+  /** Error type discriminator */
+  type: z.literal("namespace_conflict").describe("Error type"),
+  /** Namespace that was requested */
+  requestedNamespace: z.string().describe("Requested namespace"),
+  /** ID of the package that already owns the namespace */
+  conflictingPackageId: z.string().describe("Conflicting package ID"),
+  /** Name of the conflicting package */
+  conflictingPackageName: z.string().describe("Conflicting package display name"),
+  /** Suggested alternative namespace */
+  suggestion: z.string().optional().describe("Suggested alternative namespace")
+}).describe("Namespace collision error during installation");
 var ListPackagesRequestSchema = z.object({
   /** Filter by status */
-  status: PackageStatusEnum.optional(),
+  status: PackageStatusEnum.optional().describe("Filter by package status"),
   /** Filter by package type */
-  type: ManifestSchema.shape.type.optional(),
+  type: ManifestSchema.shape.type.optional().describe("Filter by package type"),
   /** Filter by enabled state */
-  enabled: z.boolean().optional()
-});
+  enabled: z.boolean().optional().describe("Filter by enabled state")
+}).describe("List packages request");
 var ListPackagesResponseSchema = z.object({
-  packages: z.array(InstalledPackageSchema),
-  total: z.number()
-});
+  packages: z.array(InstalledPackageSchema).describe("List of installed packages"),
+  total: z.number().describe("Total package count")
+}).describe("List packages response");
 var GetPackageRequestSchema = z.object({
   /** Package ID (reverse domain identifier from manifest) */
-  id: z.string()
-});
+  id: z.string().describe("Package identifier")
+}).describe("Get package request");
 var GetPackageResponseSchema = z.object({
-  package: InstalledPackageSchema
-});
+  package: InstalledPackageSchema.describe("Package details")
+}).describe("Get package response");
 var InstallPackageRequestSchema = z.object({
   /** The package manifest to install */
-  manifest: ManifestSchema,
+  manifest: ManifestSchema.describe("Package manifest to install"),
   /** Optional: user-provided settings at install time */
-  settings: z.record(z.string(), z.unknown()).optional(),
+  settings: z.record(z.string(), z.unknown()).optional().describe("User-provided settings at install time"),
   /** Whether to enable immediately after install (default: true) */
-  enableOnInstall: z.boolean().default(true)
-});
+  enableOnInstall: z.boolean().default(true).describe("Whether to enable immediately after install"),
+  /**
+   * Current platform version for compatibility checking.
+   * When provided, the system compares this against the package's
+   * `engine.objectstack` requirement to verify compatibility.
+   */
+  platformVersion: z.string().optional().describe("Current platform version for compatibility verification")
+}).describe("Install package request");
 var InstallPackageResponseSchema = z.object({
-  package: InstalledPackageSchema,
-  message: z.string().optional()
-});
+  package: InstalledPackageSchema.describe("Installed package details"),
+  message: z.string().optional().describe("Installation status message"),
+  /** Dependency resolution result (when dependencies were analyzed) */
+  dependencyResolution: DependencyResolutionResultSchema.optional().describe("Dependency resolution result from install analysis")
+}).describe("Install package response");
 var UninstallPackageRequestSchema = z.object({
   /** Package ID to uninstall */
-  id: z.string()
-});
+  id: z.string().describe("Package ID to uninstall")
+}).describe("Uninstall package request");
 var UninstallPackageResponseSchema = z.object({
-  id: z.string(),
-  success: z.boolean(),
-  message: z.string().optional()
-});
+  id: z.string().describe("Uninstalled package ID"),
+  success: z.boolean().describe("Whether uninstall succeeded"),
+  message: z.string().optional().describe("Uninstall status message")
+}).describe("Uninstall package response");
 var EnablePackageRequestSchema = z.object({
   /** Package ID to enable */
-  id: z.string()
-});
+  id: z.string().describe("Package ID to enable")
+}).describe("Enable package request");
 var EnablePackageResponseSchema = z.object({
-  package: InstalledPackageSchema,
-  message: z.string().optional()
-});
+  package: InstalledPackageSchema.describe("Enabled package details"),
+  message: z.string().optional().describe("Enable status message")
+}).describe("Enable package response");
 var DisablePackageRequestSchema = z.object({
   /** Package ID to disable */
-  id: z.string()
-});
+  id: z.string().describe("Package ID to disable")
+}).describe("Disable package request");
 var DisablePackageResponseSchema = z.object({
-  package: InstalledPackageSchema,
-  message: z.string().optional()
-});
+  package: InstalledPackageSchema.describe("Disabled package details"),
+  message: z.string().optional().describe("Disable status message")
+}).describe("Disable package response");
 var MetadataChangeTypeSchema = z.enum([
   "added",
   // New metadata item added in new version
@@ -2939,21 +3275,21 @@ var MetadataChangeTypeSchema = z.enum([
   // Metadata item removed in new version
   "renamed"
   // Metadata item renamed
-]);
+]).describe("Type of metadata change between package versions");
 var MetadataDiffItemSchema = z.object({
   /** Metadata type (e.g. "object", "view", "flow") */
   type: z.string().describe("Metadata type"),
   /** Metadata name */
   name: z.string().describe("Metadata name"),
   /** Type of change */
-  changeType: MetadataChangeTypeSchema,
+  changeType: MetadataChangeTypeSchema.describe("Category of metadata modification (added, modified, removed, or renamed)"),
   /** Whether this change has potential conflicts with customizations */
   hasConflict: z.boolean().default(false).describe("Whether this change may conflict with customizations"),
   /** Human-readable summary of the change */
   summary: z.string().optional().describe("Human-readable change summary"),
   /** Previous name (for renames) */
   previousName: z.string().optional().describe("Previous name if renamed")
-});
+}).describe("Single metadata change between package versions");
 var UpgradeImpactLevelSchema = z.enum([
   "none",
   // No impact, seamless upgrade
@@ -2965,7 +3301,7 @@ var UpgradeImpactLevelSchema = z.enum([
   // Significant changes, user review recommended
   "critical"
   // Breaking changes, manual intervention required
-]);
+]).describe("Severity of upgrade impact");
 var UpgradePlanSchema = z.object({
   /** Package being upgraded */
   packageId: z.string().describe("Package identifier"),
@@ -2974,7 +3310,7 @@ var UpgradePlanSchema = z.object({
   /** Target version to upgrade to */
   toVersion: z.string().describe("Target upgrade version"),
   /** Overall impact level */
-  impactLevel: UpgradeImpactLevelSchema,
+  impactLevel: UpgradeImpactLevelSchema.describe("Severity assessment from none (seamless) to critical (breaking changes)"),
   /** List of all metadata changes between versions */
   changes: z.array(MetadataDiffItemSchema).describe("All metadata changes"),
   /** Number of customer customizations that may be affected */
@@ -2993,7 +3329,7 @@ var UpgradePlanSchema = z.object({
   estimatedDuration: z.number().int().min(0).optional().describe("Estimated upgrade duration in seconds"),
   /** Human-readable summary */
   summary: z.string().optional().describe("Human-readable upgrade summary")
-});
+}).describe("Upgrade analysis plan generated before execution");
 var UpgradeSnapshotSchema = z.object({
   /** Snapshot ID (UUID) */
   id: z.string().describe("Snapshot identifier"),
@@ -3006,7 +3342,7 @@ var UpgradeSnapshotSchema = z.object({
   /** Tenant ID */
   tenantId: z.string().optional().describe("Tenant identifier"),
   /** Complete manifest of the old package version */
-  previousManifest: ManifestSchema,
+  previousManifest: ManifestSchema.describe("Complete manifest of the previous package version"),
   /**
    * Snapshot of all metadata records owned by this package.
    * Stored as array of { type, name, metadata } tuples.
@@ -3024,7 +3360,7 @@ var UpgradeSnapshotSchema = z.object({
   createdAt: z.string().datetime().describe("Snapshot creation timestamp"),
   /** Expiry time for snapshot cleanup */
   expiresAt: z.string().datetime().optional().describe("Snapshot expiry timestamp")
-});
+}).describe("Pre-upgrade state snapshot for rollback capability");
 var UpgradePackageRequestSchema = z.object({
   /** Package ID to upgrade */
   packageId: z.string().describe("Package ID to upgrade"),
@@ -3044,7 +3380,7 @@ var UpgradePackageRequestSchema = z.object({
   dryRun: z.boolean().default(false).describe("Preview upgrade without making changes"),
   /** Whether to skip pre-upgrade validation */
   skipValidation: z.boolean().default(false).describe("Skip pre-upgrade compatibility checks")
-});
+}).describe("Upgrade package request");
 var UpgradePhaseSchema = z.enum([
   "pending",
   // Upgrade requested but not started
@@ -3066,12 +3402,12 @@ var UpgradePhaseSchema = z.enum([
   // Rollback in progress
   "rolled-back"
   // Rollback completed
-]);
+]).describe("Current phase of the upgrade process");
 var UpgradePackageResponseSchema = z.object({
   /** Whether the upgrade was successful */
   success: z.boolean().describe("Whether the upgrade succeeded"),
   /** Current upgrade phase */
-  phase: UpgradePhaseSchema,
+  phase: UpgradePhaseSchema.describe("Current upgrade phase"),
   /** The upgrade plan that was executed */
   plan: UpgradePlanSchema.optional().describe("Upgrade plan"),
   /** Snapshot ID for rollback */
@@ -3084,10 +3420,10 @@ var UpgradePackageResponseSchema = z.object({
     customValue: z.unknown()
   })).optional().describe("Unresolved merge conflicts"),
   /** Error message (if failed) */
-  errorMessage: z.string().optional(),
+  errorMessage: z.string().optional().describe("Error message if upgrade failed"),
   /** Human-readable summary */
-  message: z.string().optional()
-});
+  message: z.string().optional().describe("Human-readable status message")
+}).describe("Upgrade package response");
 var RollbackPackageRequestSchema = z.object({
   /** Package ID to rollback */
   packageId: z.string().describe("Package ID to rollback"),
@@ -3095,15 +3431,15 @@ var RollbackPackageRequestSchema = z.object({
   snapshotId: z.string().describe("Snapshot ID to restore from"),
   /** Whether to also rollback customizations */
   rollbackCustomizations: z.boolean().default(true).describe("Whether to restore pre-upgrade customizations")
-});
+}).describe("Rollback package request");
 var RollbackPackageResponseSchema = z.object({
   /** Whether the rollback was successful */
-  success: z.boolean(),
+  success: z.boolean().describe("Whether the rollback succeeded"),
   /** Restored version */
   restoredVersion: z.string().optional().describe("Version restored to"),
   /** Message */
-  message: z.string().optional()
-});
+  message: z.string().optional().describe("Rollback status message")
+}).describe("Rollback package response");
 var PluginHealthStatusSchema = z.enum([
   "healthy",
   // Plugin is operating normally
@@ -4778,7 +5114,7 @@ var DependencyConflictSchema = z.object({
    */
   severity: z.enum(["critical", "error", "warning", "info"])
 });
-var DependencyResolutionResultSchema = z.object({
+var PluginDependencyResolutionResultSchema = z.object({
   /**
    * Resolution successful
    */
@@ -6028,6 +6364,6 @@ var ExecutionContextSchema = z.object({
   traceId: z.string().optional()
 });
 
-export { ActivationEventSchema, AdvancedPluginLifecycleConfigSchema, BreakingChangeSchema, CLICommandContributionSchema, CORE_PLUGIN_TYPES, CapabilityConformanceLevelSchema, CompatibilityLevelSchema, CompatibilityMatrixEntrySchema, CustomizationOriginSchema, CustomizationPolicySchema, DEFAULT_METADATA_TYPE_REGISTRY, DeadLetterQueueEntrySchema, DependencyConflictSchema, DependencyGraphNodeSchema, DependencyGraphSchema, DependencyResolutionResultSchema, DeprecationNoticeSchema, DevFixtureConfigSchema, DevPluginConfigSchema, DevPluginPreset, DevServiceOverrideSchema, DevToolsConfigSchema, DisablePackageRequestSchema, DisablePackageResponseSchema, DistributedStateConfigSchema, DynamicLoadRequestSchema, DynamicLoadingConfigSchema, DynamicPluginOperationSchema, DynamicPluginResultSchema, DynamicUnloadRequestSchema, EVENT_PRIORITY_VALUES, EnablePackageRequestSchema, EnablePackageResponseSchema, EventBusConfigSchema, EventHandlerSchema, EventLogEntrySchema, EventMessageQueueConfigSchema, EventMetadataSchema, EventPersistenceSchema, EventPhaseSchema, EventPriority, EventQueueConfigSchema, EventReplayConfigSchema, EventRouteSchema, EventSchema, EventSourcingConfigSchema, EventTypeDefinitionSchema, EventWebhookConfigSchema, ExecutionContextSchema, ExtensionPointSchema, FeatureFlag, FeatureFlagSchema, FeatureStrategy, FieldChangeSchema, GetPackageRequestSchema, GetPackageResponseSchema, GracefulDegradationSchema, HealthStatusSchema, HookRegisteredEventSchema, HookTriggeredEventSchema, HotReloadConfigSchema, InstallPackageRequestSchema, InstallPackageResponseSchema, InstalledPackageSchema, KernelContextSchema, KernelEventBaseSchema, KernelReadyEventSchema, KernelSecurityPolicySchema, KernelSecurityScanResultSchema, KernelSecurityVulnerabilitySchema, KernelShutdownEventSchema, ListPackagesRequestSchema, ListPackagesResponseSchema, ManifestSchema, MergeConflictSchema, MergeResultSchema, MergeStrategyConfigSchema, MetadataBulkRegisterRequestSchema, MetadataBulkResultSchema, MetadataChangeTypeSchema, MetadataCollectionInfoSchema, MetadataDependencySchema, MetadataDiffItemSchema, MetadataEventSchema, MetadataExportOptionsSchema, MetadataFallbackStrategySchema, MetadataFormatSchema, MetadataImportOptionsSchema, MetadataLoadOptionsSchema, MetadataLoadResultSchema, MetadataLoaderContractSchema, MetadataManagerConfigSchema, MetadataOverlaySchema, MetadataPluginConfigSchema, MetadataPluginManifestSchema, MetadataQueryResultSchema, MetadataQuerySchema, MetadataSaveOptionsSchema, MetadataSaveResultSchema, MetadataStatsSchema, MetadataTypeRegistryEntrySchema, MetadataTypeSchema, MetadataValidationResultSchema, MetadataWatchEventSchema, MultiVersionSupportSchema, OclifPluginConfigSchema, OpsDomainModuleSchema, OpsFilePathSchema, OpsPluginStructureSchema, PackageDependencyConflictSchema, PackageDependencyResolutionResultSchema, PackageDependencySchema, PackageStatusEnum, PermissionActionSchema, PermissionSchema, PermissionScopeSchema, PermissionSetSchema, PluginCachingSchema, PluginCapabilityManifestSchema, PluginCapabilitySchema, PluginCodeSplittingSchema, PluginCompatibilityMatrixSchema, PluginContextSchema, PluginDependencyResolutionSchema, PluginDependencySchema, PluginDiscoveryConfigSchema, PluginDiscoverySourceSchema, PluginDynamicImportSchema, PluginErrorEventSchema, PluginEventBaseSchema, PluginHealthCheckSchema, PluginHealthReportSchema, PluginHealthStatusSchema, PluginHotReloadSchema, PluginInitializationSchema, PluginInstallConfigSchema, PluginInterfaceSchema, PluginLifecycleEventType, PluginLifecyclePhaseEventSchema, PluginLifecycleSchema, PluginLoadingConfigSchema, PluginLoadingEventSchema, PluginLoadingStateSchema, PluginLoadingStrategySchema, PluginMetadataSchema, PluginPerformanceMonitoringSchema, PluginPreloadConfigSchema, PluginProvenanceSchema, PluginQualityMetricsSchema, PluginRegisteredEventSchema, PluginRegistryEntrySchema, PluginSandboxingSchema, PluginSchema, PluginSearchFiltersSchema, PluginSecurityManifestSchema, PluginSecurityProtocol, PluginSourceSchema, PluginStartupResultSchema, PluginStateSnapshotSchema, PluginStatisticsSchema, PluginTrustLevelSchema, PluginTrustScoreSchema, PluginUpdateStrategySchema, PluginVendorSchema, PluginVersionMetadataSchema, PreviewModeConfigSchema, ProtocolFeatureSchema, ProtocolReferenceSchema, ProtocolVersionSchema, RealTimeNotificationConfigSchema, ResourceTypeSchema, RollbackPackageRequestSchema, RollbackPackageResponseSchema, RuntimeConfigSchema, RuntimeMode, SBOMEntrySchema, SBOMSchema, SandboxConfigSchema, ScopeConfigSchema, ScopeInfoSchema, SecurityPolicySchema, SecurityScanResultSchema, SecurityVulnerabilitySchema, SemanticVersionSchema, ServiceFactoryRegistrationSchema, ServiceMetadataSchema, ServiceRegisteredEventSchema, ServiceRegistryConfigSchema, ServiceScopeType, ServiceUnregisteredEventSchema, StartupOptionsSchema, StartupOrchestrationResultSchema, UninstallPackageRequestSchema, UninstallPackageResponseSchema, UpgradeImpactLevelSchema, UpgradePackageRequestSchema, UpgradePackageResponseSchema, UpgradePhaseSchema, UpgradePlanSchema, UpgradeSnapshotSchema, ValidationErrorSchema, ValidationResultSchema, ValidationWarningSchema, VersionConstraintSchema, VulnerabilitySeverity };
+export { ActivationEventSchema, AdvancedPluginLifecycleConfigSchema, ArtifactChecksumSchema, ArtifactFileEntrySchema, ArtifactSignatureSchema, BreakingChangeSchema, CLICommandContributionSchema, CORE_PLUGIN_TYPES, CapabilityConformanceLevelSchema, CompatibilityLevelSchema, CompatibilityMatrixEntrySchema, CustomizationOriginSchema, CustomizationPolicySchema, DEFAULT_METADATA_TYPE_REGISTRY, DeadLetterQueueEntrySchema, DependencyConflictSchema, DependencyGraphNodeSchema, DependencyGraphSchema, DependencyResolutionResultSchema, DependencyStatusEnum, DeprecationNoticeSchema, DevFixtureConfigSchema, DevPluginConfigSchema, DevPluginPreset, DevServiceOverrideSchema, DevToolsConfigSchema, DisablePackageRequestSchema, DisablePackageResponseSchema, DistributedStateConfigSchema, DynamicLoadRequestSchema, DynamicLoadingConfigSchema, DynamicPluginOperationSchema, DynamicPluginResultSchema, DynamicUnloadRequestSchema, EVENT_PRIORITY_VALUES, EnablePackageRequestSchema, EnablePackageResponseSchema, EventBusConfigSchema, EventHandlerSchema, EventLogEntrySchema, EventMessageQueueConfigSchema, EventMetadataSchema, EventPersistenceSchema, EventPhaseSchema, EventPriority, EventQueueConfigSchema, EventReplayConfigSchema, EventRouteSchema, EventSchema, EventSourcingConfigSchema, EventTypeDefinitionSchema, EventWebhookConfigSchema, ExecutionContextSchema, ExtensionPointSchema, FeatureFlag, FeatureFlagSchema, FeatureStrategy, FieldChangeSchema, GetPackageRequestSchema, GetPackageResponseSchema, GracefulDegradationSchema, HealthStatusSchema, HookRegisteredEventSchema, HookTriggeredEventSchema, HotReloadConfigSchema, InstallPackageRequestSchema, InstallPackageResponseSchema, InstalledPackageSchema, KernelContextSchema, KernelEventBaseSchema, KernelReadyEventSchema, KernelSecurityPolicySchema, KernelSecurityScanResultSchema, KernelSecurityVulnerabilitySchema, KernelShutdownEventSchema, ListPackagesRequestSchema, ListPackagesResponseSchema, ManifestSchema, MergeConflictSchema, MergeResultSchema, MergeStrategyConfigSchema, MetadataBulkRegisterRequestSchema, MetadataBulkResultSchema, MetadataCategoryEnum, MetadataChangeTypeSchema, MetadataCollectionInfoSchema, MetadataDependencySchema, MetadataDiffItemSchema, MetadataEventSchema, MetadataExportOptionsSchema, MetadataFallbackStrategySchema, MetadataFormatSchema, MetadataImportOptionsSchema, MetadataLoadOptionsSchema, MetadataLoadResultSchema, MetadataLoaderContractSchema, MetadataManagerConfigSchema, MetadataOverlaySchema, MetadataPluginConfigSchema, MetadataPluginManifestSchema, MetadataQueryResultSchema, MetadataQuerySchema, MetadataSaveOptionsSchema, MetadataSaveResultSchema, MetadataStatsSchema, MetadataTypeRegistryEntrySchema, MetadataTypeSchema, MetadataValidationResultSchema, MetadataWatchEventSchema, MultiVersionSupportSchema, NamespaceConflictErrorSchema, NamespaceRegistryEntrySchema, OclifPluginConfigSchema, OpsDomainModuleSchema, OpsFilePathSchema, OpsPluginStructureSchema, PackageArtifactSchema, PackageDependencyConflictSchema, PackageDependencyResolutionResultSchema, PackageDependencySchema, PackageStatusEnum, PermissionActionSchema, PermissionSchema, PermissionScopeSchema, PermissionSetSchema, PluginBuildOptionsSchema, PluginBuildResultSchema, PluginCachingSchema, PluginCapabilityManifestSchema, PluginCapabilitySchema, PluginCodeSplittingSchema, PluginCompatibilityMatrixSchema, PluginContextSchema, PluginDependencyResolutionResultSchema, PluginDependencyResolutionSchema, PluginDependencySchema, PluginDiscoveryConfigSchema, PluginDiscoverySourceSchema, PluginDynamicImportSchema, PluginErrorEventSchema, PluginEventBaseSchema, PluginHealthCheckSchema, PluginHealthReportSchema, PluginHealthStatusSchema, PluginHotReloadSchema, PluginInitializationSchema, PluginInstallConfigSchema, PluginInterfaceSchema, PluginLifecycleEventType, PluginLifecyclePhaseEventSchema, PluginLifecycleSchema, PluginLoadingConfigSchema, PluginLoadingEventSchema, PluginLoadingStateSchema, PluginLoadingStrategySchema, PluginMetadataSchema, PluginPerformanceMonitoringSchema, PluginPreloadConfigSchema, PluginProvenanceSchema, PluginPublishOptionsSchema, PluginPublishResultSchema, PluginQualityMetricsSchema, PluginRegisteredEventSchema, PluginRegistryEntrySchema, PluginSandboxingSchema, PluginSchema, PluginSearchFiltersSchema, PluginSecurityManifestSchema, PluginSecurityProtocol, PluginSourceSchema, PluginStartupResultSchema, PluginStateSnapshotSchema, PluginStatisticsSchema, PluginTrustLevelSchema, PluginTrustScoreSchema, PluginUpdateStrategySchema, PluginValidateOptionsSchema, PluginValidateResultSchema, PluginVendorSchema, PluginVersionMetadataSchema, PreviewModeConfigSchema, ProtocolFeatureSchema, ProtocolReferenceSchema, ProtocolVersionSchema, RealTimeNotificationConfigSchema, RequiredActionSchema, ResolvedDependencySchema, ResourceTypeSchema, RollbackPackageRequestSchema, RollbackPackageResponseSchema, RuntimeConfigSchema, RuntimeMode, SBOMEntrySchema, SBOMSchema, SandboxConfigSchema, ScopeConfigSchema, ScopeInfoSchema, SecurityPolicySchema, SecurityScanResultSchema, SecurityVulnerabilitySchema, SemanticVersionSchema, ServiceFactoryRegistrationSchema, ServiceMetadataSchema, ServiceRegisteredEventSchema, ServiceRegistryConfigSchema, ServiceScopeType, ServiceUnregisteredEventSchema, StartupOptionsSchema, StartupOrchestrationResultSchema, UninstallPackageRequestSchema, UninstallPackageResponseSchema, UpgradeContextSchema, UpgradeImpactLevelSchema, UpgradePackageRequestSchema, UpgradePackageResponseSchema, UpgradePhaseSchema, UpgradePlanSchema, UpgradeSnapshotSchema, ValidationErrorSchema, ValidationFindingSchema, ValidationResultSchema, ValidationSeverityEnum, ValidationWarningSchema, VersionConstraintSchema, VulnerabilitySeverity };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map