@objectstack/spec 3.0.8 → 3.0.9

package/dist/index.mjs

@@ -3645,6 +3645,12 @@ var FeedItemSchema = z.object({
   /** Reply threading */
   parentId: z.string().optional().describe("Parent feed item ID for threaded replies"),
   replyCount: z.number().int().min(0).default(0).describe("Number of replies"),
+  /** Pin / Star */
+  pinned: z.boolean().default(false).describe("Whether the feed item is pinned to the top of the timeline"),
+  pinnedAt: z.string().datetime().optional().describe("Timestamp when the item was pinned"),
+  pinnedBy: z.string().optional().describe("User ID who pinned the item"),
+  starred: z.boolean().default(false).describe("Whether the feed item is starred/bookmarked by the current user"),
+  starredAt: z.string().datetime().optional().describe("Timestamp when the item was starred"),
   /** Visibility */
   visibility: FeedVisibility.default("public").describe("Visibility: public (all users), internal (team only), private (author + mentioned)"),
   /** Timestamps */
@@ -12371,6 +12377,9 @@ var kernel_exports = {};
 __export(kernel_exports, {
   ActivationEventSchema: () => ActivationEventSchema,
   AdvancedPluginLifecycleConfigSchema: () => AdvancedPluginLifecycleConfigSchema,
+  ArtifactChecksumSchema: () => ArtifactChecksumSchema,
+  ArtifactFileEntrySchema: () => ArtifactFileEntrySchema,
+  ArtifactSignatureSchema: () => ArtifactSignatureSchema,
   BreakingChangeSchema: () => BreakingChangeSchema,
   CLICommandContributionSchema: () => CLICommandContributionSchema,
   CORE_PLUGIN_TYPES: () => CORE_PLUGIN_TYPES,
@@ -12385,6 +12394,7 @@ __export(kernel_exports, {
   DependencyGraphNodeSchema: () => DependencyGraphNodeSchema,
   DependencyGraphSchema: () => DependencyGraphSchema,
   DependencyResolutionResultSchema: () => DependencyResolutionResultSchema,
+  DependencyStatusEnum: () => DependencyStatusEnum,
   DeprecationNoticeSchema: () => DeprecationNoticeSchema,
   DevFixtureConfigSchema: () => DevFixtureConfigSchema,
   DevPluginConfigSchema: () => DevPluginConfigSchema,
@@ -12448,6 +12458,7 @@ __export(kernel_exports, {
   MergeStrategyConfigSchema: () => MergeStrategyConfigSchema,
   MetadataBulkRegisterRequestSchema: () => MetadataBulkRegisterRequestSchema,
   MetadataBulkResultSchema: () => MetadataBulkResultSchema,
+  MetadataCategoryEnum: () => MetadataCategoryEnum,
   MetadataChangeTypeSchema: () => MetadataChangeTypeSchema,
   MetadataCollectionInfoSchema: () => MetadataCollectionInfoSchema2,
   MetadataDependencySchema: () => MetadataDependencySchema,
@@ -12474,10 +12485,13 @@ __export(kernel_exports, {
   MetadataValidationResultSchema: () => MetadataValidationResultSchema,
   MetadataWatchEventSchema: () => MetadataWatchEventSchema2,
   MultiVersionSupportSchema: () => MultiVersionSupportSchema,
+  NamespaceConflictErrorSchema: () => NamespaceConflictErrorSchema,
+  NamespaceRegistryEntrySchema: () => NamespaceRegistryEntrySchema,
   OclifPluginConfigSchema: () => OclifPluginConfigSchema,
   OpsDomainModuleSchema: () => OpsDomainModuleSchema,
   OpsFilePathSchema: () => OpsFilePathSchema,
   OpsPluginStructureSchema: () => OpsPluginStructureSchema,
+  PackageArtifactSchema: () => PackageArtifactSchema,
   PackageDependencyConflictSchema: () => PackageDependencyConflictSchema,
   PackageDependencyResolutionResultSchema: () => PackageDependencyResolutionResultSchema,
   PackageDependencySchema: () => PackageDependencySchema,
@@ -12486,12 +12500,15 @@ __export(kernel_exports, {
   PermissionSchema: () => PermissionSchema,
   PermissionScopeSchema: () => PermissionScopeSchema,
   PermissionSetSchema: () => PermissionSetSchema2,
+  PluginBuildOptionsSchema: () => PluginBuildOptionsSchema,
+  PluginBuildResultSchema: () => PluginBuildResultSchema,
   PluginCachingSchema: () => PluginCachingSchema,
   PluginCapabilityManifestSchema: () => PluginCapabilityManifestSchema,
   PluginCapabilitySchema: () => PluginCapabilitySchema,
   PluginCodeSplittingSchema: () => PluginCodeSplittingSchema,
   PluginCompatibilityMatrixSchema: () => PluginCompatibilityMatrixSchema,
   PluginContextSchema: () => PluginContextSchema,
+  PluginDependencyResolutionResultSchema: () => PluginDependencyResolutionResultSchema,
   PluginDependencyResolutionSchema: () => PluginDependencyResolutionSchema,
   PluginDependencySchema: () => PluginDependencySchema,
   PluginDiscoveryConfigSchema: () => PluginDiscoveryConfigSchema,
@@ -12517,6 +12534,8 @@ __export(kernel_exports, {
   PluginPerformanceMonitoringSchema: () => PluginPerformanceMonitoringSchema,
   PluginPreloadConfigSchema: () => PluginPreloadConfigSchema,
   PluginProvenanceSchema: () => PluginProvenanceSchema,
+  PluginPublishOptionsSchema: () => PluginPublishOptionsSchema,
+  PluginPublishResultSchema: () => PluginPublishResultSchema,
   PluginQualityMetricsSchema: () => PluginQualityMetricsSchema,
   PluginRegisteredEventSchema: () => PluginRegisteredEventSchema,
   PluginRegistryEntrySchema: () => PluginRegistryEntrySchema,
@@ -12532,6 +12551,8 @@ __export(kernel_exports, {
   PluginTrustLevelSchema: () => PluginTrustLevelSchema,
   PluginTrustScoreSchema: () => PluginTrustScoreSchema,
   PluginUpdateStrategySchema: () => PluginUpdateStrategySchema,
+  PluginValidateOptionsSchema: () => PluginValidateOptionsSchema,
+  PluginValidateResultSchema: () => PluginValidateResultSchema,
   PluginVendorSchema: () => PluginVendorSchema,
   PluginVersionMetadataSchema: () => PluginVersionMetadataSchema,
   PreviewModeConfigSchema: () => PreviewModeConfigSchema,
@@ -12539,6 +12560,8 @@ __export(kernel_exports, {
   ProtocolReferenceSchema: () => ProtocolReferenceSchema,
   ProtocolVersionSchema: () => ProtocolVersionSchema,
   RealTimeNotificationConfigSchema: () => RealTimeNotificationConfigSchema,
+  RequiredActionSchema: () => RequiredActionSchema,
+  ResolvedDependencySchema: () => ResolvedDependencySchema,
   ResourceTypeSchema: () => ResourceTypeSchema,
   RollbackPackageRequestSchema: () => RollbackPackageRequestSchema,
   RollbackPackageResponseSchema: () => RollbackPackageResponseSchema,
@@ -12563,6 +12586,7 @@ __export(kernel_exports, {
   StartupOrchestrationResultSchema: () => StartupOrchestrationResultSchema,
   UninstallPackageRequestSchema: () => UninstallPackageRequestSchema,
   UninstallPackageResponseSchema: () => UninstallPackageResponseSchema,
+  UpgradeContextSchema: () => UpgradeContextSchema,
   UpgradeImpactLevelSchema: () => UpgradeImpactLevelSchema,
   UpgradePackageRequestSchema: () => UpgradePackageRequestSchema,
   UpgradePackageResponseSchema: () => UpgradePackageResponseSchema,
@@ -12570,7 +12594,9 @@ __export(kernel_exports, {
   UpgradePlanSchema: () => UpgradePlanSchema,
   UpgradeSnapshotSchema: () => UpgradeSnapshotSchema,
   ValidationErrorSchema: () => ValidationErrorSchema,
+  ValidationFindingSchema: () => ValidationFindingSchema,
   ValidationResultSchema: () => ValidationResultSchema,
+  ValidationSeverityEnum: () => ValidationSeverityEnum,
   ValidationWarningSchema: () => ValidationWarningSchema,
   VersionConstraintSchema: () => VersionConstraintSchema,
   VulnerabilitySeverity: () => VulnerabilitySeverity
@@ -12611,6 +12637,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
@@ -12685,6 +12927,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"),
@@ -14174,12 +14460,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",
@@ -14495,7 +14791,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",
@@ -15348,29 +15659,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.
@@ -15384,73 +15695,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
@@ -15460,21 +15822,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
@@ -15486,7 +15848,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"),
@@ -15495,7 +15857,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 */
@@ -15514,7 +15876,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"),
@@ -15527,7 +15889,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.
@@ -15545,7 +15907,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"),
@@ -15565,7 +15927,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
@@ -15587,12 +15949,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 */
@@ -15605,10 +15967,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"),
@@ -15616,15 +15978,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
@@ -17299,7 +17661,7 @@ var DependencyConflictSchema = z.object({
    */
   severity: z.enum(["critical", "error", "warning", "info"])
 });
-var DependencyResolutionResultSchema = z.object({
+var PluginDependencyResolutionResultSchema = z.object({
   /**
    * Resolution successful
    */
@@ -18538,6 +18900,8 @@ __export(cloud_exports, {
   AppDiscoveryRequestSchema: () => AppDiscoveryRequestSchema,
   AppDiscoveryResponseSchema: () => AppDiscoveryResponseSchema,
   AppSubscriptionSchema: () => AppSubscriptionSchema,
+  ArtifactDownloadResponseSchema: () => ArtifactDownloadResponseSchema,
+  ArtifactReferenceSchema: () => ArtifactReferenceSchema,
   CreateListingRequestSchema: () => CreateListingRequestSchema,
   CuratedCollectionSchema: () => CuratedCollectionSchema,
   FeaturedListingSchema: () => FeaturedListingSchema,
@@ -18591,7 +18955,7 @@ var PublisherVerificationSchema = z.enum([
   // Trusted publisher (track record of quality)
   "partner"
   // Official platform partner
-]);
+]).describe("Publisher verification status");
 var PublisherSchema = z.object({
   /** Publisher unique identifier */
   id: z.string().describe("Publisher ID"),
@@ -18600,7 +18964,7 @@ var PublisherSchema = z.object({
   /** Publisher type */
   type: z.enum(["individual", "organization"]).describe("Publisher type"),
   /** Verification status */
-  verification: PublisherVerificationSchema.default("unverified"),
+  verification: PublisherVerificationSchema.default("unverified").describe("Publisher verification status"),
   /** Contact email */
   email: z.string().email().optional().describe("Contact email"),
   /** Website URL */
@@ -18610,8 +18974,32 @@ var PublisherSchema = z.object({
   /** Short description/bio */
   description: z.string().optional().describe("Publisher description"),
   /** Registration date */
-  registeredAt: z.string().datetime().optional()
-});
+  registeredAt: z.string().datetime().optional().describe("Publisher registration timestamp")
+}).describe("Developer or organization that publishes packages");
+var ArtifactReferenceSchema = z.object({
+  /** Artifact download URL */
+  url: z.string().url().describe("Artifact download URL"),
+  /** SHA256 integrity checksum */
+  sha256: z.string().regex(/^[a-f0-9]{64}$/).describe("SHA256 checksum"),
+  /** File size in bytes */
+  size: z.number().int().positive().describe("Artifact size in bytes"),
+  /** Artifact format */
+  format: z.enum(["tgz", "zip"]).default("tgz").describe("Artifact format"),
+  /** Upload timestamp */
+  uploadedAt: z.string().datetime().describe("Upload timestamp")
+}).describe("Reference to a downloadable package artifact");
+var ArtifactDownloadResponseSchema = z.object({
+  /** Pre-signed or direct download URL */
+  downloadUrl: z.string().url().describe("Artifact download URL (may be pre-signed)"),
+  /** SHA256 checksum for download verification */
+  sha256: z.string().regex(/^[a-f0-9]{64}$/).describe("SHA256 checksum for verification"),
+  /** File size in bytes */
+  size: z.number().int().positive().describe("Artifact size in bytes"),
+  /** Artifact format */
+  format: z.enum(["tgz", "zip"]).describe("Artifact format"),
+  /** URL expiration time (for pre-signed URLs) */
+  expiresAt: z.string().datetime().optional().describe("URL expiration timestamp for pre-signed URLs")
+}).describe("Artifact download response with integrity metadata");
 var MarketplaceCategorySchema = z.enum([
   "crm",
   // Customer Relationship Management
@@ -18643,7 +19031,7 @@ var MarketplaceCategorySchema = z.enum([
   // Storage & Drivers
   "other"
   // Other / Uncategorized
-]);
+]).describe("Marketplace package category");
 var ListingStatusSchema = z.enum([
   "draft",
   // Not yet submitted
@@ -18663,7 +19051,7 @@ var ListingStatusSchema = z.enum([
   // Deprecated by publisher
   "unlisted"
   // Available by direct link only
-]);
+]).describe("Marketplace listing status");
 var PricingModelSchema = z.enum([
   "free",
   // Free to install
@@ -18677,7 +19065,7 @@ var PricingModelSchema = z.enum([
   // Pay per usage
   "contact-sales"
   // Enterprise pricing, contact for quote
-]);
+]).describe("Package pricing model");
 var MarketplaceListingSchema = z.object({
   /** Listing ID (matches package ID) */
   id: z.string().describe("Listing ID (matches package manifest ID)"),
@@ -18686,7 +19074,7 @@ var MarketplaceListingSchema = z.object({
   /** Publisher information */
   publisherId: z.string().describe("Publisher ID"),
   /** Current listing status */
-  status: ListingStatusSchema.default("draft"),
+  status: ListingStatusSchema.default("draft").describe("Publication state: draft, published, under-review, suspended, deprecated, or unlisted"),
   /** Display name */
   name: z.string().describe("Display name"),
   /** Tagline (short description for cards/search results) */
@@ -18694,7 +19082,7 @@ var MarketplaceListingSchema = z.object({
   /** Full description (supports Markdown) */
   description: z.string().optional().describe("Full description (Markdown)"),
   /** Category */
-  category: MarketplaceCategorySchema,
+  category: MarketplaceCategorySchema.describe("Package category"),
   /** Additional tags for search discovery */
   tags: z.array(z.string()).optional().describe("Search tags"),
   /** Icon/logo URL */
@@ -18705,13 +19093,13 @@ var MarketplaceListingSchema = z.object({
     caption: z.string().optional()
   })).optional().describe("Screenshots"),
   /** Documentation URL */
-  documentationUrl: z.string().url().optional(),
+  documentationUrl: z.string().url().optional().describe("Documentation URL"),
   /** Support URL */
-  supportUrl: z.string().url().optional(),
+  supportUrl: z.string().url().optional().describe("Support URL"),
   /** Source repository URL (if open source) */
-  repositoryUrl: z.string().url().optional(),
+  repositoryUrl: z.string().url().optional().describe("Source repository URL"),
   /** Pricing model */
-  pricing: PricingModelSchema.default("free"),
+  pricing: PricingModelSchema.default("free").describe("Pricing model"),
   /** Price in cents (if paid) */
   priceInCents: z.number().int().min(0).optional().describe("Price in cents (e.g. 999 = $9.99)"),
   /** Latest published version */
@@ -18720,25 +19108,27 @@ var MarketplaceListingSchema = z.object({
   minPlatformVersion: z.string().optional().describe("Minimum ObjectStack platform version"),
   /** Available versions for installation */
   versions: z.array(z.object({
-    version: z.string(),
-    releaseDate: z.string().datetime(),
-    releaseNotes: z.string().optional(),
-    minPlatformVersion: z.string().optional(),
-    deprecated: z.boolean().default(false)
+    version: z.string().describe("Version string"),
+    releaseDate: z.string().datetime().describe("Release date"),
+    releaseNotes: z.string().optional().describe("Release notes"),
+    minPlatformVersion: z.string().optional().describe("Minimum platform version"),
+    deprecated: z.boolean().default(false).describe("Whether this version is deprecated"),
+    /** Artifact reference for this version */
+    artifact: ArtifactReferenceSchema.optional().describe("Downloadable artifact for this version")
   })).optional().describe("Published versions"),
   /** Aggregate statistics */
   stats: z.object({
-    totalInstalls: z.number().int().min(0).default(0),
-    activeInstalls: z.number().int().min(0).default(0),
-    averageRating: z.number().min(0).max(5).optional(),
-    totalRatings: z.number().int().min(0).default(0),
-    totalReviews: z.number().int().min(0).default(0)
+    totalInstalls: z.number().int().min(0).default(0).describe("Total installs"),
+    activeInstalls: z.number().int().min(0).default(0).describe("Active installs"),
+    averageRating: z.number().min(0).max(5).optional().describe("Average user rating (0-5)"),
+    totalRatings: z.number().int().min(0).default(0).describe("Total ratings count"),
+    totalReviews: z.number().int().min(0).default(0).describe("Total reviews count")
   }).optional().describe("Aggregate marketplace statistics"),
   /** First published date */
-  publishedAt: z.string().datetime().optional(),
+  publishedAt: z.string().datetime().optional().describe("First published timestamp"),
   /** Last updated date */
-  updatedAt: z.string().datetime().optional()
-});
+  updatedAt: z.string().datetime().optional().describe("Last updated timestamp")
+}).describe("Public-facing package listing on the marketplace");
 var PackageSubmissionSchema = z.object({
   /** Submission ID */
   id: z.string().describe("Submission ID"),
@@ -18762,16 +19152,16 @@ var PackageSubmissionSchema = z.object({
     // Approved for publishing
     "rejected"
     // Rejected
-  ]).default("pending"),
+  ]).default("pending").describe("Review status"),
   /**
    * Package artifact URL or reference.
    * Points to the built package bundle for review.
    */
   artifactUrl: z.string().describe("Package artifact URL for review"),
   /** Release notes for this version */
-  releaseNotes: z.string().optional(),
+  releaseNotes: z.string().optional().describe("Release notes for this version"),
   /** Whether this is the first submission (new listing) vs version update */
-  isNewListing: z.boolean().default(false),
+  isNewListing: z.boolean().default(false).describe("Whether this is a new listing submission"),
   /** Automated scan results */
   scanResults: z.object({
     /** Whether automated scan passed */
@@ -18789,23 +19179,23 @@ var PackageSubmissionSchema = z.object({
     })).optional()
   }).optional().describe("Automated scan results"),
   /** Reviewer notes (from platform reviewer) */
-  reviewerNotes: z.string().optional(),
+  reviewerNotes: z.string().optional().describe("Notes from the platform reviewer"),
   /** Submitted timestamp */
-  submittedAt: z.string().datetime().optional(),
+  submittedAt: z.string().datetime().optional().describe("Submission timestamp"),
   /** Review completed timestamp */
-  reviewedAt: z.string().datetime().optional()
-});
+  reviewedAt: z.string().datetime().optional().describe("Review completion timestamp")
+}).describe("Developer submission of a package version for review");
 var MarketplaceSearchRequestSchema = z.object({
   /** Search query string */
   query: z.string().optional().describe("Full-text search query"),
   /** Filter by category */
-  category: MarketplaceCategorySchema.optional(),
+  category: MarketplaceCategorySchema.optional().describe("Filter by category"),
   /** Filter by tags */
-  tags: z.array(z.string()).optional(),
+  tags: z.array(z.string()).optional().describe("Filter by tags"),
   /** Filter by pricing model */
-  pricing: PricingModelSchema.optional(),
+  pricing: PricingModelSchema.optional().describe("Filter by pricing model"),
   /** Filter by publisher verification level */
-  publisherVerification: PublisherVerificationSchema.optional(),
+  publisherVerification: PublisherVerificationSchema.optional().describe("Filter by publisher verification level"),
   /** Sort by */
   sortBy: z.enum([
     "relevance",
@@ -18820,25 +19210,25 @@ var MarketplaceSearchRequestSchema = z.object({
     // Most recently updated
     "name"
     // Alphabetical
-  ]).default("relevance"),
+  ]).default("relevance").describe("Sort field"),
   /** Sort direction */
-  sortDirection: z.enum(["asc", "desc"]).default("desc"),
+  sortDirection: z.enum(["asc", "desc"]).default("desc").describe("Sort direction"),
   /** Pagination: page number */
-  page: z.number().int().min(1).default(1),
+  page: z.number().int().min(1).default(1).describe("Page number"),
   /** Pagination: items per page */
-  pageSize: z.number().int().min(1).max(100).default(20),
+  pageSize: z.number().int().min(1).max(100).default(20).describe("Items per page"),
   /** Filter by minimum platform version compatibility */
   platformVersion: z.string().optional().describe("Filter by platform version compatibility")
-});
+}).describe("Marketplace search request");
 var MarketplaceSearchResponseSchema = z.object({
   /** Search results */
-  items: z.array(MarketplaceListingSchema),
+  items: z.array(MarketplaceListingSchema).describe("Search result listings"),
   /** Total count (for pagination) */
-  total: z.number().int().min(0),
+  total: z.number().int().min(0).describe("Total matching results"),
   /** Current page */
-  page: z.number().int().min(1),
+  page: z.number().int().min(1).describe("Current page number"),
   /** Items per page */
-  pageSize: z.number().int().min(1),
+  pageSize: z.number().int().min(1).describe("Items per page"),
   /** Facets for filtering */
   facets: z.object({
     categories: z.array(z.object({
@@ -18849,8 +19239,8 @@ var MarketplaceSearchResponseSchema = z.object({
       model: PricingModelSchema,
       count: z.number().int().min(0)
     })).optional()
-  }).optional()
-});
+  }).optional().describe("Aggregation facets for refining search")
+}).describe("Marketplace search response");
 var MarketplaceInstallRequestSchema = z.object({
   /** Listing ID to install */
   listingId: z.string().describe("Marketplace listing ID"),
@@ -18859,22 +19249,24 @@ var MarketplaceInstallRequestSchema = z.object({
   /** License key (for paid packages) */
   licenseKey: z.string().optional().describe("License key for paid packages"),
   /** 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 */
-  enableOnInstall: z.boolean().default(true),
+  enableOnInstall: z.boolean().default(true).describe("Whether to enable immediately after install"),
+  /** Artifact reference (resolved from listing version, or provided directly) */
+  artifactRef: ArtifactReferenceSchema.optional().describe("Artifact reference for direct installation"),
   /** Tenant ID */
-  tenantId: z.string().optional()
-});
+  tenantId: z.string().optional().describe("Tenant identifier")
+}).describe("Install from marketplace request");
 var MarketplaceInstallResponseSchema = z.object({
   /** Whether installation was successful */
-  success: z.boolean(),
+  success: z.boolean().describe("Whether installation succeeded"),
   /** Installed package ID */
-  packageId: z.string().optional(),
+  packageId: z.string().optional().describe("Installed package identifier"),
   /** Installed version */
-  version: z.string().optional(),
+  version: z.string().optional().describe("Installed version"),
   /** Human-readable message */
-  message: z.string().optional()
-});
+  message: z.string().optional().describe("Installation status message")
+}).describe("Install from marketplace response");
 var PublisherProfileSchema = z.object({
   /** Organization ID (references Identity.Organization.id) */
   organizationId: z.string().describe("Identity Organization ID"),
@@ -24918,6 +25310,10 @@ __export(api_exports, {
   AuthEndpointPaths: () => AuthEndpointPaths,
   AuthEndpointSchema: () => AuthEndpointSchema,
   AuthProvider: () => AuthProvider,
+  AutomationApiContracts: () => AutomationApiContracts,
+  AutomationApiErrorCode: () => AutomationApiErrorCode,
+  AutomationFlowPathParamsSchema: () => AutomationFlowPathParamsSchema,
+  AutomationRunPathParamsSchema: () => AutomationRunPathParamsSchema,
   AutomationTriggerRequestSchema: () => AutomationTriggerRequestSchema,
   AutomationTriggerResponseSchema: () => AutomationTriggerResponseSchema,
   BasePresenceSchema: () => BasePresenceSchema,
@@ -24942,16 +25338,23 @@ __export(api_exports, {
   CacheInvalidationResponseSchema: () => CacheInvalidationResponseSchema,
   CacheInvalidationTarget: () => CacheInvalidationTarget,
   CallbackSchema: () => CallbackSchema,
+  ChangelogEntrySchema: () => ChangelogEntrySchema,
   CheckPermissionRequestSchema: () => CheckPermissionRequestSchema,
   CheckPermissionResponseSchema: () => CheckPermissionResponseSchema,
   CodeGenerationTemplateSchema: () => CodeGenerationTemplateSchema,
+  CompleteChunkedUploadRequestSchema: () => CompleteChunkedUploadRequestSchema,
+  CompleteChunkedUploadResponseSchema: () => CompleteChunkedUploadResponseSchema,
   CompleteUploadRequestSchema: () => CompleteUploadRequestSchema,
   ConceptListResponseSchema: () => ConceptListResponseSchema,
   ConflictResolutionStrategy: () => ConflictResolutionStrategy,
   CreateDataRequestSchema: () => CreateDataRequestSchema,
   CreateDataResponseSchema: () => CreateDataResponseSchema,
+  CreateExportJobRequestSchema: () => CreateExportJobRequestSchema,
+  CreateExportJobResponseSchema: () => CreateExportJobResponseSchema,
   CreateFeedItemRequestSchema: () => CreateFeedItemRequestSchema,
   CreateFeedItemResponseSchema: () => CreateFeedItemResponseSchema,
+  CreateFlowRequestSchema: () => CreateFlowRequestSchema,
+  CreateFlowResponseSchema: () => CreateFlowResponseSchema,
   CreateManyDataRequestSchema: () => CreateManyDataRequestSchema,
   CreateManyDataResponseSchema: () => CreateManyDataResponseSchema,
   CreateRequestSchema: () => CreateRequestSchema,
@@ -24978,10 +25381,13 @@ __export(api_exports, {
   DEFAULT_VIEW_ROUTES: () => DEFAULT_VIEW_ROUTES,
   DEFAULT_WORKFLOW_ROUTES: () => DEFAULT_WORKFLOW_ROUTES,
   DataLoaderConfigSchema: () => DataLoaderConfigSchema,
+  DeduplicationStrategy: () => DeduplicationStrategy,
   DeleteDataRequestSchema: () => DeleteDataRequestSchema,
   DeleteDataResponseSchema: () => DeleteDataResponseSchema,
   DeleteFeedItemRequestSchema: () => DeleteFeedItemRequestSchema,
   DeleteFeedItemResponseSchema: () => DeleteFeedItemResponseSchema,
+  DeleteFlowRequestSchema: () => DeleteFlowRequestSchema,
+  DeleteFlowResponseSchema: () => DeleteFlowResponseSchema,
   DeleteManyDataRequestSchema: () => DeleteManyDataRequestSchema,
   DeleteManyDataResponseSchema: () => DeleteManyDataResponseSchema,
   DeleteManyRequestSchema: () => DeleteManyRequestSchema,
@@ -25013,6 +25419,12 @@ __export(api_exports, {
   EventMessageSchema: () => EventMessageSchema,
   EventPatternSchema: () => EventPatternSchema,
   EventSubscriptionSchema: () => EventSubscriptionSchema,
+  ExportApiContracts: () => ExportApiContracts,
+  ExportFormat: () => ExportFormat,
+  ExportImportTemplateSchema: () => ExportImportTemplateSchema,
+  ExportJobProgressSchema: () => ExportJobProgressSchema,
+  ExportJobStatus: () => ExportJobStatus,
+  ExportJobSummarySchema: () => ExportJobSummarySchema,
   ExportRequestSchema: () => ExportRequestSchema,
   FederationEntityKeySchema: () => FederationEntityKeySchema,
   FederationEntitySchema: () => FederationEntitySchema,
@@ -25027,23 +25439,34 @@ __export(api_exports, {
   FeedPathParamsSchema: () => FeedPathParamsSchema,
   FeedUnsubscribeRequestSchema: () => FeedUnsubscribeRequestSchema,
   FieldErrorSchema: () => FieldErrorSchema,
+  FieldMappingEntrySchema: () => FieldMappingEntrySchema,
+  FileTypeValidationSchema: () => FileTypeValidationSchema,
   FileUploadResponseSchema: () => FileUploadResponseSchema,
   FilterOperator: () => FilterOperator,
   FindDataRequestSchema: () => FindDataRequestSchema,
   FindDataResponseSchema: () => FindDataResponseSchema,
+  FlowSummarySchema: () => FlowSummarySchema,
   GeneratedApiDocumentationSchema: () => GeneratedApiDocumentationSchema,
   GeneratedEndpointSchema: () => GeneratedEndpointSchema,
   GetAnalyticsMetaRequestSchema: () => GetAnalyticsMetaRequestSchema,
+  GetChangelogRequestSchema: () => GetChangelogRequestSchema,
+  GetChangelogResponseSchema: () => GetChangelogResponseSchema,
   GetDataRequestSchema: () => GetDataRequestSchema,
   GetDataResponseSchema: () => GetDataResponseSchema,
   GetDiscoveryRequestSchema: () => GetDiscoveryRequestSchema,
   GetDiscoveryResponseSchema: () => GetDiscoveryResponseSchema,
   GetEffectivePermissionsRequestSchema: () => GetEffectivePermissionsRequestSchema,
   GetEffectivePermissionsResponseSchema: () => GetEffectivePermissionsResponseSchema,
+  GetExportJobDownloadRequestSchema: () => GetExportJobDownloadRequestSchema,
+  GetExportJobDownloadResponseSchema: () => GetExportJobDownloadResponseSchema,
   GetFeedRequestSchema: () => GetFeedRequestSchema,
   GetFeedResponseSchema: () => GetFeedResponseSchema,
   GetFieldLabelsRequestSchema: () => GetFieldLabelsRequestSchema,
   GetFieldLabelsResponseSchema: () => GetFieldLabelsResponseSchema,
+  GetFlowRequestSchema: () => GetFlowRequestSchema,
+  GetFlowResponseSchema: () => GetFlowResponseSchema,
+  GetInstalledPackageRequestSchema: () => GetInstalledPackageRequestSchema,
+  GetInstalledPackageResponseSchema: () => GetInstalledPackageResponseSchema,
   GetLocalesRequestSchema: () => GetLocalesRequestSchema,
   GetLocalesResponseSchema: () => GetLocalesResponseSchema,
   GetMetaItemCachedRequestSchema: () => GetMetaItemCachedRequestSchema,
@@ -25063,6 +25486,8 @@ __export(api_exports, {
   GetPresenceRequestSchema: () => GetPresenceRequestSchema,
   GetPresenceResponseSchema: () => GetPresenceResponseSchema,
   GetPresignedUrlRequestSchema: () => GetPresignedUrlRequestSchema,
+  GetRunRequestSchema: () => GetRunRequestSchema,
+  GetRunResponseSchema: () => GetRunResponseSchema,
   GetTranslationsRequestSchema: () => GetTranslationsRequestSchema,
   GetTranslationsResponseSchema: () => GetTranslationsResponseSchema,
   GetUiViewRequestSchema: () => GetUiViewRequestSchema,
@@ -25092,13 +25517,26 @@ __export(api_exports, {
   HttpMethod: () => HttpMethod,
   HttpStatusCode: () => HttpStatusCode,
   IdRequestSchema: () => IdRequestSchema,
+  ImportValidationConfigSchema: () => ImportValidationConfigSchema,
+  ImportValidationMode: () => ImportValidationMode,
+  ImportValidationResultSchema: () => ImportValidationResultSchema,
+  InitiateChunkedUploadRequestSchema: () => InitiateChunkedUploadRequestSchema,
+  InitiateChunkedUploadResponseSchema: () => InitiateChunkedUploadResponseSchema,
   InstallPackageRequestSchema: () => InstallPackageRequestSchema,
   InstallPackageResponseSchema: () => InstallPackageResponseSchema,
+  ListExportJobsRequestSchema: () => ListExportJobsRequestSchema,
+  ListExportJobsResponseSchema: () => ListExportJobsResponseSchema,
+  ListFlowsRequestSchema: () => ListFlowsRequestSchema,
+  ListFlowsResponseSchema: () => ListFlowsResponseSchema,
+  ListInstalledPackagesRequestSchema: () => ListInstalledPackagesRequestSchema,
+  ListInstalledPackagesResponseSchema: () => ListInstalledPackagesResponseSchema,
   ListNotificationsRequestSchema: () => ListNotificationsRequestSchema,
   ListNotificationsResponseSchema: () => ListNotificationsResponseSchema,
   ListPackagesRequestSchema: () => ListPackagesRequestSchema,
   ListPackagesResponseSchema: () => ListPackagesResponseSchema,
   ListRecordResponseSchema: () => ListRecordResponseSchema,
+  ListRunsRequestSchema: () => ListRunsRequestSchema,
+  ListRunsResponseSchema: () => ListRunsResponseSchema,
   ListViewsRequestSchema: () => ListViewsRequestSchema,
   ListViewsResponseSchema: () => ListViewsResponseSchema,
   LoginRequestSchema: () => LoginRequestSchema,
@@ -25157,6 +25595,17 @@ __export(api_exports, {
   OpenApiSpec: () => OpenApiSpec,
   OpenApiSpecSchema: () => OpenApiSpecSchema,
   OperatorMappingSchema: () => OperatorMappingSchema,
+  PackageApiContracts: () => PackageApiContracts,
+  PackageApiErrorCode: () => PackageApiErrorCode,
+  PackageInstallRequestSchema: () => PackageInstallRequestSchema,
+  PackageInstallResponseSchema: () => PackageInstallResponseSchema,
+  PackagePathParamsSchema: () => PackagePathParamsSchema,
+  PackageRollbackRequestSchema: () => PackageRollbackRequestSchema,
+  PackageRollbackResponseSchema: () => PackageRollbackResponseSchema,
+  PackageUpgradeRequestSchema: () => PackageUpgradeRequestSchema,
+  PackageUpgradeResponseSchema: () => PackageUpgradeResponseSchema,
+  PinFeedItemRequestSchema: () => PinFeedItemRequestSchema,
+  PinFeedItemResponseSchema: () => PinFeedItemResponseSchema,
   PingMessageSchema: () => PingMessageSchema,
   PongMessageSchema: () => PongMessageSchema,
   PresenceMessageSchema: () => PresenceMessageSchema,
@@ -25188,6 +25637,8 @@ __export(api_exports, {
   RemoveReactionRequestSchema: () => RemoveReactionRequestSchema,
   RemoveReactionResponseSchema: () => RemoveReactionResponseSchema,
   RequestValidationConfigSchema: () => RequestValidationConfigSchema,
+  ResolveDependenciesRequestSchema: () => ResolveDependenciesRequestSchema,
+  ResolveDependenciesResponseSchema: () => ResolveDependenciesResponseSchema,
   ResponseEnvelopeConfigSchema: () => ResponseEnvelopeConfigSchema,
   RestApiConfig: () => RestApiConfig,
   RestApiConfigSchema: () => RestApiConfigSchema,
@@ -25207,7 +25658,12 @@ __export(api_exports, {
   RouterConfigSchema: () => RouterConfigSchema,
   SaveMetaItemRequestSchema: () => SaveMetaItemRequestSchema,
   SaveMetaItemResponseSchema: () => SaveMetaItemResponseSchema,
+  ScheduleExportRequestSchema: () => ScheduleExportRequestSchema,
+  ScheduleExportResponseSchema: () => ScheduleExportResponseSchema,
+  ScheduledExportSchema: () => ScheduledExportSchema,
   SchemaDefinition: () => SchemaDefinition,
+  SearchFeedRequestSchema: () => SearchFeedRequestSchema,
+  SearchFeedResponseSchema: () => SearchFeedResponseSchema,
   ServiceInfoSchema: () => ServiceInfoSchema,
   SessionResponseSchema: () => SessionResponseSchema,
   SessionSchema: () => SessionSchema2,
@@ -25219,17 +25675,30 @@ __export(api_exports, {
   SingleRecordResponseSchema: () => SingleRecordResponseSchema,
   StandardApiContracts: () => StandardApiContracts,
   StandardErrorCode: () => StandardErrorCode,
+  StarFeedItemRequestSchema: () => StarFeedItemRequestSchema,
+  StarFeedItemResponseSchema: () => StarFeedItemResponseSchema,
+  StorageApiContracts: () => StorageApiContracts,
   SubgraphConfigSchema: () => SubgraphConfigSchema,
   SubscribeMessageSchema: () => SubscribeMessageSchema,
   SubscribeRequestSchema: () => SubscribeRequestSchema,
   SubscribeResponseSchema: () => SubscribeResponseSchema,
   SubscriptionEventSchema: () => SubscriptionEventSchema,
   SubscriptionSchema: () => SubscriptionSchema,
+  ToggleFlowRequestSchema: () => ToggleFlowRequestSchema,
+  ToggleFlowResponseSchema: () => ToggleFlowResponseSchema,
   TransportProtocol: () => TransportProtocol,
+  TriggerFlowRequestSchema: () => TriggerFlowRequestSchema,
+  TriggerFlowResponseSchema: () => TriggerFlowResponseSchema,
+  UninstallPackageApiRequestSchema: () => UninstallPackageApiRequestSchema,
+  UninstallPackageApiResponseSchema: () => UninstallPackageApiResponseSchema,
   UninstallPackageRequestSchema: () => UninstallPackageRequestSchema,
   UninstallPackageResponseSchema: () => UninstallPackageResponseSchema,
+  UnpinFeedItemRequestSchema: () => UnpinFeedItemRequestSchema,
+  UnpinFeedItemResponseSchema: () => UnpinFeedItemResponseSchema,
   UnregisterDeviceRequestSchema: () => UnregisterDeviceRequestSchema,
   UnregisterDeviceResponseSchema: () => UnregisterDeviceResponseSchema,
+  UnstarFeedItemRequestSchema: () => UnstarFeedItemRequestSchema,
+  UnstarFeedItemResponseSchema: () => UnstarFeedItemResponseSchema,
   UnsubscribeMessageSchema: () => UnsubscribeMessageSchema,
   UnsubscribeRequestSchema: () => UnsubscribeRequestSchema,
   UnsubscribeResponseSchema: () => UnsubscribeResponseSchema,
@@ -25237,6 +25706,8 @@ __export(api_exports, {
   UpdateDataResponseSchema: () => UpdateDataResponseSchema,
   UpdateFeedItemRequestSchema: () => UpdateFeedItemRequestSchema,
   UpdateFeedItemResponseSchema: () => UpdateFeedItemResponseSchema,
+  UpdateFlowRequestSchema: () => UpdateFlowRequestSchema,
+  UpdateFlowResponseSchema: () => UpdateFlowResponseSchema,
   UpdateManyDataRequestSchema: () => UpdateManyDataRequestSchema,
   UpdateManyDataResponseSchema: () => UpdateManyDataResponseSchema,
   UpdateManyRequestSchema: () => UpdateManyRequestSchema,
@@ -25245,6 +25716,11 @@ __export(api_exports, {
   UpdateRequestSchema: () => UpdateRequestSchema,
   UpdateViewRequestSchema: () => UpdateViewRequestSchema,
   UpdateViewResponseSchema: () => UpdateViewResponseSchema,
+  UploadArtifactRequestSchema: () => UploadArtifactRequestSchema,
+  UploadArtifactResponseSchema: () => UploadArtifactResponseSchema,
+  UploadChunkRequestSchema: () => UploadChunkRequestSchema,
+  UploadChunkResponseSchema: () => UploadChunkResponseSchema,
+  UploadProgressSchema: () => UploadProgressSchema,
   UserProfileResponseSchema: () => UserProfileResponseSchema,
   ValidationMode: () => ValidationMode,
   VersionDefinitionSchema: () => VersionDefinitionSchema,
@@ -25260,6 +25736,7 @@ __export(api_exports, {
   WebSocketServerConfigSchema: () => WebSocketServerConfigSchema,
   WebhookConfigSchema: () => WebhookConfigSchema,
   WebhookEventSchema: () => WebhookEventSchema,
+  WellKnownCapabilitiesSchema: () => WellKnownCapabilitiesSchema,
   WorkflowApproveRequestSchema: () => WorkflowApproveRequestSchema,
   WorkflowApproveResponseSchema: () => WorkflowApproveResponseSchema,
   WorkflowRejectRequestSchema: () => WorkflowRejectRequestSchema,
@@ -25439,8 +25916,17 @@ var ServiceInfoSchema = z.object({
   route: z.string().optional().describe("e.g. /api/v1/analytics"),
   /** Implementation provider name */
   provider: z.string().optional().describe('e.g. "objectql", "plugin-redis", "driver-memory"'),
+  /** Service version */
+  version: z.string().optional().describe('Semantic version of the service implementation (e.g. "3.0.6")'),
   /** Human-readable reason if unavailable */
-  message: z.string().optional().describe('e.g. "Install plugin-workflow to enable"')
+  message: z.string().optional().describe('e.g. "Install plugin-workflow to enable"'),
+  /** Rate limit configuration for this service */
+  rateLimit: z.object({
+    requestsPerMinute: z.number().int().optional().describe("Maximum requests per minute"),
+    requestsPerHour: z.number().int().optional().describe("Maximum requests per hour"),
+    burstLimit: z.number().int().optional().describe("Maximum burst request count"),
+    retryAfterMs: z.number().int().optional().describe("Suggested retry-after delay in milliseconds when rate-limited")
+  }).optional().describe("Rate limit and quota info for this service")
 });
 var ApiRoutesSchema = z.object({
   /** Base URL for Object CRUD (Data Protocol) */
@@ -25494,11 +25980,46 @@ var DiscoverySchema = z.object({
   services: z.record(z.string(), ServiceInfoSchema).describe(
     "Per-service availability map keyed by CoreServiceName"
   ),
+  /**
+   * Hierarchical capability descriptors.
+   * Declares platform features so clients can adapt UI without probing individual services.
+   * Each key is a capability domain (e.g., "comments", "automation", "search"),
+   * and its value describes what sub-features are available.
+   */
+  capabilities: z.record(z.string(), z.object({
+    enabled: z.boolean().describe("Whether this capability is available"),
+    features: z.record(z.string(), z.boolean()).optional().describe("Sub-feature flags within this capability"),
+    description: z.string().optional().describe("Human-readable capability description")
+  })).optional().describe("Hierarchical capability descriptors for frontend intelligent adaptation"),
+  /**
+   * Schema discovery URLs for cross-ecosystem interoperability.
+   */
+  schemaDiscovery: z.object({
+    openapi: z.string().optional().describe('URL to OpenAPI (Swagger) specification (e.g., "/api/v1/openapi.json")'),
+    graphql: z.string().optional().describe('URL to GraphQL schema endpoint (e.g., "/graphql")'),
+    jsonSchema: z.string().optional().describe("URL to JSON Schema definitions")
+  }).optional().describe("Schema discovery endpoints for API toolchain integration"),
   /**
    * Custom metadata key-value pairs for extensibility
    */
   metadata: z.record(z.string(), z.unknown()).optional().describe("Custom metadata key-value pairs for extensibility")
 });
+var WellKnownCapabilitiesSchema = z.object({
+  /** Whether the backend supports Feed / Chatter API */
+  feed: z.boolean().describe("Whether the backend supports Feed / Chatter API"),
+  /** Whether the backend supports comments (a subset of Feed) */
+  comments: z.boolean().describe("Whether the backend supports comments (a subset of Feed)"),
+  /** Whether the backend supports Automation CRUD (flows, triggers) */
+  automation: z.boolean().describe("Whether the backend supports Automation CRUD (flows, triggers)"),
+  /** Whether the backend supports cron scheduling */
+  cron: z.boolean().describe("Whether the backend supports cron scheduling"),
+  /** Whether the backend supports full-text search */
+  search: z.boolean().describe("Whether the backend supports full-text search"),
+  /** Whether the backend supports async export */
+  export: z.boolean().describe("Whether the backend supports async export"),
+  /** Whether the backend supports chunked (multipart) uploads */
+  chunkedUpload: z.boolean().describe("Whether the backend supports chunked (multipart) uploads")
+}).describe("Well-known capability flags for frontend intelligent adaptation");
 var PresenceStatus = z.enum([
   "online",
   // User is actively connected
@@ -27394,7 +27915,8 @@ var GetDiscoveryResponseSchema = z.object({
   version: z.string().describe('API version (e.g., "v1", "2024-01")'),
   apiName: z.string().describe("API name"),
   routes: ApiRoutesSchema.optional().describe("Available endpoint paths"),
-  services: z.record(z.string(), ServiceInfoSchema).optional().describe("Per-service availability map")
+  services: z.record(z.string(), ServiceInfoSchema).optional().describe("Per-service availability map"),
+  capabilities: WellKnownCapabilitiesSchema.optional().describe("Well-known capability flags for frontend adaptation")
 });
 var GetMetaTypesRequestSchema = z.object({});
 var GetMetaTypesResponseSchema = z.object({
@@ -27444,6 +27966,7 @@ var FindDataResponseSchema = z.object({
   object: z.string().describe("The object name for the returned records."),
   records: z.array(z.record(z.string(), z.unknown())).describe("The list of matching records."),
   total: z.number().optional().describe("Total number of records matching the filter (if requested)."),
+  nextCursor: z.string().optional().describe("Cursor for the next page of results (cursor-based pagination)."),
   hasMore: z.boolean().optional().describe("True if there are more records available (pagination).")
 });
 var GetDataRequestSchema = z.object({
@@ -27918,7 +28441,22 @@ var ObjectStackProtocolSchema = z.object({
   // i18n Operations
   getLocales: z.function().describe("Get available locales"),
   getTranslations: z.function().describe("Get translations for a locale"),
-  getFieldLabels: z.function().describe("Get translated field labels for an object")
+  getFieldLabels: z.function().describe("Get translated field labels for an object"),
+  // Feed Operations
+  listFeed: z.function().describe("List feed items for a record"),
+  createFeedItem: z.function().describe("Create a new feed item"),
+  updateFeedItem: z.function().describe("Update an existing feed item"),
+  deleteFeedItem: z.function().describe("Delete a feed item"),
+  addReaction: z.function().describe("Add an emoji reaction to a feed item"),
+  removeReaction: z.function().describe("Remove an emoji reaction from a feed item"),
+  pinFeedItem: z.function().describe("Pin a feed item"),
+  unpinFeedItem: z.function().describe("Unpin a feed item"),
+  starFeedItem: z.function().describe("Star a feed item"),
+  unstarFeedItem: z.function().describe("Unstar a feed item"),
+  searchFeed: z.function().describe("Search feed items"),
+  getChangelog: z.function().describe("Get field-level changelog for a record"),
+  feedSubscribe: z.function().describe("Subscribe to record notifications"),
+  feedUnsubscribe: z.function().describe("Unsubscribe from record notifications")
 });
 var RestApiConfigSchema = z.object({
   /**
@@ -29208,6 +29746,113 @@ var PresignedUrlResponseSchema = BaseResponseSchema.extend({
 var FileUploadResponseSchema = BaseResponseSchema.extend({
   data: FileMetadataSchema.describe("Uploaded file metadata")
 });
+var FileTypeValidationSchema = z.object({
+  mode: z.enum(["whitelist", "blacklist"]).describe("whitelist = only allow listed types, blacklist = block listed types"),
+  mimeTypes: z.array(z.string()).min(1).describe('List of MIME types to allow or block (e.g., "image/jpeg", "application/pdf")'),
+  extensions: z.array(z.string()).optional().describe('List of file extensions to allow or block (e.g., ".jpg", ".pdf")'),
+  maxFileSize: z.number().int().min(1).optional().describe("Maximum file size in bytes"),
+  minFileSize: z.number().int().min(0).optional().describe("Minimum file size in bytes (e.g., reject empty files)")
+});
+var InitiateChunkedUploadRequestSchema = z.object({
+  filename: z.string().describe("Original filename"),
+  mimeType: z.string().describe("File MIME type"),
+  totalSize: z.number().int().min(1).describe("Total file size in bytes"),
+  chunkSize: z.number().int().min(5242880).default(5242880).describe("Size of each chunk in bytes (minimum 5MB per S3 spec)"),
+  scope: z.string().default("user").describe("Target storage scope"),
+  bucket: z.string().optional().describe("Specific bucket override (admin only)"),
+  metadata: z.record(z.string(), z.string()).optional().describe("Custom metadata key-value pairs")
+});
+var InitiateChunkedUploadResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    uploadId: z.string().describe("Multipart upload session ID"),
+    resumeToken: z.string().describe("Opaque token for resuming interrupted uploads"),
+    fileId: z.string().describe("Assigned file ID"),
+    totalChunks: z.number().int().min(1).describe("Expected number of chunks"),
+    chunkSize: z.number().int().describe("Chunk size in bytes"),
+    expiresAt: z.string().datetime().describe("Upload session expiration timestamp")
+  })
+});
+var UploadChunkRequestSchema = z.object({
+  uploadId: z.string().describe("Multipart upload session ID"),
+  chunkIndex: z.number().int().min(0).describe("Zero-based chunk index"),
+  resumeToken: z.string().describe("Resume token from initiate response")
+});
+var UploadChunkResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    chunkIndex: z.number().int().describe("Chunk index that was uploaded"),
+    eTag: z.string().describe("Chunk ETag for multipart completion"),
+    bytesReceived: z.number().int().describe("Bytes received for this chunk")
+  })
+});
+var CompleteChunkedUploadRequestSchema = z.object({
+  uploadId: z.string().describe("Multipart upload session ID"),
+  parts: z.array(z.object({
+    chunkIndex: z.number().int().describe("Chunk index"),
+    eTag: z.string().describe("ETag returned from chunk upload")
+  })).min(1).describe("Ordered list of uploaded parts for assembly")
+});
+var CompleteChunkedUploadResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    fileId: z.string().describe("Final file ID"),
+    key: z.string().describe("Storage key/path of the assembled file"),
+    size: z.number().int().describe("Total file size in bytes"),
+    mimeType: z.string().describe("File MIME type"),
+    eTag: z.string().optional().describe("Final ETag of the assembled file"),
+    url: z.string().optional().describe("Download URL for the assembled file")
+  })
+});
+var UploadProgressSchema = BaseResponseSchema.extend({
+  data: z.object({
+    uploadId: z.string().describe("Multipart upload session ID"),
+    fileId: z.string().describe("Assigned file ID"),
+    filename: z.string().describe("Original filename"),
+    totalSize: z.number().int().describe("Total file size in bytes"),
+    uploadedSize: z.number().int().describe("Bytes uploaded so far"),
+    totalChunks: z.number().int().describe("Total expected chunks"),
+    uploadedChunks: z.number().int().describe("Number of chunks uploaded"),
+    percentComplete: z.number().min(0).max(100).describe("Upload progress percentage"),
+    status: z.enum(["in_progress", "completing", "completed", "failed", "expired"]).describe("Current upload session status"),
+    startedAt: z.string().datetime().describe("Upload session start timestamp"),
+    expiresAt: z.string().datetime().describe("Session expiration timestamp")
+  })
+});
+var StorageApiContracts = {
+  getPresignedUrl: {
+    method: "POST",
+    path: "/api/v1/storage/upload/presigned",
+    input: GetPresignedUrlRequestSchema,
+    output: PresignedUrlResponseSchema
+  },
+  completeUpload: {
+    method: "POST",
+    path: "/api/v1/storage/upload/complete",
+    input: CompleteUploadRequestSchema,
+    output: FileUploadResponseSchema
+  },
+  initiateChunkedUpload: {
+    method: "POST",
+    path: "/api/v1/storage/upload/chunked",
+    input: InitiateChunkedUploadRequestSchema,
+    output: InitiateChunkedUploadResponseSchema
+  },
+  uploadChunk: {
+    method: "PUT",
+    path: "/api/v1/storage/upload/chunked/:uploadId/chunk/:chunkIndex",
+    input: UploadChunkRequestSchema,
+    output: UploadChunkResponseSchema
+  },
+  completeChunkedUpload: {
+    method: "POST",
+    path: "/api/v1/storage/upload/chunked/:uploadId/complete",
+    input: CompleteChunkedUploadRequestSchema,
+    output: CompleteChunkedUploadResponseSchema
+  },
+  getUploadProgress: {
+    method: "GET",
+    path: "/api/v1/storage/upload/chunked/:uploadId/progress",
+    output: UploadProgressSchema
+  }
+};
 var ObjectDefinitionResponseSchema = BaseResponseSchema.extend({
   data: ObjectSchema.describe("Full Object Schema")
 });
@@ -30849,6 +31494,85 @@ var RemoveReactionResponseSchema = BaseResponseSchema.extend({
     reactions: z.array(ReactionSchema).describe("Updated reaction list for the feed item")
   })
 });
+var PinFeedItemRequestSchema = FeedItemPathParamsSchema;
+var PinFeedItemResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    feedId: z.string().describe("ID of the pinned feed item"),
+    pinned: z.boolean().describe("Whether the item is now pinned"),
+    pinnedAt: z.string().datetime().describe("Timestamp when pinned")
+  })
+});
+var UnpinFeedItemRequestSchema = FeedItemPathParamsSchema;
+var UnpinFeedItemResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    feedId: z.string().describe("ID of the unpinned feed item"),
+    pinned: z.boolean().describe("Whether the item is now pinned (should be false)")
+  })
+});
+var StarFeedItemRequestSchema = FeedItemPathParamsSchema;
+var StarFeedItemResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    feedId: z.string().describe("ID of the starred feed item"),
+    starred: z.boolean().describe("Whether the item is now starred"),
+    starredAt: z.string().datetime().describe("Timestamp when starred")
+  })
+});
+var UnstarFeedItemRequestSchema = FeedItemPathParamsSchema;
+var UnstarFeedItemResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    feedId: z.string().describe("ID of the unstarred feed item"),
+    starred: z.boolean().describe("Whether the item is now starred (should be false)")
+  })
+});
+var SearchFeedRequestSchema = FeedPathParamsSchema.extend({
+  query: z.string().min(1).describe("Full-text search query against feed body content"),
+  type: FeedListFilterType.optional().describe("Filter by feed item category"),
+  actorId: z.string().optional().describe("Filter by actor user ID"),
+  dateFrom: z.string().datetime().optional().describe("Filter feed items created after this timestamp"),
+  dateTo: z.string().datetime().optional().describe("Filter feed items created before this timestamp"),
+  hasAttachments: z.boolean().optional().describe("Filter for items with file attachments"),
+  pinnedOnly: z.boolean().optional().describe("Return only pinned items"),
+  starredOnly: z.boolean().optional().describe("Return only starred items"),
+  limit: z.number().int().min(1).max(100).default(20).describe("Maximum number of items to return"),
+  cursor: z.string().optional().describe("Cursor for pagination")
+});
+var SearchFeedResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    items: z.array(FeedItemSchema).describe("Matching feed items sorted by relevance"),
+    total: z.number().int().optional().describe("Total matching items"),
+    nextCursor: z.string().optional().describe("Cursor for the next page"),
+    hasMore: z.boolean().describe("Whether more items are available")
+  })
+});
+var GetChangelogRequestSchema = FeedPathParamsSchema.extend({
+  field: z.string().optional().describe("Filter changelog to a specific field name"),
+  actorId: z.string().optional().describe("Filter changelog by actor user ID"),
+  dateFrom: z.string().datetime().optional().describe("Filter changes after this timestamp"),
+  dateTo: z.string().datetime().optional().describe("Filter changes before this timestamp"),
+  limit: z.number().int().min(1).max(200).default(50).describe("Maximum number of changelog entries to return"),
+  cursor: z.string().optional().describe("Cursor for pagination")
+});
+var ChangelogEntrySchema = z.object({
+  id: z.string().describe("Changelog entry ID"),
+  object: z.string().describe("Object name"),
+  recordId: z.string().describe("Record ID"),
+  actor: z.object({
+    type: z.enum(["user", "system", "service", "automation"]).describe("Actor type"),
+    id: z.string().describe("Actor ID"),
+    name: z.string().optional().describe("Actor display name")
+  }).describe("Who made the change"),
+  changes: z.array(FieldChangeEntrySchema).min(1).describe("Field-level changes"),
+  timestamp: z.string().datetime().describe("When the change occurred"),
+  source: z.string().optional().describe('Change source (e.g., "API", "UI", "automation")')
+});
+var GetChangelogResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    entries: z.array(ChangelogEntrySchema).describe("Changelog entries in reverse chronological order"),
+    total: z.number().int().optional().describe("Total changelog entries matching filter"),
+    nextCursor: z.string().optional().describe("Cursor for the next page"),
+    hasMore: z.boolean().describe("Whether more entries are available")
+  })
+});
 var SubscribeRequestSchema = FeedPathParamsSchema.extend({
   events: z.array(SubscriptionEventType).default(["all"]).describe("Event types to subscribe to"),
   channels: z.array(NotificationChannel).default(["in_app"]).describe("Notification delivery channels")
@@ -30873,7 +31597,12 @@ var FeedApiErrorCode = z.enum([
   "reaction_not_found",
   "subscription_already_exists",
   "subscription_not_found",
-  "invalid_feed_type"
+  "invalid_feed_type",
+  "feed_already_pinned",
+  "feed_not_pinned",
+  "feed_already_starred",
+  "feed_not_starred",
+  "feed_search_query_too_short"
 ]);
 var FeedApiContracts = {
   listFeed: {
@@ -30912,6 +31641,42 @@ var FeedApiContracts = {
     input: RemoveReactionRequestSchema,
     output: RemoveReactionResponseSchema
   },
+  pinFeedItem: {
+    method: "POST",
+    path: "/api/data/:object/:recordId/feed/:feedId/pin",
+    input: PinFeedItemRequestSchema,
+    output: PinFeedItemResponseSchema
+  },
+  unpinFeedItem: {
+    method: "DELETE",
+    path: "/api/data/:object/:recordId/feed/:feedId/pin",
+    input: UnpinFeedItemRequestSchema,
+    output: UnpinFeedItemResponseSchema
+  },
+  starFeedItem: {
+    method: "POST",
+    path: "/api/data/:object/:recordId/feed/:feedId/star",
+    input: StarFeedItemRequestSchema,
+    output: StarFeedItemResponseSchema
+  },
+  unstarFeedItem: {
+    method: "DELETE",
+    path: "/api/data/:object/:recordId/feed/:feedId/star",
+    input: UnstarFeedItemRequestSchema,
+    output: UnstarFeedItemResponseSchema
+  },
+  searchFeed: {
+    method: "GET",
+    path: "/api/data/:object/:recordId/feed/search",
+    input: SearchFeedRequestSchema,
+    output: SearchFeedResponseSchema
+  },
+  getChangelog: {
+    method: "GET",
+    path: "/api/data/:object/:recordId/changelog",
+    input: GetChangelogRequestSchema,
+    output: GetChangelogResponseSchema
+  },
   subscribe: {
     method: "POST",
     path: "/api/data/:object/:recordId/subscribe",
@@ -30925,74 +31690,256 @@ var FeedApiContracts = {
     output: UnsubscribeResponseSchema
   }
 };
-
-// src/automation/index.ts
-var automation_exports = {};
-__export(automation_exports, {
-  ActionRefSchema: () => ActionRefSchema,
-  ApprovalActionSchema: () => ApprovalActionSchema,
-  ApprovalActionType: () => ApprovalActionType,
-  ApprovalProcess: () => ApprovalProcess,
-  ApprovalProcessSchema: () => ApprovalProcessSchema,
-  ApprovalStepSchema: () => ApprovalStepSchema,
-  ApproverType: () => ApproverType,
-  AuthFieldSchema: () => AuthFieldSchema,
-  AuthenticationSchema: () => AuthenticationSchema,
-  AuthenticationTypeSchema: () => AuthenticationTypeSchema,
-  ConflictResolutionSchema: () => ConflictResolutionSchema2,
-  Connector: () => Connector,
-  ConnectorActionRefSchema: () => ConnectorActionRefSchema,
-  ConnectorCategorySchema: () => ConnectorCategorySchema,
-  ConnectorInstanceSchema: () => ConnectorInstanceSchema,
-  ConnectorOperationSchema: () => ConnectorOperationSchema,
-  ConnectorSchema: () => ConnectorSchema,
-  ConnectorTriggerSchema: () => ConnectorTriggerSchema,
-  CustomScriptActionSchema: () => CustomScriptActionSchema,
-  DataDestinationConfigSchema: () => DataDestinationConfigSchema,
-  DataSourceConfigSchema: () => DataSourceConfigSchema,
-  DataSyncConfigSchema: () => DataSyncConfigSchema,
-  ETL: () => ETL,
-  ETLDestinationSchema: () => ETLDestinationSchema,
-  ETLEndpointTypeSchema: () => ETLEndpointTypeSchema,
-  ETLPipelineRunSchema: () => ETLPipelineRunSchema,
-  ETLPipelineSchema: () => ETLPipelineSchema,
-  ETLRunStatusSchema: () => ETLRunStatusSchema,
-  ETLSourceSchema: () => ETLSourceSchema,
-  ETLSyncModeSchema: () => ETLSyncModeSchema,
-  ETLTransformationSchema: () => ETLTransformationSchema,
-  ETLTransformationTypeSchema: () => ETLTransformationTypeSchema,
-  EmailAlertActionSchema: () => EmailAlertActionSchema,
-  EventSchema: () => EventSchema,
-  FieldUpdateActionSchema: () => FieldUpdateActionSchema,
-  FlowEdgeSchema: () => FlowEdgeSchema,
-  FlowNodeAction: () => FlowNodeAction,
-  FlowNodeSchema: () => FlowNodeSchema,
-  FlowSchema: () => FlowSchema,
-  FlowVariableSchema: () => FlowVariableSchema,
-  GuardRefSchema: () => GuardRefSchema,
-  HttpCallActionSchema: () => HttpCallActionSchema,
-  OAuth2ConfigSchema: () => OAuth2ConfigSchema,
-  OperationParameterSchema: () => OperationParameterSchema,
-  OperationTypeSchema: () => OperationTypeSchema,
-  PushNotificationActionSchema: () => PushNotificationActionSchema,
-  StateMachineSchema: () => StateMachineSchema,
-  StateNodeSchema: () => StateNodeSchema,
-  Sync: () => Sync,
-  SyncDirectionSchema: () => SyncDirectionSchema,
-  SyncExecutionResultSchema: () => SyncExecutionResultSchema,
-  SyncExecutionStatusSchema: () => SyncExecutionStatusSchema,
-  SyncModeSchema: () => SyncModeSchema,
-  TaskCreationActionSchema: () => TaskCreationActionSchema,
-  TimeTriggerSchema: () => TimeTriggerSchema,
-  TransitionSchema: () => TransitionSchema,
-  WebhookReceiverSchema: () => WebhookReceiverSchema,
-  WebhookSchema: () => WebhookSchema,
-  WebhookTriggerType: () => WebhookTriggerType,
-  WorkflowActionSchema: () => WorkflowActionSchema,
-  WorkflowRuleSchema: () => WorkflowRuleSchema,
-  WorkflowTriggerType: () => WorkflowTriggerType,
-  defineFlow: () => defineFlow
+var ExportFormat = z.enum([
+  "csv",
+  "json",
+  "jsonl",
+  "xlsx",
+  "parquet"
+]);
+var ExportJobStatus = z.enum([
+  "pending",
+  "processing",
+  "completed",
+  "failed",
+  "cancelled",
+  "expired"
+]);
+var CreateExportJobRequestSchema = z.object({
+  object: z.string().describe("Object name to export"),
+  format: ExportFormat.default("csv").describe("Export file format"),
+  fields: z.array(z.string()).optional().describe("Specific fields to include (omit for all fields)"),
+  filter: z.record(z.string(), z.unknown()).optional().describe("Filter criteria for records to export"),
+  sort: z.array(z.object({
+    field: z.string().describe("Field name to sort by"),
+    direction: z.enum(["asc", "desc"]).default("asc").describe("Sort direction")
+  })).optional().describe("Sort order for exported records"),
+  limit: z.number().int().min(1).optional().describe("Maximum number of records to export"),
+  includeHeaders: z.boolean().default(true).describe("Include header row (CSV/XLSX)"),
+  encoding: z.string().default("utf-8").describe("Character encoding for the export file"),
+  templateId: z.string().optional().describe("Export template ID for predefined field mappings")
+});
+var CreateExportJobResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    jobId: z.string().describe("Export job ID"),
+    status: ExportJobStatus.describe("Initial job status"),
+    estimatedRecords: z.number().int().optional().describe("Estimated total records"),
+    createdAt: z.string().datetime().describe("Job creation timestamp")
+  })
+});
+var ExportJobProgressSchema = BaseResponseSchema.extend({
+  data: z.object({
+    jobId: z.string().describe("Export job ID"),
+    status: ExportJobStatus.describe("Current job status"),
+    format: ExportFormat.describe("Export format"),
+    totalRecords: z.number().int().optional().describe("Total records to export"),
+    processedRecords: z.number().int().describe("Records processed so far"),
+    percentComplete: z.number().min(0).max(100).describe("Export progress percentage"),
+    fileSize: z.number().int().optional().describe("Current file size in bytes"),
+    downloadUrl: z.string().optional().describe('Presigned download URL (available when status is "completed")'),
+    downloadExpiresAt: z.string().datetime().optional().describe("Download URL expiration timestamp"),
+    error: z.object({
+      code: z.string().describe("Error code"),
+      message: z.string().describe("Error message")
+    }).optional().describe("Error details if job failed"),
+    startedAt: z.string().datetime().optional().describe("Processing start timestamp"),
+    completedAt: z.string().datetime().optional().describe("Completion timestamp")
+  })
+});
+var ImportValidationMode = z.enum([
+  "strict",
+  // Reject entire import on any validation error
+  "lenient",
+  // Skip invalid records, import valid ones
+  "dry_run"
+  // Validate all records without persisting
+]);
+var DeduplicationStrategy = z.enum([
+  "skip",
+  // Skip duplicates (keep existing)
+  "update",
+  // Update existing with import data
+  "create_new",
+  // Create new record even if duplicate
+  "fail"
+  // Fail the import if duplicates found
+]);
+var ImportValidationConfigSchema = z.object({
+  mode: ImportValidationMode.default("strict").describe("Validation mode for the import"),
+  deduplication: z.object({
+    strategy: DeduplicationStrategy.default("skip").describe("How to handle duplicate records"),
+    matchFields: z.array(z.string()).min(1).describe('Fields used to identify duplicates (e.g., "email", "external_id")')
+  }).optional().describe("Deduplication configuration"),
+  maxErrors: z.number().int().min(1).default(100).describe("Maximum validation errors before aborting"),
+  trimWhitespace: z.boolean().default(true).describe("Trim leading/trailing whitespace from string fields"),
+  dateFormat: z.string().optional().describe('Expected date format in import data (e.g., "YYYY-MM-DD")'),
+  nullValues: z.array(z.string()).optional().describe('Strings to treat as null (e.g., ["", "N/A", "null"])')
+});
+var ImportValidationResultSchema = BaseResponseSchema.extend({
+  data: z.object({
+    totalRecords: z.number().int().describe("Total records in import file"),
+    validRecords: z.number().int().describe("Records that passed validation"),
+    invalidRecords: z.number().int().describe("Records that failed validation"),
+    duplicateRecords: z.number().int().describe("Duplicate records detected"),
+    errors: z.array(z.object({
+      row: z.number().int().describe("Row number in the import file"),
+      field: z.string().optional().describe("Field that failed validation"),
+      code: z.string().describe("Validation error code"),
+      message: z.string().describe("Validation error message")
+    })).describe("List of validation errors"),
+    preview: z.array(z.record(z.string(), z.unknown())).optional().describe("Preview of first N valid records (for dry_run mode)")
+  })
+});
+var FieldMappingEntrySchema = z.object({
+  sourceField: z.string().describe("Field name in the source data (import) or object (export)"),
+  targetField: z.string().describe("Field name in the target object (import) or file column (export)"),
+  targetLabel: z.string().optional().describe("Display label for the target column (export)"),
+  transform: z.enum(["none", "uppercase", "lowercase", "trim", "date_format", "lookup"]).default("none").describe("Transformation to apply during mapping"),
+  defaultValue: z.unknown().optional().describe("Default value if source field is null/empty"),
+  required: z.boolean().default(false).describe("Whether this field is required (import validation)")
+});
+var ExportImportTemplateSchema = z.object({
+  id: z.string().optional().describe("Template ID (generated on save)"),
+  name: z.string().regex(/^[a-z_][a-z0-9_]*$/).describe("Template machine name (snake_case)"),
+  label: z.string().describe("Human-readable template label"),
+  description: z.string().optional().describe("Template description"),
+  object: z.string().describe("Target object name"),
+  direction: z.enum(["import", "export", "bidirectional"]).describe("Template direction"),
+  format: ExportFormat.optional().describe("Default file format for this template"),
+  mappings: z.array(FieldMappingEntrySchema).min(1).describe("Field mapping entries"),
+  createdAt: z.string().datetime().optional().describe("Template creation timestamp"),
+  updatedAt: z.string().datetime().optional().describe("Last update timestamp"),
+  createdBy: z.string().optional().describe("User who created the template")
+});
+var ScheduledExportSchema = z.object({
+  id: z.string().optional().describe("Scheduled export ID"),
+  name: z.string().regex(/^[a-z_][a-z0-9_]*$/).describe("Schedule name (snake_case)"),
+  label: z.string().optional().describe("Human-readable label"),
+  object: z.string().describe("Object name to export"),
+  format: ExportFormat.default("csv").describe("Export file format"),
+  fields: z.array(z.string()).optional().describe("Fields to include"),
+  filter: z.record(z.string(), z.unknown()).optional().describe("Record filter criteria"),
+  templateId: z.string().optional().describe("Export template ID for field mappings"),
+  schedule: z.object({
+    cronExpression: z.string().describe("Cron expression for schedule"),
+    timezone: z.string().default("UTC").describe("IANA timezone")
+  }).describe("Schedule timing configuration"),
+  delivery: z.object({
+    method: z.enum(["email", "storage", "webhook"]).describe("How to deliver the export file"),
+    recipients: z.array(z.string()).optional().describe("Email recipients (for email delivery)"),
+    storagePath: z.string().optional().describe("Storage path (for storage delivery)"),
+    webhookUrl: z.string().optional().describe("Webhook URL (for webhook delivery)")
+  }).describe("Export delivery configuration"),
+  enabled: z.boolean().default(true).describe("Whether the scheduled export is active"),
+  lastRunAt: z.string().datetime().optional().describe("Last execution timestamp"),
+  nextRunAt: z.string().datetime().optional().describe("Next scheduled execution"),
+  createdAt: z.string().datetime().optional().describe("Creation timestamp"),
+  createdBy: z.string().optional().describe("User who created the schedule")
+});
+var GetExportJobDownloadRequestSchema = z.object({
+  jobId: z.string().describe("Export job ID")
+});
+var GetExportJobDownloadResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    jobId: z.string().describe("Export job ID"),
+    downloadUrl: z.string().describe("Presigned download URL"),
+    fileName: z.string().describe("Suggested file name"),
+    fileSize: z.number().int().describe("File size in bytes"),
+    format: ExportFormat.describe("Export file format"),
+    expiresAt: z.string().datetime().describe("Download URL expiration timestamp"),
+    checksum: z.string().optional().describe("File checksum (SHA-256)")
+  })
+});
+var ListExportJobsRequestSchema = z.object({
+  object: z.string().optional().describe("Filter by object name"),
+  status: ExportJobStatus.optional().describe("Filter by job status"),
+  limit: z.number().int().min(1).max(100).default(20).describe("Maximum number of jobs to return"),
+  cursor: z.string().optional().describe("Pagination cursor from a previous response")
+});
+var ExportJobSummarySchema = z.object({
+  jobId: z.string().describe("Export job ID"),
+  object: z.string().describe("Object name that was exported"),
+  status: ExportJobStatus.describe("Current job status"),
+  format: ExportFormat.describe("Export file format"),
+  totalRecords: z.number().int().optional().describe("Total records exported"),
+  fileSize: z.number().int().optional().describe("File size in bytes"),
+  createdAt: z.string().datetime().describe("Job creation timestamp"),
+  completedAt: z.string().datetime().optional().describe("Completion timestamp"),
+  createdBy: z.string().optional().describe("User who initiated the export")
+});
+var ListExportJobsResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    jobs: z.array(ExportJobSummarySchema).describe("List of export jobs"),
+    nextCursor: z.string().optional().describe("Cursor for the next page"),
+    hasMore: z.boolean().describe("Whether more jobs are available")
+  })
 });
+var ScheduleExportRequestSchema = z.object({
+  name: z.string().regex(/^[a-z_][a-z0-9_]*$/).describe("Schedule name (snake_case)"),
+  label: z.string().optional().describe("Human-readable label"),
+  object: z.string().describe("Object name to export"),
+  format: ExportFormat.default("csv").describe("Export file format"),
+  fields: z.array(z.string()).optional().describe("Fields to include"),
+  filter: z.record(z.string(), z.unknown()).optional().describe("Record filter criteria"),
+  templateId: z.string().optional().describe("Export template ID for field mappings"),
+  schedule: z.object({
+    cronExpression: z.string().describe("Cron expression for schedule"),
+    timezone: z.string().default("UTC").describe("IANA timezone")
+  }).describe("Schedule timing configuration"),
+  delivery: z.object({
+    method: z.enum(["email", "storage", "webhook"]).describe("How to deliver the export file"),
+    recipients: z.array(z.string()).optional().describe("Email recipients (for email delivery)"),
+    storagePath: z.string().optional().describe("Storage path (for storage delivery)"),
+    webhookUrl: z.string().optional().describe("Webhook URL (for webhook delivery)")
+  }).describe("Export delivery configuration")
+});
+var ScheduleExportResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    id: z.string().describe("Scheduled export ID"),
+    name: z.string().describe("Schedule name"),
+    enabled: z.boolean().describe("Whether the schedule is active"),
+    nextRunAt: z.string().datetime().optional().describe("Next scheduled execution"),
+    createdAt: z.string().datetime().describe("Creation timestamp")
+  })
+});
+var ExportApiContracts = {
+  createExportJob: {
+    method: "POST",
+    path: "/api/v1/data/:object/export",
+    input: CreateExportJobRequestSchema,
+    output: CreateExportJobResponseSchema
+  },
+  getExportJobProgress: {
+    method: "GET",
+    path: "/api/v1/data/export/:jobId",
+    input: z.object({ jobId: z.string() }),
+    output: ExportJobProgressSchema
+  },
+  getExportJobDownload: {
+    method: "GET",
+    path: "/api/v1/data/export/:jobId/download",
+    input: GetExportJobDownloadRequestSchema,
+    output: GetExportJobDownloadResponseSchema
+  },
+  listExportJobs: {
+    method: "GET",
+    path: "/api/v1/data/export",
+    input: ListExportJobsRequestSchema,
+    output: ListExportJobsResponseSchema
+  },
+  scheduleExport: {
+    method: "POST",
+    path: "/api/v1/data/export/schedules",
+    input: ScheduleExportRequestSchema,
+    output: ScheduleExportResponseSchema
+  },
+  cancelExportJob: {
+    method: "POST",
+    path: "/api/v1/data/export/:jobId/cancel",
+    input: z.object({ jobId: z.string() }),
+    output: BaseResponseSchema
+  }
+};
 var FlowNodeAction = z.enum([
   "start",
   // Trigger
@@ -31022,8 +31969,14 @@ var FlowNodeAction = z.enum([
   // Delay/Sleep
   "subflow",
   // Call another flow
-  "connector_action"
+  "connector_action",
   // Zapier-style integration action
+  "parallel_gateway",
+  // BPMN Parallel Gateway — AND-split (all outgoing branches execute concurrently)
+  "join_gateway",
+  // BPMN Join Gateway — AND-join (waits for all incoming branches to complete)
+  "boundary_event"
+  // BPMN Boundary Event — attached to a host node for timer/error/signal interrupts
 ]);
 var FlowVariableSchema = z.object({
   name: z.string().describe("Variable name"),
@@ -31047,7 +32000,56 @@ var FlowNodeSchema = z.object({
     input: z.record(z.string(), z.unknown()).describe("Mapped inputs for the action")
   }).optional(),
   /** UI Position (for the canvas) */
-  position: z.object({ x: z.number(), y: z.number() }).optional()
+  position: z.object({ x: z.number(), y: z.number() }).optional(),
+  /** Node-level execution timeout */
+  timeoutMs: z.number().int().min(0).optional().describe("Maximum execution time for this node in milliseconds"),
+  /** Node input schema declaration for Studio form generation and runtime validation */
+  inputSchema: z.record(z.string(), z.object({
+    type: z.enum(["string", "number", "boolean", "object", "array"]).describe("Parameter type"),
+    required: z.boolean().default(false).describe("Whether the parameter is required"),
+    description: z.string().optional().describe("Parameter description")
+  })).optional().describe("Input parameter schema for this node"),
+  /** Node output schema declaration */
+  outputSchema: z.record(z.string(), z.object({
+    type: z.enum(["string", "number", "boolean", "object", "array"]).describe("Output type"),
+    description: z.string().optional().describe("Output description")
+  })).optional().describe("Output schema declaration for this node"),
+  /**
+   * Wait Event Configuration (for 'wait' nodes)
+   * Defines what external event or condition should resume the paused execution.
+   * Industry alignment: BPMN Intermediate Catch Events, Temporal Signals.
+   */
+  waitEventConfig: z.object({
+    /** Type of event to wait for */
+    eventType: z.enum(["timer", "signal", "webhook", "manual", "condition"]).describe("What kind of event resumes the execution"),
+    /** Duration to wait (ISO 8601 duration or milliseconds) — for timer events */
+    timerDuration: z.string().optional().describe('ISO 8601 duration (e.g., "PT1H") or wait time for timer events'),
+    /** Signal name to listen for — for signal/webhook events */
+    signalName: z.string().optional().describe("Named signal or webhook event to wait for"),
+    /** Timeout before auto-failing or continuing — optional guard */
+    timeoutMs: z.number().int().min(0).optional().describe("Maximum wait time before timeout (ms)"),
+    /** Action to take on timeout */
+    onTimeout: z.enum(["fail", "continue"]).default("fail").describe("Behavior when the wait times out")
+  }).optional().describe("Configuration for wait node event resumption"),
+  /**
+   * Boundary Event Configuration (for 'boundary_event' nodes)
+   * Attaches an event handler to a host activity node (BPMN Boundary Event pattern).
+   * Industry alignment: BPMN Boundary Error/Timer/Signal Events.
+   */
+  boundaryConfig: z.object({
+    /** ID of the host node this boundary event is attached to */
+    attachedToNodeId: z.string().describe("Host node ID this boundary event monitors"),
+    /** Type of boundary event */
+    eventType: z.enum(["error", "timer", "signal", "cancel"]).describe("Boundary event trigger type"),
+    /** Whether the boundary event interrupts the host activity */
+    interrupting: z.boolean().default(true).describe("If true, the host activity is cancelled when this event fires"),
+    /** Error code filter — only for error boundary events */
+    errorCode: z.string().optional().describe("Specific error code to catch (empty = catch all errors)"),
+    /** Timer duration — only for timer boundary events */
+    timerDuration: z.string().optional().describe("ISO 8601 duration for timer boundary events"),
+    /** Signal name — only for signal boundary events */
+    signalName: z.string().optional().describe("Named signal to catch")
+  }).optional().describe("Configuration for boundary events attached to host nodes")
 });
 var FlowEdgeSchema = z.object({
   id: z.string().describe("Edge unique ID"),
@@ -31055,8 +32057,14 @@ var FlowEdgeSchema = z.object({
   target: z.string().describe("Target Node ID"),
   /** Condition for this path (only for decision/branch nodes) */
   condition: z.string().optional().describe("Expression returning boolean used for branching"),
-  type: z.enum(["default", "fault"]).default("default").describe("Connection type: Standard (Success) or Fault (Error) path"),
-  label: z.string().optional().describe("Label on the connector")
+  type: z.enum(["default", "fault", "conditional"]).default("default").describe("Connection type: default (normal flow), fault (error path), or conditional (expression-guarded)"),
+  label: z.string().optional().describe("Label on the connector"),
+  /**
+   * Default Sequence Flow marker (BPMN Default Flow semantics).
+   * When true, this edge is taken when no sibling conditional edges match.
+   * Only meaningful on outgoing edges of decision/gateway nodes.
+   */
+  isDefault: z.boolean().default(false).describe("Marks this edge as the default path when no other conditions match")
 });
 var FlowSchema = z.object({
   /** Identity */
@@ -31082,12 +32090,611 @@ var FlowSchema = z.object({
     strategy: z.enum(["fail", "retry", "continue"]).default("fail").describe("How to handle node execution errors"),
     maxRetries: z.number().int().min(0).max(10).default(0).describe("Number of retry attempts (only for retry strategy)"),
     retryDelayMs: z.number().int().min(0).default(1e3).describe("Delay between retries in milliseconds"),
+    backoffMultiplier: z.number().min(1).default(1).describe("Multiplier for exponential backoff between retries"),
+    maxRetryDelayMs: z.number().int().min(0).default(3e4).describe("Maximum delay between retries in milliseconds"),
+    jitter: z.boolean().default(false).describe("Add random jitter to retry delay to avoid thundering herd"),
     fallbackNodeId: z.string().optional().describe("Node ID to jump to on unrecoverable error")
   }).optional().describe("Flow-level error handling configuration")
 });
 function defineFlow(config) {
   return FlowSchema.parse(config);
 }
+var FlowVersionHistorySchema = z.object({
+  flowName: z.string().describe("Flow machine name"),
+  version: z.number().int().min(1).describe("Version number"),
+  definition: FlowSchema.describe("Complete flow definition snapshot"),
+  createdAt: z.string().datetime().describe("When this version was created"),
+  createdBy: z.string().optional().describe("User who created this version"),
+  changeNote: z.string().optional().describe("Description of what changed in this version")
+});
+var ExecutionStatus = z.enum([
+  "pending",
+  // Queued, not yet started
+  "running",
+  // Currently executing
+  "paused",
+  // Paused at a wait/checkpoint node
+  "completed",
+  // Successfully finished
+  "failed",
+  // Terminated with error
+  "cancelled",
+  // Manually cancelled
+  "timed_out",
+  // Exceeded max execution time
+  "retrying"
+  // Failed and retrying
+]);
+var ExecutionStepLogSchema = z.object({
+  nodeId: z.string().describe("Node ID that was executed"),
+  nodeType: z.string().describe('Node action type (e.g., "decision", "http_request")'),
+  nodeLabel: z.string().optional().describe("Human-readable node label"),
+  status: z.enum(["success", "failure", "skipped"]).describe("Step execution result"),
+  startedAt: z.string().datetime().describe("When the step started"),
+  completedAt: z.string().datetime().optional().describe("When the step completed"),
+  durationMs: z.number().int().min(0).optional().describe("Step execution duration in milliseconds"),
+  input: z.record(z.string(), z.unknown()).optional().describe("Input data passed to the node"),
+  output: z.record(z.string(), z.unknown()).optional().describe("Output data produced by the node"),
+  error: z.object({
+    code: z.string().describe("Error code"),
+    message: z.string().describe("Error message"),
+    stack: z.string().optional().describe("Stack trace")
+  }).optional().describe("Error details if step failed"),
+  retryAttempt: z.number().int().min(0).optional().describe("Retry attempt number (0 = first try)")
+});
+var ExecutionLogSchema = z.object({
+  /** Unique execution ID */
+  id: z.string().describe("Execution instance ID"),
+  /** Flow reference */
+  flowName: z.string().describe("Machine name of the executed flow"),
+  flowVersion: z.number().int().optional().describe("Version of the flow that was executed"),
+  /** Execution status */
+  status: ExecutionStatus.describe("Current execution status"),
+  /** Trigger context */
+  trigger: z.object({
+    type: z.string().describe('Trigger type (e.g., "record_change", "schedule", "api", "manual")'),
+    recordId: z.string().optional().describe("Triggering record ID"),
+    object: z.string().optional().describe("Triggering object name"),
+    userId: z.string().optional().describe("User who triggered the execution"),
+    metadata: z.record(z.string(), z.unknown()).optional().describe("Additional trigger context")
+  }).describe("What triggered this execution"),
+  /** Step-by-step execution history */
+  steps: z.array(ExecutionStepLogSchema).describe("Ordered list of executed steps"),
+  /** Execution variables snapshot */
+  variables: z.record(z.string(), z.unknown()).optional().describe("Final state of flow variables"),
+  /** Timing */
+  startedAt: z.string().datetime().describe("Execution start timestamp"),
+  completedAt: z.string().datetime().optional().describe("Execution completion timestamp"),
+  durationMs: z.number().int().min(0).optional().describe("Total execution duration in milliseconds"),
+  /** Context */
+  runAs: z.enum(["system", "user"]).optional().describe("Execution context identity"),
+  tenantId: z.string().optional().describe("Tenant ID for multi-tenant isolation")
+});
+var ExecutionErrorSeverity = z.enum([
+  "warning",
+  // Non-fatal issue (e.g., deprecated node type)
+  "error",
+  // Node-level failure (may be retried)
+  "critical"
+  // Flow-level failure (execution terminated)
+]);
+var ExecutionErrorSchema = z.object({
+  id: z.string().describe("Error record ID"),
+  executionId: z.string().describe("Parent execution ID"),
+  nodeId: z.string().optional().describe("Node where the error occurred"),
+  severity: ExecutionErrorSeverity.describe("Error severity level"),
+  code: z.string().describe("Machine-readable error code"),
+  message: z.string().describe("Human-readable error message"),
+  stack: z.string().optional().describe("Stack trace for debugging"),
+  context: z.record(z.string(), z.unknown()).optional().describe("Additional diagnostic context (input data, config snapshot)"),
+  timestamp: z.string().datetime().describe("When the error occurred"),
+  retryable: z.boolean().default(false).describe("Whether this error can be retried"),
+  resolvedAt: z.string().datetime().optional().describe("When the error was resolved (e.g., after successful retry)")
+});
+var CheckpointSchema = z.object({
+  /** Unique checkpoint ID */
+  id: z.string().describe("Checkpoint ID"),
+  /** Execution reference */
+  executionId: z.string().describe("Parent execution ID"),
+  flowName: z.string().describe("Flow machine name"),
+  /** State snapshot */
+  currentNodeId: z.string().describe("Node ID where execution is paused"),
+  variables: z.record(z.string(), z.unknown()).describe("Flow variable state at checkpoint"),
+  completedNodeIds: z.array(z.string()).describe("List of node IDs already executed"),
+  /** Timing */
+  createdAt: z.string().datetime().describe("Checkpoint creation timestamp"),
+  expiresAt: z.string().datetime().optional().describe("Checkpoint expiration (auto-cleanup)"),
+  /** Reason */
+  reason: z.enum(["wait", "screen_input", "approval", "error", "manual_pause", "parallel_join", "boundary_event"]).describe("Why the execution was checkpointed")
+});
+var ConcurrencyPolicySchema = z.object({
+  /** Maximum concurrent executions of this flow */
+  maxConcurrent: z.number().int().min(1).default(1).describe("Maximum number of concurrent executions allowed"),
+  /** What to do when max concurrency is reached */
+  onConflict: z.enum(["queue", "reject", "cancel_existing"]).default("queue").describe("queue = enqueue for later, reject = fail immediately, cancel_existing = stop running instance"),
+  /** Lock scope for concurrency */
+  lockScope: z.enum(["global", "per_record", "per_user"]).default("global").describe("Scope of the concurrency lock"),
+  /** Queue timeout (only when onConflict is "queue") */
+  queueTimeoutMs: z.number().int().min(0).optional().describe("Maximum time to wait in queue before timing out (ms)")
+});
+var ScheduleStateSchema = z.object({
+  /** Unique schedule ID */
+  id: z.string().describe("Schedule instance ID"),
+  /** Flow reference */
+  flowName: z.string().describe("Flow machine name"),
+  /** Schedule configuration */
+  cronExpression: z.string().describe('Cron expression (e.g., "0 9 * * MON-FRI")'),
+  timezone: z.string().default("UTC").describe("IANA timezone for cron evaluation"),
+  /** Runtime state */
+  status: z.enum(["active", "paused", "disabled", "expired"]).default("active").describe("Current schedule status"),
+  nextRunAt: z.string().datetime().optional().describe("Next scheduled execution timestamp"),
+  lastRunAt: z.string().datetime().optional().describe("Last execution timestamp"),
+  lastExecutionId: z.string().optional().describe("Execution ID of the last run"),
+  lastRunStatus: ExecutionStatus.optional().describe("Status of the last run"),
+  /** Execution tracking */
+  totalRuns: z.number().int().min(0).default(0).describe("Total number of executions"),
+  consecutiveFailures: z.number().int().min(0).default(0).describe("Consecutive failed executions"),
+  /** Bounds */
+  startDate: z.string().datetime().optional().describe("Schedule effective start date"),
+  endDate: z.string().datetime().optional().describe("Schedule expiration date"),
+  maxRuns: z.number().int().min(1).optional().describe("Maximum total executions before auto-disable"),
+  /** Metadata */
+  createdAt: z.string().datetime().describe("Schedule creation timestamp"),
+  updatedAt: z.string().datetime().optional().describe("Last update timestamp"),
+  createdBy: z.string().optional().describe("User who created the schedule")
+});
+
+// src/api/automation-api.zod.ts
+var AutomationFlowPathParamsSchema = z.object({
+  name: z.string().describe("Flow machine name (snake_case)")
+});
+var AutomationRunPathParamsSchema = AutomationFlowPathParamsSchema.extend({
+  runId: z.string().describe("Execution run ID")
+});
+var ListFlowsRequestSchema = z.object({
+  status: z.enum(["draft", "active", "obsolete", "invalid"]).optional().describe("Filter by flow status"),
+  type: z.enum(["autolaunched", "record_change", "schedule", "screen", "api"]).optional().describe("Filter by flow type"),
+  limit: z.number().int().min(1).max(100).default(50).describe("Maximum number of flows to return"),
+  cursor: z.string().optional().describe("Cursor for pagination")
+});
+var FlowSummarySchema = z.object({
+  name: z.string().describe("Flow machine name"),
+  label: z.string().describe("Flow display label"),
+  type: z.string().describe("Flow type"),
+  status: z.string().describe("Flow deployment status"),
+  version: z.number().int().describe("Flow version number"),
+  enabled: z.boolean().describe("Whether the flow is enabled for execution"),
+  nodeCount: z.number().int().optional().describe("Number of nodes in the flow"),
+  lastRunAt: z.string().datetime().optional().describe("Last execution timestamp")
+});
+var ListFlowsResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    flows: z.array(FlowSummarySchema).describe("Flow summaries"),
+    total: z.number().int().optional().describe("Total matching flows"),
+    nextCursor: z.string().optional().describe("Cursor for the next page"),
+    hasMore: z.boolean().describe("Whether more flows are available")
+  })
+});
+var GetFlowRequestSchema = AutomationFlowPathParamsSchema;
+var GetFlowResponseSchema = BaseResponseSchema.extend({
+  data: FlowSchema.describe("Full flow definition")
+});
+var CreateFlowRequestSchema = FlowSchema;
+var CreateFlowResponseSchema = BaseResponseSchema.extend({
+  data: FlowSchema.describe("The created flow definition")
+});
+var UpdateFlowRequestSchema = AutomationFlowPathParamsSchema.extend({
+  definition: FlowSchema.partial().describe("Partial flow definition to update")
+});
+var UpdateFlowResponseSchema = BaseResponseSchema.extend({
+  data: FlowSchema.describe("The updated flow definition")
+});
+var DeleteFlowRequestSchema = AutomationFlowPathParamsSchema;
+var DeleteFlowResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    name: z.string().describe("Name of the deleted flow"),
+    deleted: z.boolean().describe("Whether the flow was deleted")
+  })
+});
+var TriggerFlowRequestSchema = AutomationFlowPathParamsSchema.extend({
+  record: z.record(z.string(), z.unknown()).optional().describe("Record that triggered the automation"),
+  object: z.string().optional().describe("Object name the record belongs to"),
+  event: z.string().optional().describe("Trigger event type"),
+  userId: z.string().optional().describe("User who triggered the automation"),
+  params: z.record(z.string(), z.unknown()).optional().describe("Additional contextual data")
+});
+var TriggerFlowResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    success: z.boolean().describe("Whether the automation completed successfully"),
+    output: z.unknown().optional().describe("Output data from the automation"),
+    error: z.string().optional().describe("Error message if execution failed"),
+    durationMs: z.number().optional().describe("Execution duration in milliseconds")
+  })
+});
+var ToggleFlowRequestSchema = AutomationFlowPathParamsSchema.extend({
+  enabled: z.boolean().describe("Whether to enable (true) or disable (false) the flow")
+});
+var ToggleFlowResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    name: z.string().describe("Flow name"),
+    enabled: z.boolean().describe("New enabled state")
+  })
+});
+var ListRunsRequestSchema = AutomationFlowPathParamsSchema.extend({
+  status: z.enum(["pending", "running", "paused", "completed", "failed", "cancelled", "timed_out", "retrying"]).optional().describe("Filter by execution status"),
+  limit: z.number().int().min(1).max(100).default(20).describe("Maximum number of runs to return"),
+  cursor: z.string().optional().describe("Cursor for pagination")
+});
+var ListRunsResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    runs: z.array(ExecutionLogSchema).describe("Execution run logs"),
+    total: z.number().int().optional().describe("Total matching runs"),
+    nextCursor: z.string().optional().describe("Cursor for the next page"),
+    hasMore: z.boolean().describe("Whether more runs are available")
+  })
+});
+var GetRunRequestSchema = AutomationRunPathParamsSchema;
+var GetRunResponseSchema = BaseResponseSchema.extend({
+  data: ExecutionLogSchema.describe("Full execution log with step details")
+});
+var AutomationApiErrorCode = z.enum([
+  "flow_not_found",
+  "flow_already_exists",
+  "flow_validation_failed",
+  "flow_disabled",
+  "execution_not_found",
+  "execution_failed",
+  "execution_timeout",
+  "node_executor_not_found",
+  "concurrent_execution_limit"
+]);
+var AutomationApiContracts = {
+  listFlows: {
+    method: "GET",
+    path: "/api/automation",
+    input: ListFlowsRequestSchema,
+    output: ListFlowsResponseSchema
+  },
+  getFlow: {
+    method: "GET",
+    path: "/api/automation/:name",
+    input: GetFlowRequestSchema,
+    output: GetFlowResponseSchema
+  },
+  createFlow: {
+    method: "POST",
+    path: "/api/automation",
+    input: CreateFlowRequestSchema,
+    output: CreateFlowResponseSchema
+  },
+  updateFlow: {
+    method: "PUT",
+    path: "/api/automation/:name",
+    input: UpdateFlowRequestSchema,
+    output: UpdateFlowResponseSchema
+  },
+  deleteFlow: {
+    method: "DELETE",
+    path: "/api/automation/:name",
+    input: DeleteFlowRequestSchema,
+    output: DeleteFlowResponseSchema
+  },
+  triggerFlow: {
+    method: "POST",
+    path: "/api/automation/:name/trigger",
+    input: TriggerFlowRequestSchema,
+    output: TriggerFlowResponseSchema
+  },
+  toggleFlow: {
+    method: "POST",
+    path: "/api/automation/:name/toggle",
+    input: ToggleFlowRequestSchema,
+    output: ToggleFlowResponseSchema
+  },
+  listRuns: {
+    method: "GET",
+    path: "/api/automation/:name/runs",
+    input: ListRunsRequestSchema,
+    output: ListRunsResponseSchema
+  },
+  getRun: {
+    method: "GET",
+    path: "/api/automation/:name/runs/:runId",
+    input: GetRunRequestSchema,
+    output: GetRunResponseSchema
+  }
+};
+var PackagePathParamsSchema = z.object({
+  packageId: z.string().describe("Package identifier")
+});
+var ListInstalledPackagesRequestSchema = z.object({
+  /** Filter by package status */
+  status: z.enum(["installed", "disabled", "installing", "upgrading", "uninstalling", "error"]).optional().describe("Filter by package status"),
+  /** Filter by enabled state */
+  enabled: z.boolean().optional().describe("Filter by enabled state"),
+  /** Maximum number of packages to return */
+  limit: z.number().int().min(1).max(100).default(50).describe("Maximum number of packages to return"),
+  /** Cursor for pagination */
+  cursor: z.string().optional().describe("Cursor for pagination")
+}).describe("List installed packages request");
+var ListInstalledPackagesResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    packages: z.array(InstalledPackageSchema).describe("Installed packages"),
+    total: z.number().int().optional().describe("Total matching packages"),
+    nextCursor: z.string().optional().describe("Cursor for the next page"),
+    hasMore: z.boolean().describe("Whether more packages are available")
+  })
+}).describe("List installed packages response");
+var GetInstalledPackageRequestSchema = PackagePathParamsSchema;
+var GetInstalledPackageResponseSchema = BaseResponseSchema.extend({
+  data: InstalledPackageSchema.describe("Installed package details")
+}).describe("Get installed package response");
+var PackageInstallRequestSchema = z.object({
+  /** Package manifest to install */
+  manifest: ManifestSchema.describe("Package manifest to install"),
+  /** User-provided settings at install time */
+  settings: z.record(z.string(), z.unknown()).optional().describe("User-provided settings at install time"),
+  /** Whether to enable immediately after install */
+  enableOnInstall: z.boolean().default(true).describe("Whether to enable immediately after install"),
+  /** Current platform version for compatibility verification */
+  platformVersion: z.string().optional().describe("Current platform version for compatibility verification"),
+  /** Artifact reference for the package (if installing from marketplace) */
+  artifactRef: ArtifactReferenceSchema.optional().describe("Artifact reference for marketplace installation")
+}).describe("Install package request");
+var PackageInstallResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    package: InstalledPackageSchema.describe("Installed package details"),
+    dependencyResolution: DependencyResolutionResultSchema.optional().describe("Dependency resolution result"),
+    namespaceConflicts: z.array(z.object({
+      type: z.literal("namespace_conflict").describe("Error type"),
+      requestedNamespace: z.string().describe("Requested namespace"),
+      conflictingPackageId: z.string().describe("Conflicting package ID"),
+      conflictingPackageName: z.string().describe("Conflicting package name"),
+      suggestion: z.string().optional().describe("Suggested alternative")
+    })).optional().describe("Namespace conflicts detected"),
+    message: z.string().optional().describe("Installation status message")
+  })
+}).describe("Install package response");
+var PackageUpgradeRequestSchema = z.object({
+  /** Package ID to upgrade */
+  packageId: z.string().describe("Package ID to upgrade"),
+  /** Target version (defaults to latest) */
+  targetVersion: z.string().optional().describe("Target version (defaults to latest)"),
+  /** New manifest for the target version */
+  manifest: ManifestSchema.optional().describe("New manifest for the target version"),
+  /** Whether to create a pre-upgrade snapshot */
+  createSnapshot: z.boolean().default(true).describe("Whether to create a pre-upgrade backup snapshot"),
+  /** Merge strategy for handling customizations */
+  mergeStrategy: z.enum(["keep-custom", "accept-incoming", "three-way-merge"]).default("three-way-merge").describe("How to handle customer customizations"),
+  /** Preview upgrade without making changes */
+  dryRun: z.boolean().default(false).describe("Preview upgrade without making changes"),
+  /** Skip pre-upgrade compatibility checks */
+  skipValidation: z.boolean().default(false).describe("Skip pre-upgrade compatibility checks")
+}).describe("Upgrade package request");
+var PackageUpgradeResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    success: z.boolean().describe("Whether the upgrade succeeded"),
+    phase: z.string().describe("Current upgrade phase"),
+    plan: UpgradePlanSchema.optional().describe("Upgrade plan that was executed"),
+    snapshotId: z.string().optional().describe("Snapshot ID for rollback"),
+    conflicts: z.array(z.object({
+      path: z.string().describe("Conflict path"),
+      baseValue: z.unknown().describe("Base value"),
+      incomingValue: z.unknown().describe("Incoming value"),
+      customValue: z.unknown().describe("Custom value")
+    })).optional().describe("Unresolved merge conflicts"),
+    errorMessage: z.string().optional().describe("Error message if failed"),
+    message: z.string().optional().describe("Human-readable status message")
+  })
+}).describe("Upgrade package response");
+var ResolveDependenciesRequestSchema = z.object({
+  /** Package manifest whose dependencies to resolve */
+  manifest: ManifestSchema.describe("Package manifest to resolve dependencies for"),
+  /** Current platform version for compatibility checking */
+  platformVersion: z.string().optional().describe("Current platform version for compatibility filtering")
+}).describe("Resolve dependencies request");
+var ResolveDependenciesResponseSchema = BaseResponseSchema.extend({
+  data: DependencyResolutionResultSchema.describe("Dependency resolution result with topological sort")
+}).describe("Resolve dependencies response");
+var UploadArtifactRequestSchema = z.object({
+  /** Artifact metadata */
+  artifact: PackageArtifactSchema.describe("Package artifact metadata"),
+  /** SHA256 checksum of the uploaded file (for verification) */
+  sha256: z.string().regex(/^[a-f0-9]{64}$/).optional().describe("SHA256 checksum of the uploaded file"),
+  /** Publisher authentication token */
+  token: z.string().optional().describe("Publisher authentication token"),
+  /** Release notes for this version */
+  releaseNotes: z.string().optional().describe("Release notes for this version")
+}).describe("Upload artifact request");
+var UploadArtifactResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    /** Whether the upload succeeded */
+    success: z.boolean().describe("Whether the upload succeeded"),
+    /** Artifact reference for the uploaded package */
+    artifactRef: ArtifactReferenceSchema.optional().describe("Artifact reference in the registry"),
+    /** Submission ID for review tracking */
+    submissionId: z.string().optional().describe("Marketplace submission ID for review tracking"),
+    /** Message */
+    message: z.string().optional().describe("Upload status message")
+  })
+}).describe("Upload artifact response");
+var PackageRollbackRequestSchema = PackagePathParamsSchema.extend({
+  /** Snapshot ID to restore from */
+  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 PackageRollbackResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    success: z.boolean().describe("Whether the rollback succeeded"),
+    restoredVersion: z.string().optional().describe("Restored version"),
+    message: z.string().optional().describe("Rollback status message")
+  })
+}).describe("Rollback package response");
+var UninstallPackageApiRequestSchema = PackagePathParamsSchema;
+var UninstallPackageApiResponseSchema = BaseResponseSchema.extend({
+  data: z.object({
+    packageId: 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 PackageApiErrorCode = z.enum([
+  "package_not_found",
+  "package_already_installed",
+  "version_not_found",
+  "dependency_conflict",
+  "namespace_conflict",
+  "platform_incompatible",
+  "artifact_invalid",
+  "checksum_mismatch",
+  "signature_invalid",
+  "upgrade_failed",
+  "rollback_failed",
+  "snapshot_not_found",
+  "upload_failed"
+]);
+var PackageApiContracts = {
+  listPackages: {
+    method: "GET",
+    path: "/api/v1/packages",
+    input: ListInstalledPackagesRequestSchema,
+    output: ListInstalledPackagesResponseSchema
+  },
+  getPackage: {
+    method: "GET",
+    path: "/api/v1/packages/:packageId",
+    input: GetInstalledPackageRequestSchema,
+    output: GetInstalledPackageResponseSchema
+  },
+  installPackage: {
+    method: "POST",
+    path: "/api/v1/packages/install",
+    input: PackageInstallRequestSchema,
+    output: PackageInstallResponseSchema
+  },
+  upgradePackage: {
+    method: "POST",
+    path: "/api/v1/packages/upgrade",
+    input: PackageUpgradeRequestSchema,
+    output: PackageUpgradeResponseSchema
+  },
+  resolveDependencies: {
+    method: "POST",
+    path: "/api/v1/packages/resolve-dependencies",
+    input: ResolveDependenciesRequestSchema,
+    output: ResolveDependenciesResponseSchema
+  },
+  uploadArtifact: {
+    method: "POST",
+    path: "/api/v1/packages/upload",
+    input: UploadArtifactRequestSchema,
+    output: UploadArtifactResponseSchema
+  },
+  rollbackPackage: {
+    method: "POST",
+    path: "/api/v1/packages/:packageId/rollback",
+    input: PackageRollbackRequestSchema,
+    output: PackageRollbackResponseSchema
+  },
+  uninstallPackage: {
+    method: "DELETE",
+    path: "/api/v1/packages/:packageId",
+    input: UninstallPackageApiRequestSchema,
+    output: UninstallPackageApiResponseSchema
+  }
+};
+
+// src/automation/index.ts
+var automation_exports = {};
+__export(automation_exports, {
+  ActionRefSchema: () => ActionRefSchema,
+  ApprovalActionSchema: () => ApprovalActionSchema,
+  ApprovalActionType: () => ApprovalActionType,
+  ApprovalProcess: () => ApprovalProcess,
+  ApprovalProcessSchema: () => ApprovalProcessSchema,
+  ApprovalStepSchema: () => ApprovalStepSchema,
+  ApproverType: () => ApproverType,
+  AuthFieldSchema: () => AuthFieldSchema,
+  AuthenticationSchema: () => AuthenticationSchema,
+  AuthenticationTypeSchema: () => AuthenticationTypeSchema,
+  BUILT_IN_BPMN_MAPPINGS: () => BUILT_IN_BPMN_MAPPINGS,
+  BpmnDiagnosticSchema: () => BpmnDiagnosticSchema,
+  BpmnElementMappingSchema: () => BpmnElementMappingSchema,
+  BpmnExportOptionsSchema: () => BpmnExportOptionsSchema,
+  BpmnImportOptionsSchema: () => BpmnImportOptionsSchema,
+  BpmnInteropResultSchema: () => BpmnInteropResultSchema,
+  BpmnUnmappedStrategySchema: () => BpmnUnmappedStrategySchema,
+  BpmnVersionSchema: () => BpmnVersionSchema,
+  CheckpointSchema: () => CheckpointSchema,
+  ConcurrencyPolicySchema: () => ConcurrencyPolicySchema,
+  ConflictResolutionSchema: () => ConflictResolutionSchema2,
+  Connector: () => Connector,
+  ConnectorActionRefSchema: () => ConnectorActionRefSchema,
+  ConnectorCategorySchema: () => ConnectorCategorySchema,
+  ConnectorInstanceSchema: () => ConnectorInstanceSchema,
+  ConnectorOperationSchema: () => ConnectorOperationSchema,
+  ConnectorSchema: () => ConnectorSchema,
+  ConnectorTriggerSchema: () => ConnectorTriggerSchema,
+  CustomScriptActionSchema: () => CustomScriptActionSchema,
+  DataDestinationConfigSchema: () => DataDestinationConfigSchema,
+  DataSourceConfigSchema: () => DataSourceConfigSchema,
+  DataSyncConfigSchema: () => DataSyncConfigSchema,
+  ETL: () => ETL,
+  ETLDestinationSchema: () => ETLDestinationSchema,
+  ETLEndpointTypeSchema: () => ETLEndpointTypeSchema,
+  ETLPipelineRunSchema: () => ETLPipelineRunSchema,
+  ETLPipelineSchema: () => ETLPipelineSchema,
+  ETLRunStatusSchema: () => ETLRunStatusSchema,
+  ETLSourceSchema: () => ETLSourceSchema,
+  ETLSyncModeSchema: () => ETLSyncModeSchema,
+  ETLTransformationSchema: () => ETLTransformationSchema,
+  ETLTransformationTypeSchema: () => ETLTransformationTypeSchema,
+  EmailAlertActionSchema: () => EmailAlertActionSchema,
+  EventSchema: () => EventSchema,
+  ExecutionErrorSchema: () => ExecutionErrorSchema,
+  ExecutionErrorSeverity: () => ExecutionErrorSeverity,
+  ExecutionLogSchema: () => ExecutionLogSchema,
+  ExecutionStatus: () => ExecutionStatus,
+  ExecutionStepLogSchema: () => ExecutionStepLogSchema,
+  FieldUpdateActionSchema: () => FieldUpdateActionSchema,
+  FlowEdgeSchema: () => FlowEdgeSchema,
+  FlowNodeAction: () => FlowNodeAction,
+  FlowNodeSchema: () => FlowNodeSchema,
+  FlowSchema: () => FlowSchema,
+  FlowVariableSchema: () => FlowVariableSchema,
+  FlowVersionHistorySchema: () => FlowVersionHistorySchema,
+  GuardRefSchema: () => GuardRefSchema,
+  HttpCallActionSchema: () => HttpCallActionSchema,
+  NodeExecutorDescriptorSchema: () => NodeExecutorDescriptorSchema,
+  OAuth2ConfigSchema: () => OAuth2ConfigSchema,
+  OperationParameterSchema: () => OperationParameterSchema,
+  OperationTypeSchema: () => OperationTypeSchema,
+  PushNotificationActionSchema: () => PushNotificationActionSchema,
+  ScheduleStateSchema: () => ScheduleStateSchema,
+  StateMachineSchema: () => StateMachineSchema,
+  StateNodeSchema: () => StateNodeSchema,
+  Sync: () => Sync,
+  SyncDirectionSchema: () => SyncDirectionSchema,
+  SyncExecutionResultSchema: () => SyncExecutionResultSchema,
+  SyncExecutionStatusSchema: () => SyncExecutionStatusSchema,
+  SyncModeSchema: () => SyncModeSchema,
+  TaskCreationActionSchema: () => TaskCreationActionSchema,
+  TimeTriggerSchema: () => TimeTriggerSchema,
+  TransitionSchema: () => TransitionSchema,
+  WAIT_EXECUTOR_DESCRIPTOR: () => WAIT_EXECUTOR_DESCRIPTOR,
+  WaitEventTypeSchema: () => WaitEventTypeSchema,
+  WaitExecutorConfigSchema: () => WaitExecutorConfigSchema,
+  WaitResumePayloadSchema: () => WaitResumePayloadSchema,
+  WaitTimeoutBehaviorSchema: () => WaitTimeoutBehaviorSchema,
+  WebhookReceiverSchema: () => WebhookReceiverSchema,
+  WebhookSchema: () => WebhookSchema,
+  WebhookTriggerType: () => WebhookTriggerType,
+  WorkflowActionSchema: () => WorkflowActionSchema,
+  WorkflowRuleSchema: () => WorkflowRuleSchema,
+  WorkflowTriggerType: () => WorkflowTriggerType,
+  defineFlow: () => defineFlow
+});
 var WebhookTriggerType = z.enum([
   "create",
   "update",
@@ -32272,6 +33879,179 @@ var Sync = {
     enabled: true
   })
 };
+var WaitEventTypeSchema = z.enum([
+  "timer",
+  // Resume after duration/datetime
+  "signal",
+  // Resume on named signal dispatch
+  "webhook",
+  // Resume on incoming webhook call
+  "manual",
+  // Resume by manual operator action
+  "condition"
+  // Resume when a data condition is met (polling)
+]).describe("Wait event type determining how a paused flow is resumed");
+var WaitResumePayloadSchema = z.object({
+  /** The execution id of the paused flow */
+  executionId: z.string().describe("Execution ID of the paused flow"),
+  /** The checkpoint id being resumed */
+  checkpointId: z.string().describe("Checkpoint ID to resume from"),
+  /** The node id of the wait node being resumed */
+  nodeId: z.string().describe("Wait node ID being resumed"),
+  /** The event type that triggered the resume */
+  eventType: WaitEventTypeSchema.describe("Event type that triggered resume"),
+  /** Signal name (for signal events) */
+  signalName: z.string().optional().describe("Signal name (when eventType is signal)"),
+  /** Webhook payload data (for webhook events) */
+  webhookPayload: z.record(z.string(), z.unknown()).optional().describe("Webhook request payload (when eventType is webhook)"),
+  /** Who/what triggered the resume */
+  resumedBy: z.string().optional().describe("User ID or system identifier that triggered resume"),
+  /** Timestamp of the resume event */
+  resumedAt: z.string().datetime().describe("ISO 8601 timestamp of the resume event"),
+  /** Additional variables to merge into flow context on resume */
+  variables: z.record(z.string(), z.unknown()).optional().describe("Variables to merge into flow context upon resume")
+}).describe("Payload for resuming a paused wait node");
+var WaitTimeoutBehaviorSchema = z.enum([
+  "fail",
+  // Mark execution as failed
+  "continue",
+  // Continue to next node (skip wait)
+  "fallback"
+  // Execute a fallback edge
+]).describe("Behavior when a wait node exceeds its timeout");
+var WaitExecutorConfigSchema = z.object({
+  /** Default timeout for wait nodes without explicit timeout (ms) */
+  defaultTimeoutMs: z.number().int().min(0).default(864e5).describe("Default timeout in ms (default: 24 hours)"),
+  /** Default timeout behavior */
+  defaultTimeoutBehavior: WaitTimeoutBehaviorSchema.default("fail").describe("Default behavior when wait timeout is exceeded"),
+  /** Polling interval for condition-based waits (ms) */
+  conditionPollIntervalMs: z.number().int().min(1e3).default(3e4).describe("Polling interval for condition waits in ms (default: 30s)"),
+  /** Maximum polling attempts for condition waits (0 = unlimited until timeout) */
+  conditionMaxPolls: z.number().int().min(0).default(0).describe("Max polling attempts for condition waits (0 = unlimited)"),
+  /** Webhook endpoint URL pattern (runtime fills in execution/node ids) */
+  webhookUrlPattern: z.string().default("/api/v1/automation/resume/{executionId}/{nodeId}").describe("URL pattern for webhook resume endpoints"),
+  /** Whether to persist checkpoints to durable storage */
+  persistCheckpoints: z.boolean().default(true).describe("Persist wait checkpoints to durable storage"),
+  /** Maximum concurrent paused executions (0 = unlimited) */
+  maxPausedExecutions: z.number().int().min(0).default(0).describe("Max concurrent paused executions (0 = unlimited)")
+}).describe("Wait node executor plugin configuration");
+var NodeExecutorDescriptorSchema = z.object({
+  /** Unique executor identifier */
+  id: z.string().describe("Unique executor plugin identifier"),
+  /** Human-readable name */
+  name: z.string().describe("Display name"),
+  /** The FlowNodeAction types this executor handles */
+  nodeTypes: z.array(z.string()).min(1).describe("FlowNodeAction types this executor handles"),
+  /** Executor plugin version (semver) */
+  version: z.string().describe("Plugin version (semver)"),
+  /** Description of the executor */
+  description: z.string().optional().describe("Executor description"),
+  /** Whether this executor supports async pause/resume */
+  supportsPause: z.boolean().default(false).describe("Whether the executor supports async pause/resume"),
+  /** Whether this executor supports cancellation mid-execution */
+  supportsCancellation: z.boolean().default(false).describe("Whether the executor supports mid-execution cancellation"),
+  /** Whether this executor supports retry on failure */
+  supportsRetry: z.boolean().default(true).describe("Whether the executor supports retry on failure"),
+  /** Executor-specific configuration schema (JSON Schema reference) */
+  configSchemaRef: z.string().optional().describe("JSON Schema $ref for executor-specific config")
+}).describe("Node executor plugin descriptor");
+var WAIT_EXECUTOR_DESCRIPTOR = {
+  id: "objectstack:wait-executor",
+  name: "Wait Node Executor",
+  nodeTypes: ["wait"],
+  version: "1.0.0",
+  description: "Pauses flow execution and resumes on timer, signal, webhook, manual action, or condition events.",
+  supportsPause: true,
+  supportsCancellation: true,
+  supportsRetry: true
+};
+var BpmnElementMappingSchema = z.object({
+  /** BPMN XML element type (e.g., "bpmn:parallelGateway", "bpmn:serviceTask") */
+  bpmnType: z.string().describe('BPMN XML element type (e.g., "bpmn:parallelGateway")'),
+  /** Corresponding ObjectStack FlowNodeAction */
+  flowNodeAction: z.string().describe("ObjectStack FlowNodeAction value"),
+  /** Whether this mapping is bidirectional (supports both import and export) */
+  bidirectional: z.boolean().default(true).describe("Whether the mapping supports both import and export"),
+  /** Notes about mapping limitations or special handling */
+  notes: z.string().optional().describe("Notes about mapping limitations")
+}).describe("Mapping between BPMN XML element and ObjectStack FlowNodeAction");
+var BpmnUnmappedStrategySchema = z.enum([
+  "skip",
+  // Skip unmapped elements silently
+  "warn",
+  // Import with warnings
+  "error",
+  // Fail on unmapped elements
+  "comment"
+  // Import as annotation/comment nodes
+]).describe("Strategy for unmapped BPMN elements during import");
+var BpmnImportOptionsSchema = z.object({
+  /** Strategy for unmapped BPMN elements */
+  unmappedStrategy: BpmnUnmappedStrategySchema.default("warn").describe("How to handle unmapped BPMN elements"),
+  /** Custom element mappings (override or extend built-in mappings) */
+  customMappings: z.array(BpmnElementMappingSchema).optional().describe("Custom element mappings to override or extend defaults"),
+  /** Whether to import BPMN DI (diagram interchange) layout positions */
+  importLayout: z.boolean().default(true).describe("Import BPMN DI layout positions into canvas node coordinates"),
+  /** Whether to import BPMN documentation as node descriptions */
+  importDocumentation: z.boolean().default(true).describe("Import BPMN documentation elements as node descriptions"),
+  /** Target flow name (if not derived from BPMN process name) */
+  flowName: z.string().optional().describe("Override flow name (defaults to BPMN process name)"),
+  /** Whether to validate the imported flow against ObjectStack schema */
+  validateAfterImport: z.boolean().default(true).describe("Validate imported flow against FlowSchema after import")
+}).describe("Options for importing BPMN 2.0 XML into an ObjectStack flow");
+var BpmnVersionSchema = z.enum([
+  "2.0",
+  // BPMN 2.0 (most common, default)
+  "2.0.2"
+  // BPMN 2.0.2 (latest revision)
+]).describe("BPMN specification version for export");
+var BpmnExportOptionsSchema = z.object({
+  /** Target BPMN version */
+  version: BpmnVersionSchema.default("2.0").describe("Target BPMN specification version"),
+  /** Whether to include BPMN DI (diagram interchange) layout data */
+  includeLayout: z.boolean().default(true).describe("Include BPMN DI layout data from canvas positions"),
+  /** Whether to include ObjectStack-specific extensions as BPMN extension elements */
+  includeExtensions: z.boolean().default(false).describe("Include ObjectStack extensions in BPMN extensionElements"),
+  /** Custom element mappings (override built-in for export) */
+  customMappings: z.array(BpmnElementMappingSchema).optional().describe("Custom element mappings for export"),
+  /** Whether to pretty-print the XML output */
+  prettyPrint: z.boolean().default(true).describe("Pretty-print XML output with indentation"),
+  /** XML namespace prefix for BPMN elements */
+  namespacePrefix: z.string().default("bpmn").describe("XML namespace prefix for BPMN elements")
+}).describe("Options for exporting an ObjectStack flow as BPMN 2.0 XML");
+var BpmnDiagnosticSchema = z.object({
+  /** Severity level */
+  severity: z.enum(["info", "warning", "error"]).describe("Diagnostic severity"),
+  /** Human-readable message */
+  message: z.string().describe("Diagnostic message"),
+  /** BPMN element ID (if applicable) */
+  bpmnElementId: z.string().optional().describe("BPMN element ID related to this diagnostic"),
+  /** ObjectStack node ID (if applicable) */
+  nodeId: z.string().optional().describe("ObjectStack node ID related to this diagnostic")
+}).describe("Diagnostic message from BPMN import/export");
+var BpmnInteropResultSchema = z.object({
+  /** Whether the operation completed successfully */
+  success: z.boolean().describe("Whether the operation completed successfully"),
+  /** Diagnostic messages (warnings, errors, info) */
+  diagnostics: z.array(BpmnDiagnosticSchema).default([]).describe("Diagnostic messages from the operation"),
+  /** Number of elements successfully mapped */
+  mappedCount: z.number().int().min(0).default(0).describe("Number of elements successfully mapped"),
+  /** Number of elements skipped or unmapped */
+  unmappedCount: z.number().int().min(0).default(0).describe("Number of elements that could not be mapped")
+}).describe("Result of a BPMN import/export operation");
+var BUILT_IN_BPMN_MAPPINGS = [
+  { bpmnType: "bpmn:startEvent", flowNodeAction: "start", bidirectional: true },
+  { bpmnType: "bpmn:endEvent", flowNodeAction: "end", bidirectional: true },
+  { bpmnType: "bpmn:exclusiveGateway", flowNodeAction: "decision", bidirectional: true },
+  { bpmnType: "bpmn:parallelGateway", flowNodeAction: "parallel_gateway", bidirectional: true },
+  { bpmnType: "bpmn:serviceTask", flowNodeAction: "http_request", bidirectional: true, notes: "Maps HTTP/connector tasks" },
+  { bpmnType: "bpmn:scriptTask", flowNodeAction: "script", bidirectional: true },
+  { bpmnType: "bpmn:userTask", flowNodeAction: "screen", bidirectional: true },
+  { bpmnType: "bpmn:callActivity", flowNodeAction: "subflow", bidirectional: true },
+  { bpmnType: "bpmn:intermediateCatchEvent", flowNodeAction: "wait", bidirectional: true, notes: "Timer/signal/message catch events" },
+  { bpmnType: "bpmn:boundaryEvent", flowNodeAction: "boundary_event", bidirectional: true },
+  { bpmnType: "bpmn:task", flowNodeAction: "assignment", bidirectional: true, notes: "Generic BPMN task maps to assignment" }
+];
 
 // src/integration/index.ts
 var integration_exports = {};
@@ -34774,6 +36554,7 @@ __export(studio_exports, {
   ActionContributionSchema: () => ActionContributionSchema,
   ActionLocationSchema: () => ActionLocationSchema,
   ActivationEventSchema: () => ActivationEventSchema2,
+  BUILT_IN_NODE_DESCRIPTORS: () => BUILT_IN_NODE_DESCRIPTORS,
   CanvasSnapSettingsSchema: () => CanvasSnapSettingsSchema,
   CanvasZoomSettingsSchema: () => CanvasZoomSettingsSchema,
   CommandContributionSchema: () => CommandContributionSchema,
@@ -34784,6 +36565,14 @@ __export(studio_exports, {
   FieldEditorConfigSchema: () => FieldEditorConfigSchema,
   FieldGroupSchema: () => FieldGroupSchema,
   FieldPropertySectionSchema: () => FieldPropertySectionSchema,
+  FlowBuilderConfigSchema: () => FlowBuilderConfigSchema,
+  FlowCanvasEdgeSchema: () => FlowCanvasEdgeSchema,
+  FlowCanvasEdgeStyleSchema: () => FlowCanvasEdgeStyleSchema,
+  FlowCanvasNodeSchema: () => FlowCanvasNodeSchema,
+  FlowLayoutAlgorithmSchema: () => FlowLayoutAlgorithmSchema,
+  FlowLayoutDirectionSchema: () => FlowLayoutDirectionSchema,
+  FlowNodeRenderDescriptorSchema: () => FlowNodeRenderDescriptorSchema,
+  FlowNodeShapeSchema: () => FlowNodeShapeSchema,
   InterfaceBuilderConfigSchema: () => InterfaceBuilderConfigSchema,
   MetadataIconContributionSchema: () => MetadataIconContributionSchema,
   MetadataViewerContributionSchema: () => MetadataViewerContributionSchema,
@@ -34804,6 +36593,7 @@ __export(studio_exports, {
   StudioPluginContributionsSchema: () => StudioPluginContributionsSchema,
   StudioPluginManifestSchema: () => StudioPluginManifestSchema,
   ViewModeSchema: () => ViewModeSchema,
+  defineFlowBuilderConfig: () => defineFlowBuilderConfig,
   defineObjectDesignerConfig: () => defineObjectDesignerConfig,
   defineStudioPlugin: () => defineStudioPlugin
 });
@@ -35288,6 +37078,169 @@ var PageBuilderConfigSchema = z.object({
   undoLimit: z.number().int().min(1).default(50).describe("Maximum undo history steps")
 });
 var InterfaceBuilderConfigSchema = PageBuilderConfigSchema;
+var FlowNodeShapeSchema = z.enum([
+  "rounded_rect",
+  // Default activity shape (assignments, CRUD, HTTP, script, subflow)
+  "circle",
+  // Start / End events
+  "diamond",
+  // Decision (XOR gateway)
+  "parallelogram",
+  // Loop / iteration
+  "hexagon",
+  // Wait / timer event
+  "diamond_thick",
+  // Parallel gateway (AND-split) & Join gateway (AND-join)
+  "attached_circle",
+  // Boundary event (attached to host node)
+  "screen_rect"
+  // Screen / user-interaction node
+]).describe("Visual shape for rendering a flow node on the canvas");
+var FlowNodeRenderDescriptorSchema = z.object({
+  /** The node action type this descriptor applies to */
+  action: z.string().describe('FlowNodeAction value (e.g., "parallel_gateway")'),
+  /** Visual shape on the canvas */
+  shape: FlowNodeShapeSchema.describe("Shape to render"),
+  /** Lucide icon name displayed inside the node */
+  icon: z.string().describe("Lucide icon name"),
+  /** Default label shown on the node when no user label is set */
+  defaultLabel: z.string().describe("Default display label"),
+  /** Default width in canvas pixels */
+  defaultWidth: z.number().int().min(20).default(120).describe("Default width in pixels"),
+  /** Default height in canvas pixels */
+  defaultHeight: z.number().int().min(20).default(60).describe("Default height in pixels"),
+  /** CSS color for the node fill */
+  fillColor: z.string().default("#ffffff").describe("Node fill color (CSS value)"),
+  /** CSS color for the node border */
+  borderColor: z.string().default("#94a3b8").describe("Node border color (CSS value)"),
+  /** Whether this node type can have boundary events attached */
+  allowBoundaryEvents: z.boolean().default(false).describe("Whether boundary events can be attached to this node type"),
+  /** Category for palette grouping */
+  paletteCategory: z.enum(["event", "gateway", "activity", "data", "subflow"]).describe("Palette category for grouping")
+}).describe("Visual render descriptor for a flow node type");
+var FlowCanvasNodeSchema = z.object({
+  /** Reference to the flow node id */
+  nodeId: z.string().describe("Corresponding FlowNode.id"),
+  /** X position on the canvas (pixels) */
+  x: z.number().describe("X position on canvas"),
+  /** Y position on the canvas (pixels) */
+  y: z.number().describe("Y position on canvas"),
+  /** Width override (pixels, optional — uses descriptor default) */
+  width: z.number().int().min(20).optional().describe("Width override in pixels"),
+  /** Height override (pixels, optional — uses descriptor default) */
+  height: z.number().int().min(20).optional().describe("Height override in pixels"),
+  /** Whether the node is collapsed (hides internal details) */
+  collapsed: z.boolean().default(false).describe("Whether the node is collapsed"),
+  /** Custom fill color override */
+  fillColor: z.string().optional().describe("Fill color override"),
+  /** Custom border color override */
+  borderColor: z.string().optional().describe("Border color override"),
+  /** User-defined comment/annotation visible on canvas */
+  annotation: z.string().optional().describe("User annotation displayed near the node")
+}).describe("Canvas layout data for a flow node");
+var FlowCanvasEdgeStyleSchema = z.enum([
+  "solid",
+  // Normal sequence flow
+  "dashed",
+  // Default sequence flow (isDefault: true)
+  "dotted",
+  // Conditional edge
+  "bold"
+  // Fault / error edge
+]).describe("Edge line style");
+var FlowCanvasEdgeSchema = z.object({
+  /** Reference to the flow edge id */
+  edgeId: z.string().describe("Corresponding FlowEdge.id"),
+  /** Line style */
+  style: FlowCanvasEdgeStyleSchema.default("solid").describe("Line style"),
+  /** Line color (CSS value) */
+  color: z.string().default("#94a3b8").describe("Edge line color"),
+  /** Label position along the edge (0–1, 0.5 = midpoint) */
+  labelPosition: z.number().min(0).max(1).default(0.5).describe("Position of the condition label along the edge"),
+  /** Optional waypoints for routing the edge around nodes */
+  waypoints: z.array(z.object({
+    x: z.number().describe("Waypoint X"),
+    y: z.number().describe("Waypoint Y")
+  })).optional().describe("Manual waypoints for edge routing"),
+  /** Whether to show an animated flow indicator */
+  animated: z.boolean().default(false).describe("Show animated flow indicator")
+}).describe("Canvas layout and visual data for a flow edge");
+var FlowLayoutAlgorithmSchema = z.enum([
+  "dagre",
+  // Directed acyclic graph layout (top-down or left-right)
+  "elk",
+  // Eclipse Layout Kernel (advanced hierarchical)
+  "force",
+  // Force-directed graph
+  "manual"
+  // User-positioned (no auto-layout)
+]).describe("Auto-layout algorithm for the flow canvas");
+var FlowLayoutDirectionSchema = z.enum([
+  "TB",
+  // Top to bottom
+  "BT",
+  // Bottom to top
+  "LR",
+  // Left to right
+  "RL"
+  // Right to left
+]).describe("Auto-layout direction");
+var FlowBuilderConfigSchema = z.object({
+  /** Canvas snap settings */
+  snap: z.object({
+    enabled: z.boolean().default(true).describe("Enable snap-to-grid"),
+    gridSize: z.number().int().min(1).default(16).describe("Snap grid size in pixels"),
+    showGrid: z.boolean().default(true).describe("Show grid overlay")
+  }).default({ enabled: true, gridSize: 16, showGrid: true }).describe("Canvas snap-to-grid settings"),
+  /** Canvas zoom settings */
+  zoom: z.object({
+    min: z.number().min(0.1).default(0.25).describe("Minimum zoom level"),
+    max: z.number().max(10).default(3).describe("Maximum zoom level"),
+    default: z.number().default(1).describe("Default zoom level"),
+    step: z.number().default(0.1).describe("Zoom step")
+  }).default({ min: 0.25, max: 3, default: 1, step: 0.1 }).describe("Canvas zoom settings"),
+  /** Auto-layout algorithm */
+  layoutAlgorithm: FlowLayoutAlgorithmSchema.default("dagre").describe("Default auto-layout algorithm"),
+  /** Auto-layout direction */
+  layoutDirection: FlowLayoutDirectionSchema.default("TB").describe("Default auto-layout direction"),
+  /** Node render descriptors (override defaults per node type) */
+  nodeDescriptors: z.array(FlowNodeRenderDescriptorSchema).optional().describe("Custom node render descriptors (merged with built-in defaults)"),
+  /** Show minimap for navigation */
+  showMinimap: z.boolean().default(true).describe("Show minimap panel"),
+  /** Show the node property panel */
+  showPropertyPanel: z.boolean().default(true).describe("Show property panel"),
+  /** Show the node palette sidebar */
+  showPalette: z.boolean().default(true).describe("Show node palette sidebar"),
+  /** Maximum undo history steps */
+  undoLimit: z.number().int().min(1).default(50).describe("Maximum undo history steps"),
+  /** Enable edge animation during execution preview */
+  animateExecution: z.boolean().default(true).describe("Animate edges during execution preview"),
+  /** Connection validation — prevent invalid edges (e.g., duplicate, self-loop) */
+  connectionValidation: z.boolean().default(true).describe("Validate connections before creating edges")
+}).describe("Studio Flow Builder configuration");
+var BUILT_IN_NODE_DESCRIPTORS = [
+  { action: "start", shape: "circle", icon: "play", defaultLabel: "Start", defaultWidth: 60, defaultHeight: 60, fillColor: "#dcfce7", borderColor: "#16a34a", allowBoundaryEvents: false, paletteCategory: "event" },
+  { action: "end", shape: "circle", icon: "square", defaultLabel: "End", defaultWidth: 60, defaultHeight: 60, fillColor: "#fee2e2", borderColor: "#dc2626", allowBoundaryEvents: false, paletteCategory: "event" },
+  { action: "decision", shape: "diamond", icon: "git-branch", defaultLabel: "Decision", defaultWidth: 80, defaultHeight: 80, fillColor: "#fef9c3", borderColor: "#ca8a04", allowBoundaryEvents: false, paletteCategory: "gateway" },
+  { action: "parallel_gateway", shape: "diamond_thick", icon: "git-fork", defaultLabel: "Parallel Gateway", defaultWidth: 80, defaultHeight: 80, fillColor: "#dbeafe", borderColor: "#2563eb", allowBoundaryEvents: false, paletteCategory: "gateway" },
+  { action: "join_gateway", shape: "diamond_thick", icon: "git-merge", defaultLabel: "Join Gateway", defaultWidth: 80, defaultHeight: 80, fillColor: "#dbeafe", borderColor: "#2563eb", allowBoundaryEvents: false, paletteCategory: "gateway" },
+  { action: "wait", shape: "hexagon", icon: "clock", defaultLabel: "Wait", defaultWidth: 100, defaultHeight: 60, fillColor: "#f3e8ff", borderColor: "#7c3aed", allowBoundaryEvents: true, paletteCategory: "event" },
+  { action: "boundary_event", shape: "attached_circle", icon: "alert-circle", defaultLabel: "Boundary Event", defaultWidth: 40, defaultHeight: 40, fillColor: "#fff7ed", borderColor: "#ea580c", allowBoundaryEvents: false, paletteCategory: "event" },
+  { action: "assignment", shape: "rounded_rect", icon: "pen-line", defaultLabel: "Assignment", defaultWidth: 120, defaultHeight: 60, fillColor: "#ffffff", borderColor: "#94a3b8", allowBoundaryEvents: true, paletteCategory: "activity" },
+  { action: "create_record", shape: "rounded_rect", icon: "plus-circle", defaultLabel: "Create Record", defaultWidth: 120, defaultHeight: 60, fillColor: "#ffffff", borderColor: "#94a3b8", allowBoundaryEvents: true, paletteCategory: "data" },
+  { action: "update_record", shape: "rounded_rect", icon: "edit", defaultLabel: "Update Record", defaultWidth: 120, defaultHeight: 60, fillColor: "#ffffff", borderColor: "#94a3b8", allowBoundaryEvents: true, paletteCategory: "data" },
+  { action: "delete_record", shape: "rounded_rect", icon: "trash-2", defaultLabel: "Delete Record", defaultWidth: 120, defaultHeight: 60, fillColor: "#ffffff", borderColor: "#94a3b8", allowBoundaryEvents: true, paletteCategory: "data" },
+  { action: "get_record", shape: "rounded_rect", icon: "search", defaultLabel: "Get Record", defaultWidth: 120, defaultHeight: 60, fillColor: "#ffffff", borderColor: "#94a3b8", allowBoundaryEvents: true, paletteCategory: "data" },
+  { action: "http_request", shape: "rounded_rect", icon: "globe", defaultLabel: "HTTP Request", defaultWidth: 120, defaultHeight: 60, fillColor: "#ffffff", borderColor: "#94a3b8", allowBoundaryEvents: true, paletteCategory: "activity" },
+  { action: "script", shape: "rounded_rect", icon: "code", defaultLabel: "Script", defaultWidth: 120, defaultHeight: 60, fillColor: "#ffffff", borderColor: "#94a3b8", allowBoundaryEvents: true, paletteCategory: "activity" },
+  { action: "screen", shape: "screen_rect", icon: "monitor", defaultLabel: "Screen", defaultWidth: 140, defaultHeight: 80, fillColor: "#f0f9ff", borderColor: "#0284c7", allowBoundaryEvents: false, paletteCategory: "activity" },
+  { action: "loop", shape: "parallelogram", icon: "repeat", defaultLabel: "Loop", defaultWidth: 120, defaultHeight: 60, fillColor: "#fef3c7", borderColor: "#d97706", allowBoundaryEvents: true, paletteCategory: "activity" },
+  { action: "subflow", shape: "rounded_rect", icon: "layers", defaultLabel: "Subflow", defaultWidth: 140, defaultHeight: 70, fillColor: "#ede9fe", borderColor: "#7c3aed", allowBoundaryEvents: true, paletteCategory: "subflow" },
+  { action: "connector_action", shape: "rounded_rect", icon: "plug", defaultLabel: "Connector", defaultWidth: 120, defaultHeight: 60, fillColor: "#ffffff", borderColor: "#94a3b8", allowBoundaryEvents: true, paletteCategory: "activity" }
+];
+function defineFlowBuilderConfig(input) {
+  return FlowBuilderConfigSchema.parse(input);
+}
 var ObjectStackDefinitionSchema = z.object({
   /** System Configuration */
   manifest: ManifestSchema.optional().describe("Project Package Configuration"),