@objectstack/spec 6.7.0 → 6.8.0

package/dist/ai/index.mjs

@@ -45,7 +45,7 @@ function lazySchema(factory) {
 }
 
 // src/shared/identifiers.zod.ts
-lazySchema(() => z.string().min(2, { message: "System identifier must be at least 2 characters" }).regex(/^[a-z][a-z0-9_.]*$/, {
+var SystemIdentifierSchema = lazySchema(() => z.string().min(2, { message: "System identifier must be at least 2 characters" }).regex(/^[a-z][a-z0-9_.]*$/, {
   message: 'System identifier must be lowercase, starting with a letter, and may contain letters, numbers, underscores, or dots (e.g., "user_profile" or "order.created")'
 }).describe("System identifier (lowercase with underscores or dots)"));
 var SnakeCaseIdentifierSchema = lazySchema(() => z.string().min(2, { message: "Identifier must be at least 2 characters" }).regex(/^[a-z][a-z0-9_]*$/, {
@@ -238,6 +238,1127 @@ var AgentSchema = lazySchema(() => z.object({
 function defineAgent(config) {
   return AgentSchema.parse(config);
 }
+var ExpressionDialect = z.enum(["cel", "js", "cron", "template"]);
+var ExpressionMetaSchema = z.object({
+  /** Human-readable rationale (often AI-emitted). */
+  rationale: z.string().optional(),
+  /** Identifier of the agent / tool that produced this expression. */
+  generatedBy: z.string().optional()
+});
+var ExpressionSchema = z.object({
+  /** Which engine evaluates `source` / `ast`. */
+  dialect: ExpressionDialect,
+  /** Surface syntax. Required while `ast` is not yet populated. */
+  source: z.string().min(1).optional(),
+  /**
+   * Engine-native AST. Opaque at the spec layer; each engine validates its own
+   * shape. For `dialect: 'cel'` this is the cel-js parsed AST node.
+   */
+  ast: z.unknown().optional(),
+  /** Optional authorship metadata. */
+  meta: ExpressionMetaSchema.optional()
+}).refine((e) => e.source !== void 0 || e.ast !== void 0, {
+  message: "Expression requires at least one of `source` or `ast`"
+});
+var ExpressionInputSchema = z.union([
+  z.string().min(1).transform((source) => ({ dialect: "cel", source })),
+  ExpressionSchema
+]);
+z.union([
+  z.string().min(1).transform((source) => ({ dialect: "cron", source })),
+  ExpressionSchema
+]);
+var TemplateExpressionInputSchema = z.union([
+  z.string().min(1).transform((source) => ({ dialect: "template", source })),
+  ExpressionSchema
+]);
+lazySchema(() => z.object({
+  /** Translation key (e.g., "views.task_list.label", "apps.crm.description") */
+  key: z.string().describe('Translation key (e.g., "views.task_list.label")'),
+  /** Default value when translation is not available */
+  defaultValue: z.string().optional().describe("Fallback value when translation key is not found"),
+  /** Interpolation parameters for dynamic translations */
+  params: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])).optional().describe("Interpolation parameters (e.g., { count: 5 })")
+}));
+var I18nLabelSchema = lazySchema(() => z.string().describe("Display label (plain string; i18n keys are auto-generated by the framework)"));
+var AriaPropsSchema = lazySchema(() => z.object({
+  /** Accessible label for screen readers */
+  ariaLabel: I18nLabelSchema.optional().describe("Accessible label for screen readers (WAI-ARIA aria-label)"),
+  /** ID of element that describes this component */
+  ariaDescribedBy: z.string().optional().describe("ID of element providing additional description (WAI-ARIA aria-describedby)"),
+  /** WAI-ARIA role override */
+  role: z.string().optional().describe('WAI-ARIA role attribute (e.g., "dialog", "navigation", "alert")')
+}).describe("ARIA accessibility attributes"));
+lazySchema(() => z.object({
+  /** Translation key for the plural form */
+  key: z.string().describe("Translation key"),
+  /** Form for zero quantity */
+  zero: z.string().optional().describe('Zero form (e.g., "No items")'),
+  /** Form for singular (1) */
+  one: z.string().optional().describe('Singular form (e.g., "{count} item")'),
+  /** Form for dual (2) — used in Arabic, Welsh, etc. */
+  two: z.string().optional().describe('Dual form (e.g., "{count} items" for exactly 2)'),
+  /** Form for few (2-4 in Slavic languages) */
+  few: z.string().optional().describe("Few form (e.g., for 2-4 in some languages)"),
+  /** Form for many (5+ in Slavic languages) */
+  many: z.string().optional().describe("Many form (e.g., for 5+ in some languages)"),
+  /** Default/fallback form */
+  other: z.string().describe('Default plural form (e.g., "{count} items")')
+}).describe("ICU plural rules for a translation key"));
+var NumberFormatSchema = lazySchema(() => z.object({
+  style: z.enum(["decimal", "currency", "percent", "unit"]).default("decimal").describe("Number formatting style"),
+  currency: z.string().optional().describe('ISO 4217 currency code (e.g., "USD", "EUR")'),
+  unit: z.string().optional().describe('Unit for unit formatting (e.g., "kilometer", "liter")'),
+  minimumFractionDigits: z.number().optional().describe("Minimum number of fraction digits"),
+  maximumFractionDigits: z.number().optional().describe("Maximum number of fraction digits"),
+  useGrouping: z.boolean().optional().describe("Whether to use grouping separators (e.g., 1,000)")
+}).describe("Number formatting rules"));
+var DateFormatSchema = lazySchema(() => z.object({
+  dateStyle: z.enum(["full", "long", "medium", "short"]).optional().describe("Date display style"),
+  timeStyle: z.enum(["full", "long", "medium", "short"]).optional().describe("Time display style"),
+  timeZone: z.string().optional().describe('IANA time zone (e.g., "America/New_York")'),
+  hour12: z.boolean().optional().describe("Use 12-hour format")
+}).describe("Date/time formatting rules"));
+lazySchema(() => z.object({
+  /** BCP 47 language code (e.g., "en-US", "zh-CN", "ar-SA") */
+  code: z.string().describe('BCP 47 language code (e.g., "en-US", "zh-CN")'),
+  /** Ordered fallback chain for missing translations */
+  fallbackChain: z.array(z.string()).optional().describe('Fallback language codes in priority order (e.g., ["zh-TW", "en"])'),
+  /** Text direction */
+  direction: z.enum(["ltr", "rtl"]).default("ltr").describe("Text direction: left-to-right or right-to-left"),
+  /** Default number formatting */
+  numberFormat: NumberFormatSchema.optional().describe("Default number formatting rules"),
+  /** Default date formatting */
+  dateFormat: DateFormatSchema.optional().describe("Default date/time formatting rules")
+}).describe("Locale configuration"));
+var SharingConfigSchema = lazySchema(() => z.object({
+  enabled: z.boolean().default(false).describe("Enable public sharing"),
+  publicLink: z.string().optional().describe("Generated public share URL"),
+  password: z.string().optional().describe("Password required to access shared link"),
+  allowedDomains: z.array(z.string()).optional().describe('Restrict access to specific email domains (e.g. ["example.com"])'),
+  expiresAt: z.string().optional().describe("Expiration date/time in ISO 8601 format"),
+  allowAnonymous: z.boolean().optional().default(false).describe("Allow access without authentication")
+}));
+lazySchema(() => z.object({
+  enabled: z.boolean().default(false).describe("Enable iframe embedding"),
+  allowedOrigins: z.array(z.string()).optional().describe('Allowed iframe parent origins (e.g. ["https://example.com"])'),
+  width: z.string().optional().default("100%").describe("Embed width (CSS value)"),
+  height: z.string().optional().default("600px").describe("Embed height (CSS value)"),
+  showHeader: z.boolean().optional().default(true).describe("Show interface header in embed"),
+  showNavigation: z.boolean().optional().default(false).describe("Show navigation in embed"),
+  responsive: z.boolean().optional().default(true).describe("Enable responsive resizing")
+}));
+var BreakpointName = z.enum(["xs", "sm", "md", "lg", "xl", "2xl"]);
+var BreakpointColumnMapSchema = lazySchema(() => z.object({
+  xs: z.number().min(1).max(12).optional(),
+  sm: z.number().min(1).max(12).optional(),
+  md: z.number().min(1).max(12).optional(),
+  lg: z.number().min(1).max(12).optional(),
+  xl: z.number().min(1).max(12).optional(),
+  "2xl": z.number().min(1).max(12).optional()
+}).describe("Grid columns per breakpoint (1-12)"));
+var BreakpointOrderMapSchema = lazySchema(() => z.object({
+  xs: z.number().optional(),
+  sm: z.number().optional(),
+  md: z.number().optional(),
+  lg: z.number().optional(),
+  xl: z.number().optional(),
+  "2xl": z.number().optional()
+}).describe("Display order per breakpoint"));
+var ResponsiveConfigSchema = lazySchema(() => z.object({
+  /** Minimum breakpoint for visibility */
+  breakpoint: BreakpointName.optional().describe("Minimum breakpoint for visibility"),
+  /** Hide on specific breakpoints */
+  hiddenOn: z.array(BreakpointName).optional().describe("Hide on these breakpoints"),
+  /** Grid columns per breakpoint (1-12 column grid) */
+  columns: BreakpointColumnMapSchema.optional().describe("Grid columns per breakpoint"),
+  /** Display order per breakpoint */
+  order: BreakpointOrderMapSchema.optional().describe("Display order per breakpoint")
+}).describe("Responsive layout configuration"));
+var PerformanceConfigSchema = lazySchema(() => z.object({
+  /** Enable lazy loading for this component */
+  lazyLoad: z.boolean().optional().describe("Enable lazy loading (defer rendering until visible)"),
+  /** Virtual scrolling configuration for large datasets */
+  virtualScroll: z.object({
+    enabled: z.boolean().default(false).describe("Enable virtual scrolling"),
+    itemHeight: z.number().optional().describe("Fixed item height in pixels (for estimation)"),
+    overscan: z.number().optional().describe("Number of extra items to render outside viewport")
+  }).optional().describe("Virtual scrolling configuration"),
+  /** Client-side caching strategy */
+  cacheStrategy: z.enum([
+    "none",
+    "cache-first",
+    "network-first",
+    "stale-while-revalidate"
+  ]).optional().describe("Client-side data caching strategy"),
+  /** Enable data prefetching */
+  prefetch: z.boolean().optional().describe("Prefetch data before component is visible"),
+  /** Maximum number of items to render before pagination */
+  pageSize: z.number().optional().describe("Number of items per page for pagination"),
+  /** Debounce interval for user interactions (ms) */
+  debounceMs: z.number().optional().describe("Debounce interval for user interactions in milliseconds")
+}).describe("Performance optimization configuration"));
+var EncryptionAlgorithmSchema = lazySchema(() => z.enum([
+  "aes-256-gcm",
+  "aes-256-cbc",
+  "chacha20-poly1305"
+]).describe("Supported encryption algorithm"));
+var KeyManagementProviderSchema = lazySchema(() => z.enum([
+  "local",
+  "aws-kms",
+  "azure-key-vault",
+  "gcp-kms",
+  "hashicorp-vault"
+]).describe("Key management service provider"));
+var KeyRotationPolicySchema = lazySchema(() => z.object({
+  enabled: z.boolean().default(false).describe("Enable automatic key rotation"),
+  frequencyDays: z.number().min(1).default(90).describe("Rotation frequency in days"),
+  retainOldVersions: z.number().default(3).describe("Number of old key versions to retain"),
+  autoRotate: z.boolean().default(true).describe("Automatically rotate without manual approval")
+}).describe("Policy for automatic encryption key rotation"));
+var EncryptionConfigSchema = lazySchema(() => z.object({
+  enabled: z.boolean().default(false).describe("Enable field-level encryption"),
+  algorithm: EncryptionAlgorithmSchema.default("aes-256-gcm").describe("Encryption algorithm"),
+  keyManagement: z.object({
+    provider: KeyManagementProviderSchema.describe("Key management service provider"),
+    keyId: z.string().optional().describe("Key identifier in the provider"),
+    rotationPolicy: KeyRotationPolicySchema.optional().describe("Key rotation policy")
+  }).describe("Key management configuration"),
+  scope: z.enum(["field", "record", "table", "database"]).describe("Encryption scope level"),
+  deterministicEncryption: z.boolean().default(false).describe("Allows equality queries on encrypted data"),
+  searchableEncryption: z.boolean().default(false).describe("Allows search on encrypted data")
+}).describe("Field-level encryption configuration"));
+lazySchema(() => z.object({
+  fieldName: z.string().describe("Name of the field to encrypt"),
+  encryptionConfig: EncryptionConfigSchema.describe("Encryption settings for this field"),
+  indexable: z.boolean().default(false).describe("Allow indexing on encrypted field")
+}).describe("Per-field encryption assignment"));
+var MaskingStrategySchema = lazySchema(() => z.enum([
+  "redact",
+  // Complete redaction: ****
+  "partial",
+  // Partial masking: 138****5678
+  "hash",
+  // Hash value: sha256(value)
+  "tokenize",
+  // Tokenization: token-12345
+  "randomize",
+  // Randomize: generate random value
+  "nullify",
+  // Null value: null
+  "substitute"
+  // Substitute with dummy data
+]).describe("Data masking strategy for PII protection"));
+var MaskingRuleSchema = lazySchema(() => z.object({
+  field: z.string().describe("Field name to apply masking to"),
+  strategy: MaskingStrategySchema.describe("Masking strategy to use"),
+  pattern: z.string().optional().describe("Regex pattern for partial masking"),
+  preserveFormat: z.boolean().default(true).describe("Keep the original data format after masking"),
+  preserveLength: z.boolean().default(true).describe("Keep the original data length after masking"),
+  roles: z.array(z.string()).optional().describe("Roles that see masked data"),
+  exemptRoles: z.array(z.string()).optional().describe("Roles that see unmasked data")
+}).describe("Masking rule for a single field"));
+lazySchema(() => z.object({
+  enabled: z.boolean().default(false).describe("Enable data masking"),
+  rules: z.array(MaskingRuleSchema).describe("List of field-level masking rules"),
+  auditUnmasking: z.boolean().default(true).describe("Log when masked data is accessed unmasked")
+}).describe("Top-level data masking configuration for PII protection"));
+
+// src/data/field.zod.ts
+var FieldType = z.enum([
+  // Core Text
+  "text",
+  "textarea",
+  "email",
+  "url",
+  "phone",
+  "password",
+  // Rich Content
+  "markdown",
+  "html",
+  "richtext",
+  // Numbers
+  "number",
+  "currency",
+  "percent",
+  // Date & Time
+  "date",
+  "datetime",
+  "time",
+  // Logic
+  "boolean",
+  "toggle",
+  // Toggle is a distinct UI from checkbox
+  // Selection
+  "select",
+  // Single select dropdown
+  "multiselect",
+  // Multi select (often tags)
+  "radio",
+  // Radio group
+  "checkboxes",
+  // Checkbox group
+  // Relational
+  "lookup",
+  "master_detail",
+  // Dynamic reference
+  "tree",
+  // Hierarchical reference
+  // Media
+  "image",
+  "file",
+  "avatar",
+  "video",
+  "audio",
+  // Calculated / System
+  "formula",
+  "summary",
+  "autonumber",
+  // Embedded structured values (stored as JSON on the parent row — no separate table / FK)
+  "composite",
+  // Single embedded sub-object with declared sub-fields  (≈ Strapi component / ACF group)
+  "repeater",
+  // Repeating embedded sub-object array with declared sub-fields  (≈ Strapi repeatable component / ACF repeater)
+  // Enhanced Types
+  "location",
+  // GPS coordinates
+  "address",
+  // Structured address
+  "code",
+  // Code editor (JSON/SQL/JS)
+  "json",
+  // Structured JSON data (untyped escape hatch)
+  "color",
+  // Color picker
+  "rating",
+  // Star rating
+  "slider",
+  // Numeric slider
+  "signature",
+  // Digital signature
+  "qrcode",
+  // QR code / Barcode
+  "progress",
+  // Progress bar
+  "tags",
+  // Simple tag list
+  // AI/ML Types
+  "vector"
+  // Vector embeddings for AI/ML (semantic search, RAG)
+]);
+var SelectOptionSchema = lazySchema(() => z.object({
+  label: z.string().describe("Display label (human-readable, any case allowed)"),
+  value: SystemIdentifierSchema.describe("Stored value (lowercase machine identifier)"),
+  color: z.string().optional().describe("Color code for badges/charts"),
+  default: z.boolean().optional().describe("Is default option")
+}));
+lazySchema(() => z.object({
+  latitude: z.number().min(-90).max(90).describe("Latitude coordinate"),
+  longitude: z.number().min(-180).max(180).describe("Longitude coordinate"),
+  altitude: z.number().optional().describe("Altitude in meters"),
+  accuracy: z.number().optional().describe("Accuracy in meters")
+}));
+var CurrencyConfigSchema = lazySchema(() => z.object({
+  precision: z.number().int().min(0).max(10).default(2).describe("Decimal precision (default: 2)"),
+  currencyMode: z.enum(["dynamic", "fixed"]).default("dynamic").describe("Currency mode: dynamic (user selectable) or fixed (single currency)"),
+  defaultCurrency: z.string().length(3).default("CNY").describe("Default or fixed currency code (ISO 4217, e.g., USD, CNY, EUR)")
+}));
+lazySchema(() => z.object({
+  value: z.number().describe("Monetary amount"),
+  currency: z.string().length(3).describe("Currency code (ISO 4217)")
+}));
+lazySchema(() => z.object({
+  street: z.string().optional().describe("Street address"),
+  city: z.string().optional().describe("City name"),
+  state: z.string().optional().describe("State/Province"),
+  postalCode: z.string().optional().describe("Postal/ZIP code"),
+  country: z.string().optional().describe("Country name or code"),
+  countryCode: z.string().optional().describe("ISO country code (e.g., US, GB)"),
+  formatted: z.string().optional().describe("Formatted address string")
+}));
+var VectorConfigSchema = lazySchema(() => z.object({
+  dimensions: z.number().int().min(1).max(1e4).describe("Vector dimensionality (e.g., 1536 for OpenAI embeddings)"),
+  distanceMetric: z.enum(["cosine", "euclidean", "dotProduct", "manhattan"]).default("cosine").describe("Distance/similarity metric for vector search"),
+  normalized: z.boolean().default(false).describe("Whether vectors are normalized (unit length)"),
+  indexed: z.boolean().default(true).describe("Whether to create a vector index for fast similarity search"),
+  indexType: z.enum(["hnsw", "ivfflat", "flat"]).optional().describe("Vector index algorithm (HNSW for high accuracy, IVFFlat for large datasets)")
+}));
+var FileAttachmentConfigSchema = lazySchema(() => z.object({
+  /** File Size Limits */
+  minSize: z.number().min(0).optional().describe("Minimum file size in bytes"),
+  maxSize: z.number().min(1).optional().describe("Maximum file size in bytes (e.g., 10485760 = 10MB)"),
+  /** File Type Restrictions */
+  allowedTypes: z.array(z.string()).optional().describe('Allowed file extensions (e.g., [".pdf", ".docx", ".jpg"])'),
+  blockedTypes: z.array(z.string()).optional().describe('Blocked file extensions (e.g., [".exe", ".bat", ".sh"])'),
+  allowedMimeTypes: z.array(z.string()).optional().describe('Allowed MIME types (e.g., ["image/jpeg", "application/pdf"])'),
+  blockedMimeTypes: z.array(z.string()).optional().describe("Blocked MIME types"),
+  /** Virus Scanning */
+  virusScan: z.boolean().default(false).describe("Enable virus scanning for uploaded files"),
+  virusScanProvider: z.enum(["clamav", "virustotal", "metadefender", "custom"]).optional().describe("Virus scanning service provider"),
+  virusScanOnUpload: z.boolean().default(true).describe("Scan files immediately on upload"),
+  quarantineOnThreat: z.boolean().default(true).describe("Quarantine files if threat detected"),
+  /** Storage Configuration */
+  storageProvider: z.string().optional().describe("Object storage provider name (references ObjectStorageConfig)"),
+  storageBucket: z.string().optional().describe("Target bucket name"),
+  storagePrefix: z.string().optional().describe('Storage path prefix (e.g., "uploads/documents/")'),
+  /** Image-Specific Validation */
+  imageValidation: z.object({
+    minWidth: z.number().min(1).optional().describe("Minimum image width in pixels"),
+    maxWidth: z.number().min(1).optional().describe("Maximum image width in pixels"),
+    minHeight: z.number().min(1).optional().describe("Minimum image height in pixels"),
+    maxHeight: z.number().min(1).optional().describe("Maximum image height in pixels"),
+    aspectRatio: z.string().optional().describe('Required aspect ratio (e.g., "16:9", "1:1")'),
+    generateThumbnails: z.boolean().default(false).describe("Auto-generate thumbnails"),
+    thumbnailSizes: z.array(z.object({
+      name: z.string().describe('Thumbnail variant name (e.g., "small", "medium", "large")'),
+      width: z.number().min(1).describe("Thumbnail width in pixels"),
+      height: z.number().min(1).describe("Thumbnail height in pixels"),
+      crop: z.boolean().default(false).describe("Crop to exact dimensions")
+    })).optional().describe("Thumbnail size configurations"),
+    preserveMetadata: z.boolean().default(false).describe("Preserve EXIF metadata"),
+    autoRotate: z.boolean().default(true).describe("Auto-rotate based on EXIF orientation")
+  }).optional().describe("Image-specific validation rules"),
+  /** Upload Behavior */
+  allowMultiple: z.boolean().default(false).describe("Allow multiple file uploads (overrides field.multiple)"),
+  allowReplace: z.boolean().default(true).describe("Allow replacing existing files"),
+  allowDelete: z.boolean().default(true).describe("Allow deleting uploaded files"),
+  requireUpload: z.boolean().default(false).describe("Require at least one file when field is required"),
+  /** Metadata Extraction */
+  extractMetadata: z.boolean().default(true).describe("Extract file metadata (name, size, type, etc.)"),
+  extractText: z.boolean().default(false).describe("Extract text content from documents (OCR/parsing)"),
+  /** Versioning */
+  versioningEnabled: z.boolean().default(false).describe("Keep previous versions of replaced files"),
+  maxVersions: z.number().min(1).optional().describe("Maximum number of versions to retain"),
+  /** Access Control */
+  publicRead: z.boolean().default(false).describe("Allow public read access to uploaded files"),
+  presignedUrlExpiry: z.number().min(60).max(604800).default(3600).describe("Presigned URL expiration in seconds (default: 1 hour)")
+}).refine((data) => {
+  if (data.minSize !== void 0 && data.maxSize !== void 0 && data.minSize > data.maxSize) {
+    return false;
+  }
+  return true;
+}, {
+  message: "minSize must be less than or equal to maxSize"
+}).refine((data) => {
+  if (data.virusScanProvider !== void 0 && data.virusScan !== true) {
+    return false;
+  }
+  return true;
+}, {
+  message: "virusScanProvider requires virusScan to be enabled"
+}));
+var DataQualityRulesSchema = lazySchema(() => z.object({
+  /** Enforce uniqueness constraint */
+  uniqueness: z.boolean().default(false).describe("Enforce unique values across all records"),
+  /** Completeness ratio (0-1) indicating minimum percentage of non-null values */
+  completeness: z.number().min(0).max(1).default(0).describe("Minimum ratio of non-null values (0-1, default: 0 = no requirement)"),
+  /** Accuracy validation against authoritative source */
+  accuracy: z.object({
+    source: z.string().describe('Reference data source for validation (e.g., "api.verify.com", "master_data")'),
+    threshold: z.number().min(0).max(1).describe("Minimum accuracy threshold (0-1, e.g., 0.95 = 95% match required)")
+  }).optional().describe("Accuracy validation configuration")
+}));
+var ComputedFieldCacheSchema = lazySchema(() => z.object({
+  /** Enable caching for this computed field */
+  enabled: z.boolean().describe("Enable caching for computed field results"),
+  /** Time-to-live in seconds */
+  ttl: z.number().min(0).describe("Cache TTL in seconds (0 = no expiration)"),
+  /** Array of field paths that trigger cache invalidation when changed */
+  invalidateOn: z.array(z.string()).describe('Field paths that invalidate cache (e.g., ["inventory.quantity", "pricing.base_price"])')
+}));
+lazySchema(() => z.object({
+  /** Identity */
+  name: z.string().regex(/^[a-z_][a-z0-9_]*$/).describe("Machine name (snake_case)").optional(),
+  label: z.string().optional().describe("Human readable label"),
+  type: FieldType.describe("Field Data Type"),
+  description: z.string().optional().describe("Tooltip/Help text"),
+  format: z.string().optional().describe("Format string (e.g. email, phone)"),
+  /** Storage Layer Mapping */
+  columnName: z.string().optional().describe("Physical column name in the target datasource. Defaults to the field key when not set."),
+  /** Database Constraints */
+  required: z.boolean().default(false).describe("Is required"),
+  searchable: z.boolean().default(false).describe("Is searchable"),
+  multiple: z.boolean().default(false).describe("Allow multiple values (Stores as Array/JSON). Applicable for select, lookup, file, image."),
+  unique: z.boolean().default(false).describe("Is unique constraint"),
+  defaultValue: z.unknown().optional().describe("Default value"),
+  /** Text/String Constraints */
+  maxLength: z.number().optional().describe("Max character length"),
+  minLength: z.number().optional().describe("Min character length"),
+  /** Number Constraints */
+  precision: z.number().optional().describe("Total digits"),
+  scale: z.number().optional().describe("Decimal places"),
+  min: z.number().optional().describe("Minimum value"),
+  max: z.number().optional().describe("Maximum value"),
+  /** Selection Options */
+  options: z.array(SelectOptionSchema).optional().describe("Static options for select/multiselect"),
+  /**
+   * Relationship Config
+   * 
+   * Used by `lookup` and `master_detail` field types to define cross-object references.
+   * The `reference` property is **required** for these types — it identifies the target
+   * object whose records this field links to. The engine uses `reference` during $expand
+   * post-processing to resolve foreign key IDs into full related objects via batch queries.
+   * 
+   * For `master_detail` fields, the parent record controls the lifecycle of child records
+   * (e.g., cascade delete). For `lookup` fields, the reference is a soft link.
+   */
+  reference: z.string().optional().describe(
+    "Target object name (snake_case) for lookup/master_detail fields. Required for relationship types. Used by $expand to resolve foreign key IDs into full objects."
+  ),
+  referenceFilters: z.array(z.string()).optional().describe('Filters applied to lookup dialogs (e.g. "active = true")'),
+  writeRequiresMasterRead: z.boolean().optional().describe("If true, user needs read access to master record to edit this field"),
+  deleteBehavior: z.enum(["set_null", "cascade", "restrict"]).optional().default("set_null").describe("What happens if referenced record is deleted"),
+  /** Calculation — CEL formula. Plain string accepted for back-compat; build emits canonical envelope. */
+  expression: ExpressionInputSchema.optional().describe("Formula expression (CEL). e.g. F`record.amount * 0.1`"),
+  summaryOperations: z.object({
+    object: z.string().describe("Source child object name for roll-up"),
+    field: z.string().describe("Field on child object to aggregate"),
+    function: z.enum(["count", "sum", "min", "max", "avg"]).describe("Aggregation function to apply")
+  }).optional().describe("Roll-up summary definition"),
+  /** Enhanced Field Type Configurations */
+  // Code field config
+  language: z.string().optional().describe("Programming language for syntax highlighting (e.g., javascript, python, sql)"),
+  theme: z.string().optional().describe("Code editor theme (e.g., dark, light, monokai)"),
+  lineNumbers: z.boolean().optional().describe("Show line numbers in code editor"),
+  // Rating field config
+  maxRating: z.number().optional().describe("Maximum rating value (default: 5)"),
+  allowHalf: z.boolean().optional().describe("Allow half-star ratings"),
+  // Location field config
+  displayMap: z.boolean().optional().describe("Display map widget for location field"),
+  allowGeocoding: z.boolean().optional().describe("Allow address-to-coordinate conversion"),
+  // Address field config
+  addressFormat: z.enum(["us", "uk", "international"]).optional().describe("Address format template"),
+  // Color field config
+  colorFormat: z.enum(["hex", "rgb", "rgba", "hsl"]).optional().describe("Color value format"),
+  allowAlpha: z.boolean().optional().describe("Allow transparency/alpha channel"),
+  presetColors: z.array(z.string()).optional().describe("Preset color options"),
+  // Slider field config
+  step: z.number().optional().describe("Step increment for slider (default: 1)"),
+  showValue: z.boolean().optional().describe("Display current value on slider"),
+  marks: z.record(z.string(), z.string()).optional().describe('Custom marks/labels at specific values (e.g., {0: "Low", 50: "Medium", 100: "High"})'),
+  // QR Code / Barcode field config
+  // Note: qrErrorCorrection is only applicable when barcodeFormat='qr'
+  // Runtime validation should enforce this constraint
+  barcodeFormat: z.enum(["qr", "ean13", "ean8", "code128", "code39", "upca", "upce"]).optional().describe("Barcode format type"),
+  qrErrorCorrection: z.enum(["L", "M", "Q", "H"]).optional().describe('QR code error correction level (L=7%, M=15%, Q=25%, H=30%). Only applicable when barcodeFormat is "qr"'),
+  displayValue: z.boolean().optional().describe("Display human-readable value below barcode/QR code"),
+  allowScanning: z.boolean().optional().describe("Enable camera scanning for barcode/QR code input"),
+  // Currency field config
+  currencyConfig: CurrencyConfigSchema.optional().describe("Configuration for currency field type"),
+  // Vector field config
+  vectorConfig: VectorConfigSchema.optional().describe("Configuration for vector field type (AI/ML embeddings)"),
+  // File attachment field config
+  fileAttachmentConfig: FileAttachmentConfigSchema.optional().describe("Configuration for file and attachment field types"),
+  /** Enhanced Security & Compliance */
+  // Encryption configuration
+  encryptionConfig: EncryptionConfigSchema.optional().describe("Field-level encryption configuration for sensitive data (GDPR/HIPAA/PCI-DSS)"),
+  // Data masking rules
+  maskingRule: MaskingRuleSchema.optional().describe("Data masking rules for PII protection"),
+  // Audit trail
+  auditTrail: z.boolean().default(false).describe("Enable detailed audit trail for this field (tracks all changes with user and timestamp)"),
+  /** Field Dependencies & Relationships */
+  // Field dependencies
+  dependencies: z.array(z.string()).optional().describe("Array of field names that this field depends on (for formulas, visibility rules, etc.)"),
+  /** Computed Field Optimization */
+  // Computed field caching
+  cached: ComputedFieldCacheSchema.optional().describe("Caching configuration for computed/formula fields"),
+  /** Data Quality & Governance */
+  // Data quality rules
+  dataQuality: DataQualityRulesSchema.optional().describe("Data quality validation and monitoring rules"),
+  /** Layout & Grouping */
+  group: z.string().optional().describe('Field group name for organizing fields in forms and layouts (e.g., "contact_info", "billing", "system")'),
+  /** Conditional Requirements */
+  conditionalRequired: ExpressionInputSchema.optional().describe("Predicate (CEL) \u2014 field is required when TRUE. e.g. P`record.status == 'closed_won'`"),
+  /** Security & Visibility */
+  hidden: z.boolean().default(false).describe("Hidden from default UI"),
+  readonly: z.boolean().default(false).describe("Read-only in UI"),
+  system: z.boolean().optional().describe("Auto-injected system/audit field (e.g. created_at, updated_by, organization_id). Tools that surface system fields separately from author-declared business fields should branch on this flag."),
+  sortable: z.boolean().optional().default(true).describe("Whether field is sortable in list views"),
+  inlineHelpText: z.string().optional().describe("Help text displayed below the field in forms"),
+  trackFeedHistory: z.boolean().optional().describe("Track field changes in Chatter/activity feed (Salesforce pattern)"),
+  caseSensitive: z.boolean().optional().describe("Whether text comparisons are case-sensitive"),
+  autonumberFormat: z.string().optional().describe('Auto-number display format pattern (e.g., "CASE-{0000}")'),
+  /** Indexing */
+  index: z.boolean().default(false).describe("Create standard database index"),
+  externalId: z.boolean().default(false).describe("Is external ID for upsert operations")
+}));
+var HttpMethod = z.enum([
+  "GET",
+  "POST",
+  "PUT",
+  "DELETE",
+  "PATCH",
+  "HEAD",
+  "OPTIONS"
+]);
+var HttpMethodSchema = lazySchema(() => z.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]));
+var HttpRequestSchema = lazySchema(() => z.object({
+  url: z.string().describe("API endpoint URL"),
+  method: HttpMethodSchema.optional().default("GET").describe("HTTP method"),
+  headers: z.record(z.string(), z.string()).optional().describe("Custom HTTP headers"),
+  params: z.record(z.string(), z.unknown()).optional().describe("Query parameters"),
+  body: z.unknown().optional().describe("Request body for POST/PUT/PATCH")
+}));
+lazySchema(() => z.object({
+  /**
+   * Enable CORS
+   */
+  enabled: z.boolean().default(true).describe("Enable CORS"),
+  /**
+   * Allowed origins (* for all)
+   */
+  origins: z.union([
+    z.string(),
+    z.array(z.string())
+  ]).default("*").describe("Allowed origins (* for all)"),
+  /**
+   * Allowed HTTP methods
+   */
+  methods: z.array(HttpMethod).optional().describe("Allowed HTTP methods"),
+  /**
+   * Allow credentials (cookies, authorization headers)
+   */
+  credentials: z.boolean().default(false).describe("Allow credentials (cookies, authorization headers)"),
+  /**
+   * Preflight cache duration in seconds
+   */
+  maxAge: z.number().int().optional().describe("Preflight cache duration in seconds")
+}));
+lazySchema(() => z.object({
+  /**
+   * Enable rate limiting
+   */
+  enabled: z.boolean().default(false).describe("Enable rate limiting"),
+  /**
+   * Time window in milliseconds
+   */
+  windowMs: z.number().int().default(6e4).describe("Time window in milliseconds"),
+  /**
+   * Max requests per window
+   */
+  maxRequests: z.number().int().default(100).describe("Max requests per window")
+}));
+lazySchema(() => z.object({
+  /**
+   * URL path to serve from
+   */
+  path: z.string().describe("URL path to serve from"),
+  /**
+   * Physical directory to serve
+   */
+  directory: z.string().describe("Physical directory to serve"),
+  /**
+   * Cache-Control header value
+   */
+  cacheControl: z.string().optional().describe("Cache-Control header value")
+}));
+
+// src/ui/view.zod.ts
+var ViewDataSchema = lazySchema(() => z.discriminatedUnion("provider", [
+  z.object({
+    provider: z.literal("object"),
+    object: z.string().describe("Target object name")
+  }),
+  z.object({
+    provider: z.literal("api"),
+    read: HttpRequestSchema.optional().describe("Configuration for fetching data"),
+    write: HttpRequestSchema.optional().describe("Configuration for submitting data (for forms/editable tables)")
+  }),
+  z.object({
+    provider: z.literal("value"),
+    items: z.array(z.unknown()).describe("Static data array")
+  }),
+  /**
+   * Schema-bound data source — used by standalone forms whose data is
+   * shaped by a JSON Schema (or Zod-derived schema) rather than by an
+   * ObjectQL object. Powers the metadata editor, action input dialogs,
+   * and any Form that is not bound to a CRUD object.
+   */
+  z.object({
+    provider: z.literal("schema"),
+    /** Schema identifier (e.g. metadata type name "report"). Resolved at runtime against /meta entries. */
+    schemaId: z.string().describe("Schema identifier \u2014 typically the metadata type name"),
+    /** Optional inline JSON Schema; when omitted the runtime resolves schemaId from the server. */
+    schema: z.record(z.string(), z.unknown()).optional().describe("Inline JSON Schema (Draft 2020-12). Optional when schemaId is resolvable.")
+  })
+]));
+var ViewFilterRuleSchema = lazySchema(() => z.object({
+  /** Field name to filter on */
+  field: z.string().describe("Field name to filter on"),
+  /** Filter operator */
+  operator: z.string().describe("Filter operator (e.g. equals, not_equals, contains, this_quarter)"),
+  /** Filter value (optional for unary operators like is_null, this_quarter) */
+  value: z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(z.union([z.string(), z.number()]))]).optional().describe("Filter value")
+}).describe("View filter rule"));
+var ColumnSummarySchema = lazySchema(() => z.enum([
+  "none",
+  "count",
+  "count_empty",
+  "count_filled",
+  "count_unique",
+  "percent_empty",
+  "percent_filled",
+  "sum",
+  "avg",
+  "min",
+  "max"
+]).describe("Aggregation function for column footer summary"));
+var ListColumnSchema = lazySchema(() => z.object({
+  field: z.string().describe("Field name (snake_case)"),
+  label: I18nLabelSchema.optional().describe("Display label override"),
+  width: z.number().positive().optional().describe("Column width in pixels"),
+  align: z.enum(["left", "center", "right"]).optional().describe("Text alignment"),
+  hidden: z.boolean().optional().describe("Hide column by default"),
+  sortable: z.boolean().optional().describe("Allow sorting by this column"),
+  resizable: z.boolean().optional().describe("Allow resizing this column"),
+  wrap: z.boolean().optional().describe("Allow text wrapping"),
+  type: z.string().optional().describe('Renderer type override (e.g., "currency", "date")'),
+  /** Pinning (Airtable-style frozen columns) */
+  pinned: z.enum(["left", "right"]).optional().describe("Pin/freeze column to left or right side"),
+  /** Column Footer Summary (Airtable-style aggregation) */
+  summary: ColumnSummarySchema.optional().describe("Footer aggregation function for this column"),
+  /** Interaction */
+  link: z.boolean().optional().describe("Functions as the primary navigation link (triggers View navigation)"),
+  action: z.string().optional().describe("Registered Action ID to execute when clicked")
+}));
+var SelectionConfigSchema = lazySchema(() => z.object({
+  type: z.enum(["none", "single", "multiple"]).default("none").describe("Selection mode")
+}));
+var PaginationConfigSchema = lazySchema(() => z.object({
+  pageSize: z.number().int().positive().default(25).describe("Number of records per page"),
+  pageSizeOptions: z.array(z.number().int().positive()).optional().describe("Available page size options")
+}));
+var RowHeightSchema = lazySchema(() => z.enum([
+  "compact",
+  // Minimal padding, single line
+  "short",
+  // Reduced padding
+  "medium",
+  // Default padding
+  "tall",
+  // Extra padding, multi-line preview
+  "extra_tall"
+  // Maximum padding, rich content preview
+]).describe("Row height / density setting for list view"));
+var GroupingFieldSchema = lazySchema(() => z.object({
+  field: z.string().describe("Field name to group by"),
+  order: z.enum(["asc", "desc"]).default("asc").describe("Group sort order"),
+  collapsed: z.boolean().default(false).describe("Collapse groups by default")
+}));
+var GroupingConfigSchema = lazySchema(() => z.object({
+  fields: z.array(GroupingFieldSchema).min(1).describe("Fields to group by (supports up to 3 levels)")
+}).describe("Record grouping configuration"));
+var GalleryConfigSchema = lazySchema(() => z.object({
+  coverField: z.string().optional().describe("Attachment/image field to display as card cover"),
+  coverFit: z.enum(["cover", "contain"]).default("cover").describe("Image fit mode for card cover"),
+  cardSize: z.enum(["small", "medium", "large"]).default("medium").describe("Card size in gallery view"),
+  titleField: z.string().optional().describe("Field to display as card title"),
+  visibleFields: z.array(z.string()).optional().describe("Fields to display on card body")
+}).describe("Gallery/card view configuration"));
+var TimelineConfigSchema = lazySchema(() => z.object({
+  startDateField: z.string().describe("Field for timeline item start date"),
+  endDateField: z.string().optional().describe("Field for timeline item end date"),
+  titleField: z.string().describe("Field to display as timeline item title"),
+  groupByField: z.string().optional().describe("Field to group timeline rows"),
+  colorField: z.string().optional().describe("Field to determine item color"),
+  scale: z.enum(["hour", "day", "week", "month", "quarter", "year"]).default("week").describe("Default timeline scale")
+}).describe("Timeline view configuration"));
+var ViewSharingSchema = lazySchema(() => z.object({
+  type: z.enum(["personal", "collaborative"]).default("collaborative").describe("View ownership type"),
+  lockedBy: z.string().optional().describe("User who locked the view configuration")
+}).describe("View sharing and access configuration"));
+var RowColorConfigSchema = lazySchema(() => z.object({
+  field: z.string().describe("Field to derive color from (typically a select/status field)"),
+  colors: z.record(z.string(), z.string()).optional().describe("Map of field value to color (hex/token)")
+}).describe("Row color configuration based on field values"));
+var VisualizationTypeSchema = lazySchema(() => z.enum([
+  "grid",
+  "kanban",
+  "gallery",
+  "calendar",
+  "timeline",
+  "gantt",
+  "map"
+]).describe("Visualization type that users can switch to"));
+var UserActionsConfigSchema = lazySchema(() => z.object({
+  sort: z.boolean().default(true).describe("Allow users to sort records"),
+  search: z.boolean().default(true).describe("Allow users to search records"),
+  filter: z.boolean().default(true).describe("Allow users to filter records"),
+  rowHeight: z.boolean().default(true).describe("Allow users to toggle row height/density"),
+  addRecordForm: z.boolean().default(false).describe("Add records through a form instead of inline"),
+  buttons: z.array(z.string()).optional().describe("Custom action button IDs to show in the toolbar")
+}).describe("User action toggles for the view toolbar"));
+var AppearanceConfigSchema = lazySchema(() => z.object({
+  showDescription: z.boolean().default(true).describe("Show the view description text"),
+  allowedVisualizations: z.array(VisualizationTypeSchema).optional().describe('Whitelist of visualization types users can switch between (e.g. ["grid", "gallery", "kanban"])')
+}).describe("Appearance and visualization configuration"));
+var ViewTabSchema = lazySchema(() => z.object({
+  name: SnakeCaseIdentifierSchema.describe("Tab identifier (snake_case)"),
+  label: I18nLabelSchema.optional().describe("Display label"),
+  icon: z.string().optional().describe("Tab icon name"),
+  view: z.string().optional().describe("Referenced list view name from listViews"),
+  filter: z.array(ViewFilterRuleSchema).optional().describe("Tab-specific filter criteria"),
+  order: z.number().int().min(0).optional().describe("Tab display order"),
+  pinned: z.boolean().default(false).describe("Pin tab (cannot be removed by users)"),
+  isDefault: z.boolean().default(false).describe("Set as the default active tab"),
+  visible: z.boolean().default(true).describe("Tab visibility")
+}).describe("Tab configuration for multi-tab view interface"));
+var AddRecordConfigSchema = lazySchema(() => z.object({
+  enabled: z.boolean().default(true).describe("Show the add record entry point"),
+  position: z.enum(["top", "bottom", "both"]).default("bottom").describe("Position of the add record button"),
+  mode: z.enum(["inline", "form", "modal"]).default("inline").describe("How to add a new record"),
+  formView: z.string().optional().describe('Named form view to use when mode is "form" or "modal"')
+}).describe("Add record entry point configuration"));
+var KanbanConfigSchema = lazySchema(() => z.object({
+  groupByField: z.string().describe("Field to group columns by (usually status/select)"),
+  summarizeField: z.string().optional().describe("Field to sum at top of column (e.g. amount)"),
+  columns: z.array(z.string()).describe("Fields to show on cards")
+}));
+var ListChartConfigSchema = lazySchema(() => z.object({
+  chartType: z.enum(["bar", "line", "pie", "area", "scatter"]).default("bar").describe("Chart visualisation type"),
+  xAxisField: z.string().describe("Field used as the X axis / category dimension"),
+  yAxisFields: z.array(z.string()).min(1).describe("Field(s) used as the Y axis / measures"),
+  aggregation: z.enum(["sum", "avg", "count", "min", "max"]).optional().describe("Aggregation function applied to Y axis fields"),
+  groupByField: z.string().optional().describe("Optional field used to split / stack the chart")
+}).describe("List chart view configuration"));
+var CalendarConfigSchema = lazySchema(() => z.object({
+  startDateField: z.string(),
+  endDateField: z.string().optional(),
+  titleField: z.string(),
+  colorField: z.string().optional()
+}));
+var GanttConfigSchema = lazySchema(() => z.object({
+  startDateField: z.string(),
+  endDateField: z.string(),
+  titleField: z.string(),
+  progressField: z.string().optional(),
+  dependenciesField: z.string().optional()
+}));
+var NavigationModeSchema = lazySchema(() => z.enum([
+  "page",
+  // Navigate to a new route (default)
+  "drawer",
+  // Open details in a side drawer/panel
+  "modal",
+  // Open details in a modal dialog
+  "split",
+  // Show details side-by-side with the list (master-detail)
+  "popover",
+  // Show details in a popover (lightweight)
+  "new_window",
+  // Open in new browser tab/window
+  "none"
+  // No navigation (read-only list)
+]));
+var NavigationConfigSchema = lazySchema(() => z.object({
+  mode: NavigationModeSchema.default("page"),
+  /** Target View Config */
+  view: z.string().optional().describe('Name of the form view to use for details (e.g. "summary_view", "edit_form")'),
+  /** Interaction Triggers */
+  preventNavigation: z.boolean().default(false).describe("Disable standard navigation entirely"),
+  openNewTab: z.boolean().default(false).describe("Force open in new tab (applies to page mode)"),
+  /** Dimensions (for modal/drawer) */
+  width: z.union([z.string(), z.number()]).optional().describe('Width of the drawer/modal (e.g. "600px", "50%")')
+}));
+var ListViewSchema = lazySchema(() => z.object({
+  name: SnakeCaseIdentifierSchema.optional().describe("Internal view name (lowercase snake_case)"),
+  label: I18nLabelSchema.optional(),
+  // Display label override (supports i18n)
+  type: z.enum([
+    "grid",
+    // Standard Data Table
+    "kanban",
+    // Board / Columns
+    "gallery",
+    // Card Deck / Masonry
+    "calendar",
+    // Monthly/Weekly/Daily
+    "timeline",
+    // Chronological Stream (Feed)
+    "gantt",
+    // Project Timeline
+    "map",
+    // Geospatial
+    "chart"
+    // Aggregate visualisation
+  ]).default("grid"),
+  /** Data Source Configuration */
+  data: ViewDataSchema.optional().describe('Data source configuration (defaults to "object" provider)'),
+  /** Shared Query Config */
+  columns: z.union([
+    z.array(z.string()),
+    // Legacy: simple field names
+    z.array(ListColumnSchema)
+    // Enhanced: detailed column config
+  ]).describe("Fields to display as columns"),
+  filter: z.array(ViewFilterRuleSchema).optional().describe("Filter criteria (JSON Rules)"),
+  sort: z.union([
+    z.string(),
+    //Legacy "field desc"
+    z.array(z.object({
+      field: z.string(),
+      order: z.enum(["asc", "desc"])
+    }))
+  ]).optional(),
+  /** Search & Filter */
+  searchableFields: z.array(z.string()).optional().describe("Fields enabled for search"),
+  filterableFields: z.array(z.string()).optional().describe("Fields enabled for end-user filtering in the top bar"),
+  /** Grid Features */
+  resizable: z.boolean().optional().describe("Enable column resizing"),
+  striped: z.boolean().optional().describe("Striped row styling"),
+  bordered: z.boolean().optional().describe("Show borders"),
+  compactToolbar: z.boolean().optional().describe("Collapse Group/Color/Density/Hide-fields into a single View settings popover"),
+  /** Selection */
+  selection: SelectionConfigSchema.optional().describe("Row selection configuration"),
+  /** Navigation / Interaction */
+  navigation: NavigationConfigSchema.optional().describe("Configuration for item click navigation (page, drawer, modal, etc.)"),
+  /** Pagination */
+  pagination: PaginationConfigSchema.optional().describe("Pagination configuration"),
+  /** Type Specific Config */
+  kanban: KanbanConfigSchema.optional(),
+  calendar: CalendarConfigSchema.optional(),
+  gantt: GanttConfigSchema.optional(),
+  gallery: GalleryConfigSchema.optional(),
+  timeline: TimelineConfigSchema.optional(),
+  chart: ListChartConfigSchema.optional(),
+  /** View Metadata (Airtable-style view management) */
+  description: I18nLabelSchema.optional().describe("View description for documentation/tooltips"),
+  sharing: ViewSharingSchema.optional().describe("View sharing and access configuration"),
+  /** Row Height / Density (Airtable-style) */
+  rowHeight: RowHeightSchema.optional().describe("Row height / density setting"),
+  /** Record Grouping (Airtable-style) */
+  grouping: GroupingConfigSchema.optional().describe("Group records by one or more fields"),
+  /** Row Color (Airtable-style) */
+  rowColor: RowColorConfigSchema.optional().describe("Color rows based on field value"),
+  /** Field Visibility & Ordering per View (Airtable-style) */
+  hiddenFields: z.array(z.string()).optional().describe("Fields to hide in this specific view"),
+  fieldOrder: z.array(z.string()).optional().describe("Explicit field display order for this view"),
+  /** Row & Bulk Actions */
+  rowActions: z.array(z.string()).optional().describe("Actions available for individual row items"),
+  bulkActions: z.array(z.string()).optional().describe("Actions available when multiple rows are selected"),
+  bulkActionDefs: z.array(z.record(z.string(), z.any())).optional().describe("Rich bulk action definitions (schema-driven, executed via BulkActionDialog)"),
+  /** Performance */
+  virtualScroll: z.boolean().optional().describe("Enable virtual scrolling for large datasets"),
+  /** Conditional Formatting */
+  conditionalFormatting: z.array(z.object({
+    condition: ExpressionInputSchema.describe("Predicate (CEL) to evaluate."),
+    style: z.record(z.string(), z.string()).describe("CSS styles to apply when condition is true")
+  })).optional().describe("Conditional formatting rules for list rows"),
+  /** Inline Edit */
+  inlineEdit: z.boolean().optional().describe("Allow inline editing of records directly in the list view"),
+  /** Export */
+  exportOptions: z.array(z.enum(["csv", "xlsx", "pdf", "json"])).optional().describe("Available export format options"),
+  /** User Actions (Airtable Interface parity) */
+  userActions: UserActionsConfigSchema.optional().describe("User action toggles for the view toolbar"),
+  /** Appearance (Airtable Interface parity) */
+  appearance: AppearanceConfigSchema.optional().describe("Appearance and visualization configuration"),
+  /** Tabs (Airtable Interface parity) */
+  tabs: z.array(ViewTabSchema).optional().describe("Tab definitions for multi-tab view interface"),
+  /** Add Record (Airtable Interface parity) */
+  addRecord: AddRecordConfigSchema.optional().describe("Add record entry point configuration"),
+  /** Record Count Display (Airtable Interface parity) */
+  showRecordCount: z.boolean().optional().describe("Show record count at the bottom of the list"),
+  /** Advanced: Allow Printing (Airtable Interface parity) */
+  allowPrinting: z.boolean().optional().describe("Allow users to print the view"),
+  /** Empty State */
+  emptyState: z.object({
+    title: I18nLabelSchema.optional(),
+    message: I18nLabelSchema.optional(),
+    icon: z.string().optional()
+  }).optional().describe("Empty state configuration when no records found"),
+  /** ARIA accessibility attributes */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes for the list view"),
+  /** Responsive layout overrides per breakpoint */
+  responsive: ResponsiveConfigSchema.optional().describe("Responsive layout configuration"),
+  /** Performance optimization settings */
+  performance: PerformanceConfigSchema.optional().describe("Performance optimization settings")
+}));
+var FormFieldSchema = lazySchema(() => z.object({
+  /** Field name (snake_case) */
+  field: z.string().describe("Field name (snake_case)"),
+  /** Field type — reuses Data.FieldType. When set, widget is auto-inferred (can be overridden). */
+  type: FieldType.optional().describe("Field type (auto-infers widget if omitted)"),
+  /** Select/multiselect options — only needed when type=select/multiselect/radio/checkboxes */
+  options: z.array(SelectOptionSchema).optional().describe("Options for select/multiselect/radio/checkboxes fields"),
+  /** Reference object for lookup/master_detail fields */
+  reference: z.string().optional().describe("Target object name for lookup/master_detail fields"),
+  /** Text constraints */
+  maxLength: z.number().optional().describe("Maximum character length (for text/textarea/email/url/phone)"),
+  minLength: z.number().optional().describe("Minimum character length"),
+  /** Number constraints */
+  min: z.number().optional().describe("Minimum value (for number/currency/percent/slider)"),
+  max: z.number().optional().describe("Maximum value"),
+  precision: z.number().optional().describe("Total digits (for number/currency)"),
+  scale: z.number().optional().describe("Decimal places"),
+  /** Multi-value flag */
+  multiple: z.boolean().optional().describe("Allow multiple values (for select/lookup/file/image)"),
+  /** UI overrides */
+  label: I18nLabelSchema.optional().describe("Display label override"),
+  placeholder: I18nLabelSchema.optional().describe("Placeholder text"),
+  helpText: I18nLabelSchema.optional().describe("Help/hint text"),
+  readonly: z.boolean().optional().describe("Read-only override"),
+  immutable: z.boolean().optional().describe("Editable on create, locked once the record exists (e.g. machine names)."),
+  required: z.boolean().optional().describe("Required override"),
+  hidden: z.boolean().optional().describe("Hidden override"),
+  colSpan: z.number().int().min(1).max(4).optional().describe("Column span in grid layout (1-4)"),
+  /** Custom widget override — only needed when auto-inference is insufficient */
+  widget: z.string().optional().describe("Custom widget/component name (overrides type-based inference)"),
+  /** For `code` fields: source language (e.g. 'javascript', 'sql', 'json', 'typescript', 'expression', 'cel'). Drives syntax highlighting. */
+  language: z.string().optional().describe("Code editor language (for type=code)"),
+  /**
+   * Sub-fields for `composite` / `repeater` types — declares the inner shape
+   * of an embedded sub-object (composite) or each row of an embedded
+   * sub-object array (repeater). Recursive: composite/repeater can nest.
+   * Ignored for all other field types.
+   *
+   * Use `lookup` / `master_detail` instead when the children are independent
+   * records with their own IDs in a separate object/table.
+   */
+  fields: z.array(z.lazy(() => FormFieldSchema)).optional().describe("Sub-fields for composite/repeater types"),
+  dependsOn: z.string().optional().describe("Parent field name for cascading"),
+  visibleOn: ExpressionInputSchema.optional().describe("Visibility predicate (CEL).")
+}));
+var FormSectionSchema = lazySchema(() => z.object({
+  label: I18nLabelSchema.optional(),
+  description: z.string().optional().describe("Optional description rendered under the section header."),
+  collapsible: z.boolean().default(false),
+  collapsed: z.boolean().default(false),
+  visibleOn: ExpressionInputSchema.optional().describe("Visibility predicate (CEL). Hides the whole section when false."),
+  columns: z.union([
+    z.enum(["1", "2", "3", "4"]),
+    z.literal(1),
+    z.literal(2),
+    z.literal(3),
+    z.literal(4)
+  ]).default(1).transform((val) => typeof val === "string" ? parseInt(val) : val),
+  fields: z.array(z.union([
+    z.string(),
+    // Legacy: simple field name
+    FormFieldSchema
+    // Enhanced: detailed field config
+  ]))
+}));
+var FormViewSchema = lazySchema(() => z.object({
+  type: z.enum([
+    "simple",
+    // Single column or sections
+    "tabbed",
+    // Tabs
+    "wizard",
+    // Step by step
+    "split",
+    // Master-Detail split
+    "drawer",
+    // Side panel
+    "modal"
+    // Dialog
+  ]).default("simple"),
+  /** Data Source Configuration */
+  data: ViewDataSchema.optional().describe('Data source configuration (defaults to "object" provider)'),
+  sections: z.array(FormSectionSchema).optional(),
+  // For simple layout
+  groups: z.array(FormSectionSchema).optional(),
+  // Legacy support -> alias to sections
+  /** Default Sort for Related Lists (e.g., sort child records by date) */
+  defaultSort: z.array(z.object({
+    field: z.string().describe("Field name to sort by"),
+    order: z.enum(["asc", "desc"]).default("desc").describe("Sort direction")
+  })).optional().describe("Default sort order for related list views within this form"),
+  /** Public form sharing configuration */
+  sharing: SharingConfigSchema.optional().describe("Public sharing configuration for this form"),
+  /**
+   * What happens after a successful submit.
+   *
+   * - `thank-you` (default) — show a confirmation panel
+   * - `redirect` — send the browser to a URL
+   * - `continue` — reset the form so another response can be entered
+   * - `next-record` — advance to the next record (internal queues only)
+   */
+  submitBehavior: z.union([
+    z.object({
+      kind: z.literal("thank-you"),
+      title: z.string().optional(),
+      message: z.string().optional()
+    }),
+    z.object({
+      kind: z.literal("redirect"),
+      url: z.string(),
+      delayMs: z.number().int().min(0).optional()
+    }),
+    z.object({ kind: z.literal("continue") }),
+    z.object({ kind: z.literal("next-record") })
+  ]).optional().describe("Post-submit behavior"),
+  /** ARIA accessibility attributes */
+  aria: AriaPropsSchema.optional().describe("ARIA accessibility attributes for the form view")
+}));
+lazySchema(() => z.object({
+  list: ListViewSchema.optional(),
+  // Default list view
+  form: FormViewSchema.optional(),
+  // Default form view
+  listViews: z.record(z.string(), ListViewSchema).optional().describe("Additional named list views"),
+  formViews: z.record(z.string(), FormViewSchema).optional().describe("Additional named form views")
+}));
+function defineForm(config) {
+  const { schemaId, ...rest } = config;
+  return FormViewSchema.parse({
+    ...rest,
+    data: { provider: "schema", schemaId }
+  });
+}
+
+// src/ai/agent.form.ts
+var agentForm = defineForm({
+  schemaId: "agent",
+  type: "simple",
+  sections: [
+    {
+      label: "Identity",
+      description: "How users see and reference this agent.",
+      columns: 2,
+      fields: [
+        { field: "name", required: true, colSpan: 1, helpText: "Unique identifier (snake_case)" },
+        { field: "label", required: true, colSpan: 1, helpText: 'Display name (e.g., "Sales Assistant")' },
+        { field: "role", required: true, colSpan: 2, helpText: 'Agent persona (e.g., "Customer Support Specialist")' },
+        { field: "avatar", colSpan: 1, helpText: "Avatar image URL" },
+        { field: "active", colSpan: 1, helpText: "Enable/disable this agent" }
+      ]
+    },
+    {
+      label: "AI Configuration",
+      description: "Model selection, instructions, planning, and memory.",
+      fields: [
+        { field: "instructions", required: true, widget: "textarea", helpText: "System prompt \u2014 tell the agent how to behave and what it can do" },
+        { field: "model", type: "composite", helpText: "AI model configuration (provider, model name, temperature, etc.)" },
+        { field: "planning", type: "composite", helpText: "Autonomous reasoning configuration (strategy, max iterations, replan)" },
+        { field: "memory", type: "composite", helpText: "Memory management (short-term, long-term, reflection)" },
+        { field: "lifecycle", type: "composite", helpText: "State machine defining conversation flow" }
+      ]
+    },
+    {
+      label: "Capabilities",
+      description: "Skills, tools, and knowledge sources the agent can use.",
+      fields: [
+        { field: "skills", widget: "string-tags", helpText: "Skill names (Agent\u2192Skill\u2192Tool architecture)" },
+        { field: "tools", type: "repeater", helpText: "Direct tool references (legacy mode)" },
+        { field: "knowledge", type: "composite", helpText: "RAG knowledge access configuration" }
+      ]
+    },
+    {
+      label: "Access & Security",
+      description: "Who can use this agent and what safeguards apply.",
+      collapsible: true,
+      collapsed: true,
+      fields: [
+        { field: "visibility", helpText: "Scope: global, organization, or private" },
+        { field: "access", widget: "string-tags", helpText: "User IDs or role names who can chat with this agent" },
+        { field: "permissions", widget: "string-tags", helpText: "Required permissions to use this agent" },
+        { field: "tenantId", helpText: "Restrict to specific organization ID" },
+        { field: "guardrails", type: "composite", helpText: "Safety rules and content policies" }
+      ]
+    }
+  ]
+});
 var ToolCategorySchema = lazySchema(() => z.enum([
   "data",
   // CRUD / query operations
@@ -291,6 +1412,46 @@ var ToolSchema = lazySchema(() => z.object({
 function defineTool(config) {
   return ToolSchema.parse(config);
 }
+
+// src/ai/tool.form.ts
+var toolForm = defineForm({
+  schemaId: "tool",
+  type: "simple",
+  sections: [
+    {
+      label: "Basics",
+      description: "Tool identity and AI-facing description.",
+      columns: 2,
+      fields: [
+        { field: "name", required: true, colSpan: 1, helpText: "Unique identifier (snake_case)" },
+        { field: "label", required: true, colSpan: 1, helpText: "Display name for Studio UI" },
+        { field: "description", required: true, widget: "textarea", colSpan: 2, helpText: "Tell AI when to use this tool \u2014 be specific!" },
+        { field: "category", colSpan: 1, helpText: "Tool category (data, action, flow, integration, etc.)" },
+        { field: "objectName", widget: "ref:object", colSpan: 1, helpText: "Related object (if this tool operates on a specific object)" },
+        { field: "active", colSpan: 1, helpText: "Enable/disable this tool" },
+        { field: "builtIn", colSpan: 1, helpText: "Platform built-in tool (vs user-defined)" }
+      ]
+    },
+    {
+      label: "Schemas",
+      description: "Inputs the tool accepts and the shape of its output.",
+      fields: [
+        { field: "parameters", type: "composite", required: true, helpText: 'Input parameters \u2014 define properties like: {name: {type: "string", description: "..."}}' },
+        { field: "outputSchema", type: "composite", helpText: "Output schema for validation (optional)" }
+      ]
+    },
+    {
+      label: "Access & safety",
+      description: "Permissions and confirmation requirements.",
+      collapsible: true,
+      collapsed: true,
+      fields: [
+        { field: "requiresConfirmation", helpText: "Ask user to approve before executing (for destructive actions)" },
+        { field: "permissions", widget: "string-tags", helpText: "Required permissions to use this tool" }
+      ]
+    }
+  ]
+});
 var SkillTriggerConditionSchema = lazySchema(() => z.object({
   /** Condition field (e.g. 'objectName', 'userRole', 'channel') */
   field: z.string().describe("Context field to evaluate"),
@@ -342,6 +1503,52 @@ var SkillSchema = lazySchema(() => z.object({
 function defineSkill(config) {
   return SkillSchema.parse(config);
 }
+
+// src/ai/skill.form.ts
+var skillForm = defineForm({
+  schemaId: "skill",
+  type: "simple",
+  sections: [
+    {
+      label: "Basics",
+      description: "Skill identity and human-readable description.",
+      columns: 2,
+      fields: [
+        { field: "name", required: true, colSpan: 1, helpText: "Unique identifier (snake_case)" },
+        { field: "label", required: true, colSpan: 1, helpText: 'Display name (e.g., "Case Management")' },
+        { field: "description", widget: "textarea", colSpan: 2, helpText: "What this skill does" },
+        { field: "active", colSpan: 1, helpText: "Enable/disable this skill" }
+      ]
+    },
+    {
+      label: "AI Instructions",
+      description: "How the agent should reason with this skill.",
+      fields: [
+        { field: "instructions", widget: "textarea", helpText: "Instructions for AI \u2014 tell it how to use these tools together" },
+        { field: "tools", widget: "string-tags", required: true, helpText: "Tool names (supports wildcard: action_*)" }
+      ]
+    },
+    {
+      label: "Triggers",
+      description: "When this skill should activate.",
+      collapsible: true,
+      collapsed: true,
+      fields: [
+        { field: "triggerPhrases", widget: "string-tags", helpText: "Natural language phrases that activate this skill" },
+        { field: "triggerConditions", type: "repeater", helpText: 'Programmatic conditions (e.g., objectName == "case")' }
+      ]
+    },
+    {
+      label: "Access",
+      description: "Required permissions to use this skill.",
+      collapsible: true,
+      collapsed: true,
+      fields: [
+        { field: "permissions", widget: "string-tags", helpText: "Required permissions to use this skill" }
+      ]
+    }
+  ]
+});
 var TokenUsageSchema = lazySchema(() => z.object({
   promptTokens: z.number().int().nonnegative().describe("Tokens consumed by the prompt"),
   completionTokens: z.number().int().nonnegative().describe("Tokens generated in the completion"),
@@ -576,42 +1783,6 @@ var ConversationAnalyticsSchema = lazySchema(() => z.object({
   firstMessageAt: z.string().datetime().optional().describe("ISO 8601 timestamp"),
   lastMessageAt: z.string().datetime().optional().describe("ISO 8601 timestamp")
 }));
-var ExpressionDialect = z.enum(["cel", "js", "cron", "template"]);
-var ExpressionMetaSchema = z.object({
-  /** Human-readable rationale (often AI-emitted). */
-  rationale: z.string().optional(),
-  /** Identifier of the agent / tool that produced this expression. */
-  generatedBy: z.string().optional()
-});
-var ExpressionSchema = z.object({
-  /** Which engine evaluates `source` / `ast`. */
-  dialect: ExpressionDialect,
-  /** Surface syntax. Required while `ast` is not yet populated. */
-  source: z.string().min(1).optional(),
-  /**
-   * Engine-native AST. Opaque at the spec layer; each engine validates its own
-   * shape. For `dialect: 'cel'` this is the cel-js parsed AST node.
-   */
-  ast: z.unknown().optional(),
-  /** Optional authorship metadata. */
-  meta: ExpressionMetaSchema.optional()
-}).refine((e) => e.source !== void 0 || e.ast !== void 0, {
-  message: "Expression requires at least one of `source` or `ast`"
-});
-z.union([
-  z.string().min(1).transform((source) => ({ dialect: "cel", source })),
-  ExpressionSchema
-]);
-z.union([
-  z.string().min(1).transform((source) => ({ dialect: "cron", source })),
-  ExpressionSchema
-]);
-var TemplateExpressionInputSchema = z.union([
-  z.string().min(1).transform((source) => ({ dialect: "template", source })),
-  ExpressionSchema
-]);
-
-// src/ai/model-registry.zod.ts
 var ModelProviderSchema = lazySchema(() => z.enum([
   "openai",
   "azure_openai",
@@ -956,6 +2127,6 @@ var KnowledgeHitSchema = lazySchema(() => z.object({
   metadata: z.record(z.string(), z.unknown()).default({}).optional()
 }));
 
-export { AIKnowledgeSchema, AIModelConfigSchema, AIToolSchema, AIUsageRecordSchema, AgentSchema, CodeContentSchema, ConversationAnalyticsSchema, ConversationContextSchema, ConversationMessageSchema, ConversationSessionSchema, ConversationSummarySchema, EmbeddingModelSchema, FileContentSchema, FileKnowledgeSourceSchema, FunctionCallSchema, HttpKnowledgeSourceSchema, ImageContentSchema, KnowledgeChunkSchema, KnowledgeDocumentSchema, KnowledgeHitSchema, KnowledgeRefreshPolicySchema, KnowledgeSourceKindSchema, KnowledgeSourceSchema, MCPApprovalPolicySchema, MCPServerRefSchema, MCPToolBindingSchema, MCPTransportSchema, MessageContentSchema, MessageContentTypeSchema, MessagePruningEventSchema, MessageRoleSchema, ModelCapabilitySchema, ModelConfigSchema, ModelLimitsSchema, ModelPricingSchema, ModelProviderSchema, ModelRegistryEntrySchema, ModelRegistrySchema, ModelSelectionCriteriaSchema, ObjectKnowledgeSourceSchema, PromptTemplateSchema, PromptVariableSchema, SkillSchema, SkillTriggerConditionSchema, StructuredOutputConfigSchema, StructuredOutputFormatSchema, TextContentSchema, TokenBudgetConfigSchema, TokenBudgetStrategySchema, TokenUsageSchema, TokenUsageStatsSchema, ToolCallSchema, ToolCategorySchema, ToolSchema, TransformPipelineStepSchema, VectorStoreProviderSchema, VectorStoreSchema, defineAgent, defineSkill, defineTool };
+export { AIKnowledgeSchema, AIModelConfigSchema, AIToolSchema, AIUsageRecordSchema, AgentSchema, CodeContentSchema, ConversationAnalyticsSchema, ConversationContextSchema, ConversationMessageSchema, ConversationSessionSchema, ConversationSummarySchema, EmbeddingModelSchema, FileContentSchema, FileKnowledgeSourceSchema, FunctionCallSchema, HttpKnowledgeSourceSchema, ImageContentSchema, KnowledgeChunkSchema, KnowledgeDocumentSchema, KnowledgeHitSchema, KnowledgeRefreshPolicySchema, KnowledgeSourceKindSchema, KnowledgeSourceSchema, MCPApprovalPolicySchema, MCPServerRefSchema, MCPToolBindingSchema, MCPTransportSchema, MessageContentSchema, MessageContentTypeSchema, MessagePruningEventSchema, MessageRoleSchema, ModelCapabilitySchema, ModelConfigSchema, ModelLimitsSchema, ModelPricingSchema, ModelProviderSchema, ModelRegistryEntrySchema, ModelRegistrySchema, ModelSelectionCriteriaSchema, ObjectKnowledgeSourceSchema, PromptTemplateSchema, PromptVariableSchema, SkillSchema, SkillTriggerConditionSchema, StructuredOutputConfigSchema, StructuredOutputFormatSchema, TextContentSchema, TokenBudgetConfigSchema, TokenBudgetStrategySchema, TokenUsageSchema, TokenUsageStatsSchema, ToolCallSchema, ToolCategorySchema, ToolSchema, TransformPipelineStepSchema, VectorStoreProviderSchema, VectorStoreSchema, agentForm, defineAgent, defineSkill, defineTool, skillForm, toolForm };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map